Entferne ignorierten Ordner aus Git-Tracking
This commit is contained in:
56
README.md
Normal file
56
README.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user