Ansible-GUI-Small/README.md

Ansible Playbook Runner

Mit dieser Anwendung kannst du Ansible‑Playbooks über eine Weboberfläche ausführen.
Die App läuft auf deinem Rechner und ist über https://man-dan-05 erreichbar.

Was du brauchst

• Python 3.11 (oder neuer)
• Docker und Docker Compose (für den Nginx‑Proxy)
• Ansible (auf deinem Rechner installiert)
• Die Dateien aus diesem Projekt

So startest du die Anwendung

1. Zertifikate bereitlegen
   Die Dateien certs/man-dan-05.crt und certs/man-dan-05.key müssen im Ordner certs liegen.
   (Falls du andere Zertifikate hast, passe die Pfade in nginx.conf an.)

2. Playbooks ablegen
   Lege deine .yml‑ oder .yaml‑Playbooks in den Ordner playbooks.

3. Starten
   Führe im Projektverzeichnis das Startskript aus:

   ./start.sh
   

   Das Skript startet zuerst den Nginx‑Container und danach die Reflex‑App.

4. Öffnen
   Rufe im Browser https://man-dan-05 auf.
   (Beim ersten Mal musst du die Zertifikatswarnung akzeptieren.)

Was die einzelnen Dateien tun

Datei	Aufgabe
app/app.py	Die eigentliche Anwendung (Weboberfläche, Playbook‑Ausführung)
rxconfig.py	Einstellungen für Reflex (Ports, URLs, CORS)
nginx.conf	Konfiguration für den Nginx‑Reverse‑Proxy (HTTPS, Weiterleitung)
docker-compose.yml	Startet den Nginx‑Container
start.sh	Startet Nginx und die App nacheinander
certs/	Ordner für die SSL‑Zertifikate
playbooks/	Ordner für deine Ansible‑Playbooks
outputs/	Hier werden die Ausgaben der Playbook‑Läufe gespeichert

Fehlerbehebung

• Seite lädt nicht → Prüfe, ob der Nginx‑Container läuft: docker ps
• Keine Playbooks gefunden → Liegen .yml‑Dateien im Ordner playbooks?
• Zertifikatswarnung → Das ist normal bei selbst erstellten Zertifikaten. Akzeptiere die Warnung.
• WebSocket‑Fehler → Stelle sicher, dass in rxconfig.py die URL wss://man-dan-05/api/_event steht und in nginx.conf der Pfad /api/_event korrekt weitergeleitet wird.

Anwendung beenden

• Reflex‑App: Strg + C im Terminal, in dem reflex run läuft.
• Nginx‑Container: docker compose down