AWX unter Ubuntu / Debian installieren – Schritt-für-Schritt-Anleitung

Einleitung

AWX ist die Open-Source-Variante des Red Hat Automation Controllers (ehem. Ansible Tower). Dieser Leitfaden zeigt die Installation auf Ubuntu 24.04 LTS oder Debian 12 – inklusive Docker/Compose und dem empfohlenen AWX Operator.

Voraussetzungen

• Ubuntu 22.04+/Debian 12
• Docker & Docker Compose
• Root-/sudo-Zugriff
• DNS-Name (z. B. awx.systemforge.de)

1) System aktualisieren

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git vim unzip

2) Docker & Compose installieren

curl -fsSL https://get.docker.com | sudo bash
sudo apt install -y docker-compose-plugin
sudo systemctl enable docker --now

3) AWX Operator bereitstellen (empfohlen)

git clone https://github.com/ansible/awx-operator.git
cd awx-operator
git checkout $(git tag | sort -V | tail -n1)
export NAMESPACE=awx
make deploy

4) AWX Deployment konfigurieren

Erstelle awx-deploy.yml:

apiVersion: awx.ansible.com/v1beta1
kind: AWX
metadata:
  name: awx
spec:
  service_type: ClusterIP
  ingress_type: ingress
  hostname: awx.systemforge.de
  admin_user: admin
  admin_password_secret: awx-admin-password

Deployment anwenden:

kubectl apply -f awx-deploy.yml

5) Zugangsdaten abrufen

kubectl get secret awx-admin-password -o jsonpath="{.data.password}" | base64 --decode ; echo

Danach erreichst du das Dashboard unter https://awx.systemforge.de.

Bonus: Ältere Docker-Variante (deprecated)

git clone https://github.com/ansible/awx.git
cd awx/installer
ansible-playbook -i inventory install.yml

Fazit

Mit AWX erhältst du eine zentrale, grafische Oberfläche für Ansible. Für produktive Umgebungen ist der Operator-Weg der empfohlene Pfad.