proc_importing-container-images.adoc

Importing Container Images

You can import container image repositories from Red Hat Registry or from other image registries.

To use the CLI instead of the {ProjectWebUI}, see the CLI procedure.

Procedure with repository discovery

1. In the {ProjectWebUI}, 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 [changing_the_download_policy_for_a_repository_{context}].

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 {Project}.

16. In the {ProjectWebUI}, 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 {ProjectWebUI}, 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.

Next steps

• To view the progress of the synchronization, navigate to Content > Sync Status and expand the repository tree.

• When the synchronization completes, you can click Container Image Manifests to list the available manifests. From the list, you can also remove any manifests that you do not require.

CLI procedure

1. Create the custom {client-container-product-name} product:

   # hammer product create \
   --description "My_Description" \
   --name "{client-container-product-name}" \
   --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 "{client-container-image-name}" \
   --name "{client-container-repository-name}" \
   --organization "My_Organization" \
   --product "{client-container-product-name}" \
   --url "{client-container-url}"

3. Synchronize the repository:

   # hammer repository synchronize \
   --name "{client-container-repository-name}" \
   --organization "My_Organization" \
   --product "{client-container-product-name}"

Additional resources

• For more information about creating a product and repository manually, see [Importing_Content_{context}].