Get repository metadata

Get metadata of the specified repository in Comet. Comet is a service which contains metadata related serving Red Hat container images to customers.

The entrypoint offers options of which registry should be checked. The default behavior is that internal registry is checked first, followed by the partner registry. If it’s desired to check only one of these registries, it may be specified via argument. Lastly, a custom registry may be specified too, which will be the only checked registry.

CLI reference

usage: pubtools-pyxis-get-repo-metadata [-h] --pyxis-server PYXIS_SERVER
                                        [--pyxis-insecure]
                                        [--pyxis-krb-principal PYXIS_KRB_PRINCIPAL]
                                        [--pyxis-krb-ktfile PYXIS_KRB_KTFILE]
                                        [--pyxis-ssl-crtfile PYXIS_SSL_CRTFILE]
                                        [--pyxis-ssl-keyfile PYXIS_SSL_KEYFILE]
                                        --repo-name REPO_NAME
                                        [--custom-registry CUSTOM_REGISTRY]
                                        [--only-internal-registry]
                                        [--only-partner-registry]

Named Arguments

--pyxis-server

Pyxis service hostname

--pyxis-insecure

Allow insecure connection to Pyxis

--pyxis-krb-principal

Pyxis kerberos principal in form: name@REALM

--pyxis-krb-ktfile

Pyxis Kerberos client keytab. Optional. Used for login if TGT is not available.

--pyxis-ssl-crtfile

Path to .crt file for the SSL authentication

--pyxis-ssl-keyfile

Path to .key file for the SSL authentication

--repo-name

Name of the repository

--custom-registry

Custom registry address. Will be used instead of the default addresses.

--only-internal-registry

Check only internal registry

--only-partner-registry

Check only partner registry

Examples

NOTE: The demonstration of various authentication types can be seen in “Get operator indices” entrypoint examples.

Get repository metadata without specifying any registry options. Internal registry, followed by partner registry will be checked.

pubtools-pyxis-get-repo-metadata \
--pyxis-server https://pyxis-server-url/ \
--pyxis-ssl-crtfile /path/to/file.crt \
--pyxis-ssl-keyfile /path/to/file.key \
--repo-name some-repo/name

Only check internal registry when gathering repo metadata.

pubtools-pyxis-get-repo-metadata \
--pyxis-server https://pyxis-server-url/ \
--pyxis-ssl-crtfile /path/to/file.crt \
--pyxis-ssl-keyfile /path/to/file.key \
--repo-name some-repo/name \
--only-internal-registry

Only check partner registry when gathering repo metadata.

pubtools-pyxis-get-repo-metadata \
--pyxis-server https://pyxis-server-url/ \
--pyxis-ssl-crtfile /path/to/file.crt \
--pyxis-ssl-keyfile /path/to/file.key \
--repo-name some-repo/name \
--only-partner-registry

Specify a custom registry.

pubtools-pyxis-get-repo-metadata \
--pyxis-server https://pyxis-server-url/ \
--pyxis-ssl-crtfile /path/to/file.crt \
--pyxis-ssl-keyfile /path/to/file.key \
--repo-name some-repo/name \
--custom-registry some.registry.redhat.com