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 have 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 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 to 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 the x on any of the tags for that image.
  6. Click Save.

Verification

  1. Click the Activity tab and review the latest changes.