Red Hat SummitRed Hat Ansible Inside Installation Guide
Install and configure Red Hat Inside
Abstract
Use Red Hat Ansible Inside to integrate Ansible automation within your applications using the Command Line Interfaces of the Ansible components.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.
Chapter 1. Introduction
Red Hat Ansible Inside 1.2 is a product bundle of Ansible Executor (runner), Ansible Core, Ansible Navigator, Ansible Builder and Ansible 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.
Chapter 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.2-for-rhel-8-x86_64-rpms
- RHEL 9
sudo subscription-manager repos --enable=ansible-inside-1.2-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
Ansible 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.
The Red Hat supported execution environments available are:
- compatibility execution environment (ansible-automation-platform-24/ee-29-rhel8)
- ee-29 contains ansible 2.9, for compatibility with playbooks and content written for previous versions of 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 pull for an image
All the images can be pulled using Podman and other means. 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-2Refer to catalog.redhat.com for other installation methods available.
