From b47c8306d57441f1f892a59f72590e1ead88451e Mon Sep 17 00:00:00 2001 From: Sara Thomas Date: Thu, 28 Oct 2021 16:46:48 -0400 Subject: [PATCH] BZ1859736: adding podman registry authentication procedure and additional info --- modules/registry-authentication.adoc | 30 ++++++++++++++++++++ modules/registry-third-party-registries.adoc | 6 ---- registry/registry-options.adoc | 2 ++ 3 files changed, 32 insertions(+), 6 deletions(-) create mode 100644 modules/registry-authentication.adoc diff --git a/modules/registry-authentication.adoc b/modules/registry-authentication.adoc new file mode 100644 index 0000000000..552be9744b --- /dev/null +++ b/modules/registry-authentication.adoc @@ -0,0 +1,30 @@ +// Module included in the following assemblies: +// +// * registry/registry-options.adoc + +[id="authentication_{context}"] += Authentication +{product-title} can communicate with registries to access private image +repositories using credentials supplied by the user. This allows {product-title} +to push and pull images to and from private repositories. + +[id="registry-authentication_{context}"] +== Registry authentication with Podman +Some container image registries require access authorization. Podman is an open source tool for managing containers and container images and interacting with image registries. You can use Podman to authenticate your credentials, pull the registry image, and store local images in a local file-system. The following is a generic example of authenticating the registry with Podman. You can use the link:https://catalog.redhat.com/software/containers/explore[Red Hat Ecosystem Catalog] to search for specific container images from the Red Hat Repository. Select the image you need. Then click the *Get this image* tab to find the `podman` command for your container image. + + +. Login using the `podman login` command and your username and password authentication to the registry: ++ +[source,terminal] +---- +$ podman login registry.redhat.io + Username: + Password: +---- + +. Download the image and save it locally using the `podman pull` command: ++ +[source,terminal] +---- +$ podman pull registry.redhat.io/ +---- diff --git a/modules/registry-third-party-registries.adoc b/modules/registry-third-party-registries.adoc index a70760a964..aadeb3838b 100644 --- a/modules/registry-third-party-registries.adoc +++ b/modules/registry-third-party-registries.adoc @@ -14,9 +14,3 @@ creation. Refreshing the fetched tags is as simple as running `oc import-image `. When new images are detected, the previously described build and deployment reactions occur. - -[id="authentication_{context}"] -== Authentication -{product-title} can communicate with registries to access private image -repositories using credentials supplied by the user. This allows {product-title} -to push and pull images to and from private repositories. diff --git a/registry/registry-options.adoc b/registry/registry-options.adoc index 8ed178cfd2..4e99a8cead 100644 --- a/registry/registry-options.adoc +++ b/registry/registry-options.adoc @@ -14,6 +14,8 @@ include::modules/registry-integrated-openshift-registry.adoc[leveloffset=+1] include::modules/registry-third-party-registries.adoc[leveloffset=+1] +include::modules/registry-authentication.adoc[leveloffset=+2] + include::modules/registry-quay-overview.adoc[leveloffset=+1] include::modules/registry-authentication-enabled-registry-overview.adoc[leveloffset=+1]