57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# 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:
|
||
```bash
|
||
./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`
|