Chapter 1. Installing Red Hat Ansible Automation Platform Operator on Red Hat OpenShift Container Platform

Procedure

1. Log in to Red Hat OpenShift Container Platform.
2. Navigate to Operators OperatorHub.
3. Search for Ansible Automation Platform and click Install.

4. Select an Update Channel:

   • stable-2.x: installs a namespace-scoped operator, which limits deployments of automation hub and automation controller instances to the namespace the operator is installed in, this is suitable for most cases. The stable-2.x channel does not require administrator privileges and utilizes fewer resources because it only monitors a single namespace.
   • stable-2.x-cluster-scoped: installs the Ansible Automation Platform Operator in a single namespace that manages Ansible Automation Platform custom resources and deployments in all namespaces. The Ansible Automation Platform Operator requires administrator privileges for all namespaces in the cluster.
5. Select Installation Mode, Installed Namespace, and Approval Strategy.
6. Click Install.

Procedure

1. Create a project for the operator.

   oc new-project ansible-automation-platform

   Copy to Clipboard Toggle word wrap
2. Create a file called sub.yaml.

3. Add the following YAML code to the sub.yaml file.

   ---
   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
     name: ansible-automation-platform
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: ansible-automation-platform-operator
     namespace: ansible-automation-platform
   spec:
     targetNamespaces:
       - ansible-automation-platform
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: ansible-automation-platform
     namespace: ansible-automation-platform
   spec:
     channel: 'stable-2.5'
     installPlanApproval: Automatic
     name: ansible-automation-platform-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   ---

   Copy to Clipboard Toggle word wrap

   This file creates a Subscription object called ansible-automation-platform that subscribes the ansible-automation-platform namespace to the ansible-automation-platform-operator operator.

4. Run the oc apply command to create the objects specified in the sub.yaml file:

   oc apply -f sub.yaml

   Copy to Clipboard Toggle word wrap

5. Verify the CSV PHASE reports "Succeeded" before proceeding using the oc get csv -n ansible-automation-platform command:

   oc get csv -n ansible-automation-platform
   
   NAME                               DISPLAY                       VERSION              REPLACES                           PHASE
   aap-operator.v2.5.0-0.1728520175   Ansible Automation Platform   2.5.0+0.1728520175   aap-operator.v2.5.0-0.1727875185   Succeeded

   Copy to Clipboard Toggle word wrap

6. Create an AnsibleAutomationPlatform object called example in the ansible-automation-platform namespace.

   To change the Ansible Automation Platform and its components from example, edit the name field in the metadata: section and replace example with the name you want to use:

   oc apply -f - <<EOF
   apiVersion: aap.ansible.com/v1alpha1
   kind: AnsibleAutomationPlatform
   metadata:
     name: example
     namespace: ansible-automation-platform
   spec:
     # Platform
     image_pull_policy: IfNotPresent
     # Components
     controller:
       disabled: false
     eda:
       disabled: false
     hub:
       disabled: false
       ## Modify to contain your RWM storage class name
       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 Content pod
       # storage_type: azure
       # object_storage_azure_secret: azure-secret-name
     lightspeed:
       disabled: true
   EOF

   Copy to Clipboard Toggle word wrap