Red Hat SummitChapter 5. Pulling images from a container repository
Pull images from the automation hub container registry to make a copy to your local machine. Automation hub provides the podman pull command for each latest image in the container repository. You can copy and paste this command into your terminal, or use podman pull to copy an image based on an image tag.
5.1. Prerequisites
You must have permission to view and pull from a private container repository.
5.2. Pulling an image
You can pull images from the automation hub container registry to make a copy to your local machine. Automation hub provides the podman pull command for each latest image in the container repository.
If you need to pull container images from a password or token-protected registry, you must create a credential in automation controller before pulling the image.
Procedure
- Navigate to .
- Select your container repository.
- In the Pull this image entry, click .
- Paste and run the command in your terminal.
Verification
-
Run
podman imagesto view images on your local machine.
5.3. Syncing images from a container repository
You can pull images from the automation hub container registry to sync an image to your local machine.
Prerequisites
You must have permission to view and pull from a private container repository.
Procedure
To sync an image from a remote container registry, you need to configure a remote registry.
-
Navigate to
. - Add https://registry.redhat.io to the registry.
- Add any required credentials to authenticate.
Some container registries are aggressive with rate limiting. It is advisable to set a rate limit under Advanced Options.
-
Navigate to
. - Click Add execution environment in the page header.
- Select the registry you wish to pull from. The "name" field displays the name of the image that will show up as on your local registry.
The "Upstream name" field is the name of the image on the remote server. For example if the upstream name is set to "alpine" and the “name” field to "local/alpine", the alpine image will be downloaded from the remote and renamed to local/alpine.
It is advisable to set a list of tags to include or exclude. Syncing images with a large number of tags is time consuming and will use a lot of disk space.
Additional resources
- See Red Hat Container Registry Authentication for a list of registries.
5.4. Additional resources
- See the What is Podman? documentation for options to use when pulling images.
