How ansible/awx-operator works
AWX Operator reconciles Kubernetes custom resources into AWX deployments and manages their lifecycle. Its principal workflow is an administrator submitting an AWX resource, which the operator watches and handles through the AWX playbook and installer role. Separate custom-resource workflows cover backups, restores, and mesh ingress. The tree and README establish these capabilities and role boundaries; sampled source does not include the reconciliation implementation, so detailed call wiring is not asserted.
Main entry points: watches.yaml AWX Operator · tasks/main.yml AWX Installer · tasks/main.yml Restore Tasks · tasks/main.yml Mesh Ingress Tasks
Components 18
AWX Reconciliation
- AWX Operator
watches.yaml - AWX Playbook
playbooks/awx.yml - AWX Installer
roles/installer/tasks/main.yml - Deployment Templates
roles/installer/templates/deployments - PostgreSQL
roles/installer/templates/statefulsets/postgres.yaml.j2
Lifecycle Operations
- Backup Tasks
roles/backup/tasks/main.yml - Backup Storage
roles/backup/templates/backup_pvc.yml.j2 - Restore Tasks
roles/restore/tasks/main.yml - AWX Restore Object
roles/restore/templates/awx_object.yml.j2
Mesh Networking
- Mesh Ingress Tasks
roles/mesh_ingress/tasks/main.yml - Mesh Deployment
roles/mesh_ingress/templates/deployment.yml.j2 - Receptor Service
roles/mesh_ingress/templates/service.yml.j2
Cluster Resources
- AWX Resource
config/crd/bases/awx.ansible.com_awxs.yaml - Backup Resource
config/crd/bases/awx.ansible.com_awxbackups.yaml - Restore Resource
config/crd/bases/awx.ansible.com_awxrestores.yaml - Mesh Ingress Resource
config/crd/bases/awx.ansible.com_awxmeshingresses.yaml
Other components
- Cluster Admin
- Kubernetes API
Connections 18
- Cluster Admin → Kubernetes API: submits resources
- Kubernetes API → AWX Resource: stores
- Kubernetes API → AWX Operator: notifies changes
- AWX Operator → AWX Playbook: dispatches
- AWX Playbook → AWX Installer: runs
- AWX Installer → Deployment Templates: renders workloads
- AWX Installer → PostgreSQL: renders database
- Kubernetes API → Backup Resource: stores
- Kubernetes API → Restore Resource: stores
- Kubernetes API → Mesh Ingress Resource: stores
- AWX Operator → Backup Tasks: dispatches
- AWX Operator → Restore Tasks: dispatches
- AWX Operator → Mesh Ingress Tasks: dispatches
- Backup Tasks → Backup Storage: creates backup volume
- Restore Tasks → Backup Storage: reads backup
- Restore Tasks → AWX Restore Object: renders resource
- Mesh Ingress Tasks → Mesh Deployment: renders deployment
- Mesh Ingress Tasks → Receptor Service: renders service