Chapter 6. Setting up your container repository
Chapter 6. Setting up your container repository When you set up your container repository, you must add a description, include a README, add groups that can access the repository, and tag images. 6.1. Prerequisites to setting up your container registry You are logged in to a private automation hub. You have permissions to change the repository. 6.2. Adding a README to your container repository Add a README to your container repository to provide instructions to your users on how to work with the container. Automation hub container repositories support Markdown for creating a README. By default, the README is empty. Prerequisites You have permissions to change containers. Procedure Log in to automation hub. From the navigation panel, select Execution Environments Execution Environments . Select your container repository. On the Detail tab, click Add . In the Raw Markdown text field, enter your README text in Markdown. Click Save when you are finished. After you add a README, you can edit it at any time by clicking Edit and repeating steps 4 and 5. 6.3. Providing access to your container repository Provide access to your container repository for users who need to work with the images. Adding a group allows you to modify the permissions the group can have to the container repository. You can use this option to extend or restrict permissions based on what the group is assigned. Prerequisites You have change container namespace permissions. Procedure Log in to automation hub. From the navigation panel, select Execution Environments Execution Environments . Select your container repository. From the Access tab, click Select a group . Select the group or groups to which you want to grant access and click . Select the roles that you want to add to this execution environment and click . Click Add . 6.4. Tagging container images Tag images to add an additional name to images stored in your automation hub container repository. If no tag is added to an image, automation hub defaults to latest for the name. Prerequisites You have change image tags permissions. Procedure From the navigation panel, select Execution Environments Execution Environments . Select your container repository. Click the Images tab. Click the More Actions icon ... , and click Manage tags . Add a new tag in the text field and click Add . Optional: Remove current tags by clicking x on any of the tags for that image. Click Save . Verification Click the Activity tab and review the latest changes. 6.5. Creating a credential in automation controller To pull container images from a password or token-protected registry, you must create a credential in automation controller. In earlier versions of Ansible Automation Platform, you were required to deploy a registry to store execution environment images. On Ansible Automation Platform 2.0 and later, the system operates as if you already have a container registry up and running. To store execution environment images, add the credentials of only your selected container registries. Procedure Navigate to automation controller. From the navigation panel, select Resources Credentials . Click Add to create a new credential. Enter an authorization Name , Description , and Organization . Select the Credential Type . Enter the Authentication URL . This is the container registry address. Enter the Username and Password or Token required to log in to the container registry. Optional: To enable SSL verification, select Verify SSL . Click Save .