Chapter 7. 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.
7.1. Pulling an image
You can pull images from the automation hub container registry to make a copy to your local machine.
Prerequisites
- You must have permission to view and pull from a private container repository.
Procedure
- If you are pulling container images from a password or token-protected registry, create a credential in automation controller before pulling the image.
-
From the navigation panel, select
. - Select your container repository.
- In the Pull this image entry, click .
- Paste and run the command in your terminal.
Verification
-
Run
podman images
to view images on your local machine.
7.2. Syncing images from a container repository
You can pull images from the automation hub container registry to sync an image to your local machine. To sync an image from a remote container registry, you must first configure a remote registry.
Prerequisites
You must have permission to view and pull from a private container repository.
Procedure
-
From the navigation panel, select
. - Add https://registry.redhat.io to the registry.
Add any required credentials to authenticate.
NoteSome container registries are aggressive with rate limiting. Set a rate limit under Advanced Options.
-
From the navigation panel, select
. - Click in the page header.
Select the registry you want to pull from. The Name field displays the name of the image displayed on your local registry.
NoteThe 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 is "local/alpine", the alpine image is downloaded from the remote and renamed to "local/alpine".
- Set a list of tags to include or exclude. Syncing images with a large number of tags is time consuming and uses a lot of disk space.
Additional resources
- See Red Hat Container Registry Authentication for a list of registries.
- See the What is Podman? documentation for options to use when pulling images.