Chapter 11. Managing container images

Procedure with repository discovery

1. In the Satellite web UI, navigate to Content > Products and click Repo Discovery.
2. From the Repository Type list, select Container Images.
3. In the Registry to Discover field, enter the URL of the registry to import images from.
4. In the Registry Username field, enter the name that corresponds with your user name for the container image registry.
5. In the Registry Password field, enter the password that corresponds with the user name that you enter.
6. In the Registry Search Parameter field, enter any search criteria that you want to use to filter your search, and then click Discover.
7. Optional: To further refine the Discovered Repository list, in the Filter field, enter any additional search criteria that you want to use.
8. From the Discovered Repository list, select any repositories that you want to import, and then click Create Selected.
9. Optional: To change the download policy for this container repository to on demand, see Section 4.11, “Changing the download policy for a repository”.
10. Optional: If you want to create a product, from the Product list, select New Product.
11. In the Name field, enter a product name.
12. Optional: In the Repository Name and Repository Label columns, you can edit the repository names and labels.
13. Click Run Repository Creation.
14. When repository creation is complete, you can click each new repository to view more information.
15. Optional: To filter the content you import to a repository, click a repository, and then navigate to Limit Sync Tags. Click to edit, and add any tags that you want to limit the content that synchronizes to Satellite.
16. In the Satellite web UI, navigate to Content > Products and select the name of your product.
17. Select the new repositories and then click Sync Now to start the synchronization process.

Procedure with creating a repository manually

1. In the Satellite web UI, navigate to Content > Products. Click the name of the required product.
2. Click New repository.
3. From the Type list, select docker. Enter the details for the repository, and click Save.
4. Select the new repository, and click Sync Now.

CLI procedure

1. Create the custom Red Hat Container Catalog product:

   # hammer product create \
   --description "My_Description" \
   --name "Red Hat Container Catalog" \
   --organization "My_Organization" \
   --sync-plan "My_Sync_Plan"

2. Create the repository for the container images:

   # hammer repository create \
   --content-type "docker" \
   --docker-upstream-name "rhel7" \
   --name "RHEL7" \
   --organization "My_Organization" \
   --product "Red Hat Container Catalog" \
   --url "http://registry.access.redhat.com/"

3. Synchronize the repository:

   # hammer repository synchronize \
   --name "RHEL7" \
   --organization "My_Organization" \
   --product "Red Hat Container Catalog"

1. In the Satellite web UI, navigate to Content > Lifecycle > Lifecycle Environments.
2. Create a lifecycle environment or select an existing lifecycle environment to edit.
3. In the Container Image Registry area, click the edit icon to the right of Registry Name Pattern area.
4. Use the list of variables and examples to determine which registry name pattern you require.

5. In the Registry Name Pattern field, enter the registry name pattern that you want to use. For example, to use the repository.docker_upstream_name:

   <%= repository.docker_upstream_name %>

6. Click Save.

Procedure

1. In the Satellite web UI, navigate to Content > Lifecycle > Lifecycle Environments.
2. Select the lifecycle environment that you want to manage authentication for.
3. To permit unauthenticated access to the containers in this lifecycle environment, select the Unauthenticated Pull checkbox. To restrict unauthenticated access, clear the Unauthenticated Pull checkbox.
4. Click Save.