Providing feedback on Red Hat documentation

If you have a suggestion to improve this documentation, or find an error, you can contact technical support at https://access.redhat.com to open a request.

1. Introduction

Red Hat Ansible Inside 1.3 is a product bundle of Ansible Executor (runner), Ansible Core, Ansible Automation content navigator, Ansible Builder and Ansible automation execution environments. Ansible Inside allows a Red Hat Partner to integrate Ansible automation within their application using the Command Line Interfaces of the Ansible components.

2. Installing Red Hat Ansible Inside

You can install the following Red Hat Ansible Inside components using the Red Hat Subscription Manager (RHSM). Alternatively, you can download them from the Red Hat Registry.

  • Ansible Core (installed via RHSM)

  • Ansible Executor (runner) (installed via RHSM)

  • Ansible Navigator (installed via RHSM)

  • Ansible Builder (installed via RHSM)

  • Ansible SDK (installed via RHSM)

  • Ansible Execution Environment (Downloaded via Red Hat Registry)

You can install all the RHSM components as All-In-One or Individually.

2.1. Prerequisites

Ansible Inside requires a valid subscription to an Ansible Inside SKU and enablement of the corresponding Red Hat Subscription Manager (RHSM) repository.

Contact Red Hat customer support or Red Hat sales for purchasing or attaching an Ansible Inside subscription.

After a valid Ansible Inside subscription has been attached to your organization within Red Hat Subscription Manager, you can enable the required repository as follows:

  • RHEL 8

sudo subscription-manager repos --enable=ansible-inside-1.3-for-rhel-8-x86_64-rpms

  • RHEL 9

sudo subscription-manager repos --enable=ansible-inside-1.3-for-rhel-9-x86_64-rpms

After the repository is enabled, you can proceed with installing the Ansible components.

2.2. Installing with Red Hat Subscription Manager (RHSM)

2.2.1. All-In-One RHSM

To install all the components in one go, run the following command:

RHEL 8
sudo dnf install ansible-navigator ansible-core ansible-builder ansible-runner python39-ansible-sdk
RHEL 9
sudo dnf install ansible-navigator ansible-core ansible-builder ansible-runner python3-ansible-sdk

2.2.2. Individual RHSM

You can install only the required components for your needs individually using the following commands:

Ansible Core
sudo dnf install ansible-core
Ansible Builder
sudo dnf install ansible-builder
Ansible Runner
sudo dnf install ansible-runner
Ansible Navigator
sudo dnf install ansible-navigator
Ansible SDK
RHEL 8
sudo dnf install python39-ansible-sdk
RHEL 9
sudo dnf install python3-ansible-sdk

2.3. Download from the Red Hat Registry

Automation execution environments are used in Ansible Inside as either a baseline to execute your Ansible automation with, or can be used with Ansible Builder to provide extended automation compatibility to suit your needs.

2.3.1. RHEL 9 execution environments

The Red Hat supported execution environments available for RHEL 9 are:

compatibility execution environment (ansible-automation-platform-24/ee-216-rhel9)

ee-216 contains ansible 2.16 for compatibility with playbooks and content written for previous versions of Red Hat Ansible Automation Platform.

minimal execution environment ansible-automation-platform-24/ee-minimal-rhel9)

ee-minimal is an automation execution environment for Red Hat Ansible Automation Platform. ee-minimal contains ansible-core 2.16.

supported execution environment (ansible-automation-platform-24/ee-supported-rhel9)

ee-supported is an automation execution environment for use with Red Hat Ansible Automation Platform. ee-supported contains ansible-core 2.16 and automation content collections supported by Red Hat.

2.3.2. RHEL 8 execution environments

The Red Hat supported execution environments available for RHEL 8 are:

compatibility execution environment (ansible-automation-platform-24/ee-216-rhel8)

ee-216 contains ansible 2.16 for compatibility with playbooks and content written for previous versions of Red Hat Ansible Automation Platform.

minimal execution environment ansible-automation-platform-24/ee-minimal-rhel8)

ee-minimal is an automation execution environment for Red Hat Ansible Automation Platform. ee-minimal contains ansible-core 2.15.

supported execution environment (ansible-automation-platform-24/ee-supported-rhel8)

ee-supported is an automation execution environment for use with Red Hat Ansible Automation Platform. ee-supported contains ansible-core 2.15 and automation content collections supported by Red Hat.

Example of pulling an image

You can pull the images using a container engine such as Podman. The following example uses podman pull.

$ podman login registry.redhat.io
Username: {REGISTRY-SERVICE-ACCOUNT-USERNAME}
Password: {REGISTRY-SERVICE-ACCOUNT-PASSWORD}
Login Succeeded!

$ podman pull registry.redhat.io/ansible-automation-platform/ee-minimal-rhel8:2.16.9-2

Refer to catalog.redhat.com for other installation methods available.