4.2. Pulling container images using short-name aliases

Prerequisites

• The container-tools meta-package is installed.

Procedure

• Pull the container image:

  • Pull the fedora image:

    $ podman pull fedora
    Resolved "fedora" as an alias (/etc/containers/registries.conf.d/000-shortnames.conf)
    Trying to pull registry.fedoraproject.org/fedora:latest…
    ...
    Storing signatures
    ...

    Alias is found and the registry.fedoraproject.org/fedora image is securely pulled. The unqualified-search-registries list is not used to resolve fedora image name.

  • Pull the nginx image:

    $ podman pull nginx
    ? Please select an image:
    registry.access.redhat.com/nginx:latest
    registry.redhat.io/nginx:latest
      ▸ docker.io/library/nginx:latest
    ✔ docker.io/library/nginx:latest
    Trying to pull docker.io/library/nginx:latest…
    ...
    Storing signatures
    ...

    If no matching alias is found, you are prompted to choose one of the unqualified-search-registries list. If the selected image is pulled successfully, a new short-name alias is recorded locally, otherwise an error occurs.

Verification

• List all images pulled to your local system:

  $ podman images
  REPOSITORY                                   TAG     IMAGE ID      CREATED        SIZE
  registry.fedoraproject.org/fedora            latest  28317703decd  12 days ago    184 MB
  docker.io/library/nginx                      latest  08b152afcfae  13 days ago    137 MB