install-aap
Overview
Installs Ansible Automation Platform (AAP) on OpenShift. AAP provides enterprise automation with Ansible Controller (formerly AWX/Tower), Automation Hub (private content repository), and Event-Driven Ansible.
The operator deploys in 3 waves:
- AAP operator (Subscription + OperatorGroup)
- AnsibleAutomationPlatform instance (Controller)
- AutomationHub instance
Prerequisites
- ArgoCD bootstrapped: [[bootstrap-gitops]] completed
- Sufficient resources: AAP requires ~16 cores, 32Gi RAM minimum
- Storage: persistent volumes required for database and hub artifacts
Quick Diagnostics
# Check AAP operator status
oc get subscription -n aap 2>/dev/null || echo "AAP not installed"
oc get csv -n aap | grep ansible
# Check AAP instance
oc get ansibleautomationplatform -A
# Check AutomationHub
oc get automationhub -A
# Check AAP pods
oc get pods -n aap | grep -v Running | grep -v Completed
# Get AAP console URL
oc get route -n aap | grep -E "controller|automation"
Steps
Step 1: Select the right operator overlay
| Cluster Scope | Path |
|---|---|
| Cluster-scoped (recommended) | gitops/cluster-config/ansible-automation-platform/operator/overlays/stable-2.5-cluster-scoped |
| Namespace-scoped | gitops/cluster-config/ansible-automation-platform/operator/overlays/stable-2.5 |
Step 2: Apply the AAP operator (wave 1)
oc apply -k gitops/cluster-config/ansible-automation-platform/operator/overlays/stable-2.5-cluster-scoped
Wait for operator to be ready:
until oc get csv -n aap | grep -q "ansible-automation-platform.*Succeeded"; do
echo "Waiting for AAP CSV..."; sleep 15
done
Step 3: Apply the AAP controller instance (wave 2)
# Default instance:
oc apply -k gitops/cluster-config/ansible-automation-platform/instance/overlays/default
# Cloud-specific:
# AWS: oc apply -k gitops/cluster-config/ansible-automation-platform/instance/overlays/aws
# Azure: oc apply -k gitops/cluster-config/ansible-automation-platform/instance/overlays/azure
Step 4: Apply the AutomationHub instance (wave 3)
oc apply -k gitops/cluster-config/ansible-automation-platform/hub-instance/overlays/default
Step 5: Wait for all components to be ready
# Wait for controller
oc wait ansibleautomationplatform -n aap --all \
--for=condition=Successful --timeout=600s
# Get admin password
oc get secret -n aap aap-admin-password -o jsonpath='{.data.password}' | base64 -d
Verification
# Controller and Hub should be Running
oc get ansibleautomationplatform -A
oc get automationhub -A
# All pods running
oc get pods -n aap | grep -v Running | grep -v Completed
# Get console URLs
oc get route -n aap
Common Failure Modes
| Symptom | Root Cause | Fix |
|---|---|---|
Controller pod Pending |
No PVC for database (no storage class) | Install ODF or configure default StorageClass |
Subscription stuck |
Wrong channel or catalog | Current channel: stable-2.5-cluster-scoped; check: oc get packagemanifest ansible-automation-platform -n openshift-marketplace |
Hub ProvisionFailed |
Insufficient resources | Hub needs ~8Gi RAM; check node capacity |
| Admin password secret not created | Instance not fully reconciled | Wait for ansibleautomationplatform condition Successful |
| Route not accessible | OAuth/ingress not configured | Check oc get oauth cluster for external IdP conflicts |
profiles reference stable-2.4 |
Old overlay path | Overlay was updated to stable-2.5; check ArgoCD Application path |
Related Skills
- [[bootstrap-gitops]] — Must be completed first
- [[install-odf]] — Recommended for database persistent storage
- [[deploy-profile]] — Use
aap-instance,baremetal-rhacm-hub, ordeveloper-envprofiles