Chapter 4. Building off of existing base EEs provided by Red Hat Ansible Automation Platform

Procedure

1. Log in to quay.io via Podman:

   $ podman login -u="[username]" -p="[token/hash]" quay.io

   Copy to Clipboard Toggle word wrap

2. Verify that you have access to pull the base image that you want to use.

   1. For example, to pull a ee-minimal image, check that you have access to this repository.

3. Configure your Ansible Builder files to specify any additional content to add to the new execution environment image which is based off of ee-minimal.

   1. For example, to add the Kubernetes Core Collection from Galaxy to the image, fill out the requirements.yml file as such:

      ---
      collections:
        - kubernetes.core

      Copy to Clipboard Toggle word wrap
   2. For more information on definition files and their content, refer to to definition file breakdown section.

4. In the execution environment definition file, specify the filepath to the original ee-minimal container via the EE_BASE_IMAGE field. In doing so, your final execution-environment.yml file will look like the following:

   Example 4.2. A customized execution-environment.yml file

   ---
   version: 1
   
   build_arg_defaults:
     EE_BASE_IMAGE: 'example.registry.com/my-base-ee'
   
   dependencies:
     galaxy: requirements.yml

   Copy to Clipboard Toggle word wrap
   Note

   Since this example uses the community version of kubernetes.core and not a certified collection from automation hub, we do not need to create an ansible.cfg nor reference that in our definition file.

5. Build the new execution environment image using the following command:

   $ ansible-builder build -t quay.io/[username]/new-ee

   Copy to Clipboard Toggle word wrap

   where [username] specifies your username, and new-ee specifies the name of your new container image.

   1. Use the podman images command to confirm that your new container image is in that list:

      Example 4.3. Output of a podman images command with the image new-ee

      REPOSITORY          TAG     IMAGE ID      CREATED        SIZE
      localhost/new-ee    latest  f5509587efbb  3 minutes ago  769 MB

      Copy to Clipboard Toggle word wrap
6. Verify your newly-created execution environment image via Ansible Navigator

7. Push your image to the container registry automation hub:

   $ podman push quay.io/[username]/new-ee

   Copy to Clipboard Toggle word wrap

8. Pull your new image into your automation controller instance:

   1. Navigate to automation controller
   2. From the side-navigational bar, click Administration > Execution Environments.
   3. Click Add.

   4. Enter the appropriate information then hit Save to pull in the new image.

      Note

      if your instance of automation hub is password or token protected, ensure that you have the appropriate container registry credential set up.