Installation von AWX (Docker Version)

Um AWX zu installieren, folgen Sie diesen Schritten:

1. Installieren Sie zunächst einige notwendige Pakete:

   sudo apt install docker.io docker-compose ansible
   

2. Starten Sie den Docker-Dienst und fügen Sie ihn dem Autostart hinzu:

   sudo systemctl enable docker
   sudo systemctl start docker
   

3. Klonen Sie AWX in der neuesten Version von Github:

   git clone https://github.com/ansible/awx.git
   

4. Wechseln Sie in den AWX-Ordner:

   cd awx/
   

5. Erstellen Sie das Image:

   sudo make docker-compose-build
   

6. Wenn Ihr System hinter einem Proxy steht, übertragen Sie ihn in die Docker-Konfiguration:

   sudo mkdir -p /etc/systemd/system/docker.service.d/
   sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
   

   Fügen Sie folgenden Inhalt ein:

   [Service]
   Environment="HTTP_PROXY=http://<USERNAME>:<PASSWORD>@<PROXY-IP>:<PORT>"
   Environment="HTTPS_PROXY=https://<USERNAME>:<PASSWORD>@<PROXY-IP>:<PORT>"
   

7. Starten Sie die Container für AWX, Postgres und Redis:

   sudo make docker-compose
   

   Hinweis: Der Befehl blockiert die Kommandozeile. Verwenden Sie sudo make docker-compose &, um die Shell weiterhin nutzen zu können.

8. Warten Sie, bis der Dialog erscheint, bevor Sie fortfahren.

9. Starten Sie die grafische Oberfläche:

   sudo docker exec tools_awx_1 make clean-ui ui-devel
   

10. Konfigurieren Sie den Proxy für NPM innerhalb des Docker Containers:

    docker exec -it tools_awx_1
    npm config set proxy http://username:password@host:port
    npm config set https-proxy http://username:password@host:port
    

11. Starten Sie erneut die grafische Oberfläche:

    docker exec tools_awx_1 make clean-ui ui-devel
    

12. Die grafische Oberfläche ist unter der Adresse https://localhost:8043/ erreichbar.

13. Legen Sie vor dem ersten Login ein Administrator-Konto an:

    sudo docker exec -ti tools_awx_1 awx-manage createsuperuser
    

    Der darauf folgende Eingabeprompt verlangt von uns dann Benutzername und Passwort. Nach erfolgter Eingabe lässt sich dieser Benutzer auch direkt benutzen um die Login-Maske zu überwinden:

14. Erstellen Sie ein Skript, um AWX automatisch nach einem Neustart zu starten:

    nano /opt/start_awx.sh
    chmod +x /opt/start_awx.sh
    

    Inhalt der Datei /opt/start_awx.sh:

    #!/bin/bash
    cd /<INSTALLATIONSPFAD_VON_AWX>/awx/ && make docker-compose
    

15. Fügen Sie das Skript dem Cron-Dienst hinzu:

    crontab -e
    

    Fügen Sie folgende Zeile am Ende der Datei hinzu:

    @reboot /opt/start_awx.sh
    

Durch Ausführen von make docker-compose wird AWX gestartet.