Chapter 4. Setting up your container repository


You can setup your container repository to add a description, include a README, add groups who can access the repository, and tag images.

4.1. Prerequisites

  • You are logged in to a private automation hub with permissions to change the repository.

4.2. Adding a README to your container repository

Add a README to your container repository to provide instructions to your users for how to work with the container. Automation hub container repositories support Markdown for creating a README. By default, the README will be empty.

Prerequisites

  • You have permissions to change containers.

Procedure

  1. Navigate to Execution Environments.
  2. Select your container repository.
  3. On the Detail tab, click Add.
  4. In the Raw Markdown text field, enter your README text in Markdown.
  5. Click Save when you are finished.

Once you add a README, you can edit it at any time by clicking Edit and repeating steps 4 and 5.

4.3. Providing access to your container repository

Provide access to your container repository for users who need to work 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

  1. Navigate to Execution Environments.
  2. Select your container repository.
  3. Click Edit at the top right of your window.
  4. Under Groups with access, select a group or groups to grant access to.

    • Optional: Add or remove permissions for a specific group using the drop down under that group name.
  5. Click Save.

4.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

  1. Navigate to Execution Environments.
  2. Select your container repository.
  3. Click the Images tab.
  4. Click more actions , then click Manage tags.
  5. 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.
  6. Click Save.

Verification

  • Click the Activity tab and review the latest changes.

4.5. Creating a credential in automation controller

Previously, you were required to deploy a registry to store execution environment images. On Ansible Automation Platform 2.0 and later, it is assumed that you already have a container registry up and running. Therefore, you are only required to add the credentials of a container registry of your choice to store execution environment images.

To pull container images from a password or token-protected registry, create a credential in automation controller:

Procedure

  1. Navigate to automation controller.
  2. In the side-menu bar, click Resources Credentials.
  3. Click Add to create a new credential.
  4. Enter an authorization Name, Description, and Organization.
  5. Select the Credential Type.
  6. Enter the Authentication URL. This is the container registry address.
  7. Enter the Username and Password or Token required to log in to the container registry.
  8. Optionally, select Verify SSL to enable SSL verification.
  9. Click Save.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.