Chapter 6. Setting up your container repository
When you set up your container repository, you must add a description, include a README, add teams that can access the repository, and tag automation execution environments.
6.1. Prerequisites to setting up your remote registry
- You are logged in to Ansible Automation Platform.
- 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 Ansible Automation Platform.
-
From the navigation panel, select
. - Select your execution environment.
- On the Detail tab, click .
- In the Raw Markdown text field, enter your README text in Markdown.
- Click when you are finished.
After you add a README, you can edit it at any time by clicking
and repeating steps 4 and 5.6.3. Providing access to your automation execution environments
Provide access to your automation execution environments for users who need to work with the images. Adding a team allows you to modify the permissions the team can have to the container repository. You can use this option to extend or restrict permissions based on what the team is assigned.
Prerequisites
- You have change container namespace permissions.
Procedure
- Log in to Ansible Automation Platform.
-
From the navigation panel, select
. - Select your automation execution environment.
- From the Team Access tab, click .
- Select the team or teams to which you want to grant access and click .
- Select the roles that you want to add to this execution environment and click .
- Click .
6.4. Tagging container images
Tag automation execution environments to add an additional name to automation execution environments stored in your automation hub container repository. If no tag is added to an automation execution environment, automation hub defaults to latest
for the name.
Prerequisites
- You have change automation execution environment tags permissions.
Procedure
-
From the navigation panel, select
. - Select your automation execution environments.
- Click the Images tab.
- Click the ⋮, and click . icon
- Add a new tag in the text field and click .
- Optional: Remove current tags by clicking on any of the tags for that image.
Verification
- Click the Activity tab and review the latest changes.
6.5. Creating a credential
To pull automation execution environments images from a password or token-protected registry, you must create a credential.
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 remote registry up and running. To store execution environment images, add the credentials of only your selected remote registries.
Procedure
- Log in to Ansible Automation Platform.
-
From the navigation panel, select
. - Click to create a new credential.
- Enter an authorization Name, Description, and Organization.
- In the Credential Type drop-down, select Container Registry.
- Enter the Authentication URL. This is the remote registry address.
- Enter the Username and Password or Token required to log in to the remote registry.
- Optional: To enable SSL verification, select Verify SSL.
- Click .
Filling in at least one of the fields organization, user, or team is mandatory, and can be done through the user interface.