Chapter 3. Populating your private automation hub container registry

By default, private automation hub does not include container images. To populate your container registry, you need to push a container image to it. The procedures in this section describe how to pull images from the Red Hat Ecosystem Catalog (registry.redhat.io), tag them, and push them to your private automation hub container registry.

3.1. Prerequisites

  • You have permissions to create new containers and push containers to private automation hub.

3.2. Obtaining images for use in automation hub

Before you can push container images to your private automation hub, you must first pull them from an existing registry and tag them for use. This example details how to pull an image from the Red Hat Ecosystem Catalog (registry.redhat.io).

Prerequisites

  • You have permissions to pull images from registry.redhat.io

Procedure

  1. Log in to Podman using your registry.redhat.io credentials: 

    $ podman login registry.redhat.io
  2. Enter your username and password at the prompts.

  3. Pull a container image: 

    $ podman pull registry.redhat.io/<container_image_name>:<tag>

Verification

  1. List the images in local storage: 

    $ podman images
  2. Verify that the image you recently pulled is contained in the list.
  3. Verify that the tag is correct.

Additional resources

3.3. Tagging images for use in automation hub

After you pull images from a registry, tag them for use in your private automation hub container registry.

Prerequisites

  • You have pulled a container image from an external registry.

Procedure

  • Tag a local image with the automation hub container repository 

    $ podman tag registry.redhat.io/<container_image_name>:<tag> <automation_hub_URL>/<container_image_name>

Verification

  1. List the images in local storage: 

    $ podman images
  2. Verify that the image you recently tagged with your automation hub information is contained in the list.

3.4. Pushing a container image to private automation hub

You can push tagged container images to private automation hub to create new containers and populate the container registry.

Prerequisites

  • You have permissions to create new containers.
  • You have the FQDN or IP address of the automation hub instance.

Procedure

  1. Log in to Podman using your automation hub location and credentials: 

    $ podman login -u=<username> -p=<password> <automation_hub_url>

  2. Push your container image to your automation hub container registry: 

    $ podman push <automation_hub_url>/<container_image_name> --remove-signatures
    Note

    The --remove-signatures flag is required when signed images from registry.redhat.io are pushed to the automation hub container registry. The push operation re-compresses image layers during the upload, which is not guaranteed to be reproducible and is client implementation dependent. This may lead to image-layer digest changes and a failed push operation, resulting in Error: Copying this image requires changing layer representation, which is not possible (image is signed or the destination specifies a digest).

Verification

  1. Log in to your automation hub.
  2. Navigate to Container Registry.
  3. Locate the container in the container repository list.