Chapter 2. Configuring the Red Hat Ansible Automation Platform Operator on Red Hat OpenShift Container Platform
As a namespace administrator, you can use Ansible Automation Platform gateway to manage new Ansible Automation Platform components in your OpenShift environment.
The Ansible Automation Platform gateway uses the Ansible Automation Platform custom resource to manage and integrate the following Ansible Automation Platform components into a unified user interface:
- Automation controller
- Automation hub
- Event-Driven Ansible
- Red Hat Ansible Lightspeed (This feature is disabled by default, you must opt in to use it.)
Before you can deploy the platform gateway you must have Ansible Automation Platform Operator installed in a namespace. If you have not installed Ansible Automation Platform Operator see Installing the Red Hat Ansible Automation Platform Operator on Red Hat OpenShift Container Platform.
Platform gateway is only available under Ansible Automation Platform Operator version 2.5. Every component deployed under Ansible Automation Platform Operator 2.5 defaults to version 2.5.
If you have the Ansible Automation Platform Operator and some or all of the Ansible Automation Platform components installed see Deploying the platform gateway with existing Ansible Automation Platform components for how to proceed.
2.1. Linking your components to the platform gateway
After installing the Ansible Automation Platform Operator in your namespace you can set up your Ansible Automation Platform instance. Then link all the platform components to a single user interface.
Procedure
- Log in to Red Hat OpenShift Container Platform.
-
Navigate to
. - Select your Ansible Automation Platform Operator deployment.
- Select the Details tab.
- On the Ansible Automation Platform tile click .
- From the Create Ansible Automation Platform page enter a name for your instance in the Name field.
Click
and paste the following:spec: database: resource_requirements: requests: cpu: 200m memory: 512Mi storage_requirements: requests: storage: 100Gi controller: disabled: false eda: disabled: false hub: disabled: false storage_type: file file_storage_storage_class: <read-write-many-storage-class> file_storage_size: 10Gi
- Click .
Verification
Go to your Ansible Automation Platform Operator deployment and click Ansible Automation Platform instance and the deployed AutomationController, EDA, and AutomationHub instances here.
to verify if all instances deployed correctly. You should see the
Alternatively you can check by the command line, run: oc get route
2.2. Deploying the platform gateway with existing Ansible Automation Platform components
You can link any components of the Ansible Automation Platform, that you have already installed to a new Ansible Automation Platform instance.
The following procedure simulates a scenario where you have automation controller as an existing component and want to add automation hub and Event-Driven Ansible.
Procedure
- Log in to Red Hat OpenShift Container Platform.
-
Navigate to
. - Select your Ansible Automation Platform Operator deployment.
- Click Update channel to stable-2.5. and edit your
- Click Ansible Automation Platform tile click . and on the
From the Create Ansible Automation Platform page enter a name for your instance in the Name field.
-
When deploying an Ansible Automation Platform instance, ensure that
auto_update
is set to the default value offalse
on your existing automation controller instance in order for the integration to work.
-
When deploying an Ansible Automation Platform instance, ensure that
Click
and copy in the following:apiVersion: aap.ansible.com/v1alpha1 kind: AnsibleAutomationPlatform metadata: name: example-aap namespace: aap spec: database: resource_requirements: requests: cpu: 200m memory: 512Mi storage_requirements: requests: storage: 100Gi # Platform image_pull_policy: IfNotPresent # Components controller: disabled: false name: existing-controller-name eda: disabled: false hub: disabled: false ## uncomment if using file storage for Content pod storage_type: file file_storage_storage_class: <your-read-write-many-storage-class> file_storage_size: 10Gi ## uncomment if using S3 storage for Content pod # storage_type: S3 # object_storage_s3_secret: example-galaxy-object-storage ## uncomment if using Azure storage
- For new components, if you do not specify a name, a default name is generated.
- Click .
- To access your new instance, see Accessing the platform gateway.
If you have an existing controller with a managed Postgres pod, after creating the Ansible Automation Platform resource your automation controller instance will continue to use that original Postgres pod. If you were to do a fresh install you would have a single Postgres managed pod for all instances.
2.3. Accessing the platform gateway
You should use the Ansible Automation Platform instance as your default. This instance links the automation controller, automation hub, and Event-Driven Ansible deployments to a single interface.
Procedure
To access your Ansible Automation Platform instance:
- Log in to Red Hat OpenShift Container Platform.
-
Navigate to
- Click the link under Location for Ansible Automation Platform.
- This redirects you to the Ansible Automation Platform login page. Enter "admin" as your username in the Username field.
For the password you need to:
-
Go to to
. - Click and copy the password.
- Paste the password into the Password field.
-
Go to to
- Click .
Apply your subscription:
- Click or .
- Upload your manifest or enter your username and password.
- Select your subscription from the Subscription list.
-
Click
This redirects you to the Analytics page. .
- Click .
- Select the I agree to the terms of the license agreement checkbox.
- Click .
You now have access to the platform gateway user interface. If you cannot access the Ansible Automation Platform see Frequently asked questions on platform gateway for help with troubleshooting and debugging.