Skip to main content

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.