openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Code Issues Releases Activity

BZ1859736: adding podman registry authentication procedure and additional info

Browse Source
This commit is contained in:
Sara Thomas
2021-10-28 16:46:48 -04:00
committed by openshift-cherrypick-robot
parent 406bea75c3
commit b47c8306d5
3 changed files with 32 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
modules/registry-authentication.adoc Normal file
View File

@@ -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:<your_registry_account_username>
Password:<your_registry_account_password>
----
. Download the image and save it locally using the `podman pull` command:
+
[source,terminal]
----
$ podman pull registry.redhat.io/<repository_name>
----

6
modules/registry-third-party-registries.adoc
View File

@@ -14,9 +14,3 @@ creation.
Refreshing the fetched tags is as simple as running `oc import-image
<stream>`. 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.

2
registry/registry-options.adoc
View File

@@ -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]