--- titel: Panel steuer127 — wie neue Server-Strecken funktionieren stand: 31.10.2026, 21:10 zweck: Nachschlagen, wie das Panel aufgebaut ist und wie man einen weiteren Server als Lernstrecke hinzufügt — samt aller Fallen, die am 31.10. Zeit gekostet haben. --- # Panel steuer127 — Aufbau und Erweiterung ## 1. Wo was liegt | Teil | Pfad | |---|---| | Programm (Flask) | `/home/steueruser1/panel/app.py` | | Seitenvorlage (Quelle) | `/home/steueruser1/panel/index.html` | | **Seite, die wirklich ausgeliefert wird** | **`/var/www/steuer127/index.html`** | | Schritt-Skripte | `/home/steueruser1/panel/schritte/` | | Protokolle der Läufe | `/home/steueruser1/panel/logs/` | | Dienst | `steuer-panel.service` (127.0.0.1:8080, davor nginx) | | Adresse | `https://steuer127.g3.local/` | **Wichtig:** nginx liefert die Oberfläche als **statische Datei** aus `/var/www/steuer127/`. Eine Änderung an `panel/index.html` wirkt erst, wenn sie dorthin kopiert wird. Am 31.10. habe ich zwanzig Minuten lang eine Änderung gesucht, die längst im Quellordner stand. ## 2. Wie ein Schritt funktioniert 1. `app.py` führt ein Verzeichnis `SERVER_SCHRITTE`, Schlüssel `(kennung, schritt)`, Wert `(pfad zum Skript, Titel)`. 2. Die Route `POST /api/server//schritt` startet genau dieses Skript — ein Knopf, ein Playbook, keine freie Kommandozeile. 3. Die Ausgabe läuft über `GET /api/lauf//strom` (Server-Sent-Events) live in den Browser; die Zeilen werden eingefärbt. 4. Sammellauf: `POST /api/server//alles` startet `-alles.sh` (unterstützt `VON` und `BIS`). Der Knopf heißt im Panel „⏩ Ruck-Zuck". ## 3. Einen weiteren Server hinzufügen (Rezept) Ein neuer Server braucht vier Dinge: 1. **Schritt-Skripte** in `panel/schritte/`, Namensschema `neuNN--.sh`. Jedes Skript: - setzt `ANSIBLE_CONFIG`, `ANSIBLE_HOST_KEY_CHECKING=False` - liest `/root/.hcloud_env` (für die Hetzner-API) - liest seine `neuNN.env` (**mit `. ` davor — siehe Falle 3**) - ruft **ein** `ansible-playbook` mit `-l "$NAME"` und `--tags` - prüft `RC` und beendet sich bei Fehler mit `exit $RC` 2. **`neuNN.env`** mit `NAME=`, `IP=`, `DOMAIN=`. 3. **Sammellauf** `neuNN-alles.sh`, der die Schritte der Reihe nach aufruft. 4. **Eintrag in `app.py`** — oder man lässt es automatisch machen: der Block `WEITERE_LEHRWEGE` liest alle `neu01-…`, `neu03-…`, `neu08-…` beim Start ein. Für eine neue Kennung genügt es, sie in dieses Tupel zu schreiben. 5. **Navigation**: ein `` in `index.html`, dazu ein Eintrag in `SERVER_WEG` und in `LEHRWEGE`. Erzeugt wurde das Ganze mit `hilfsskripte/panel-neue-lehrwege.sh` (Schritt-Skripte) und `hilfsskripte/panel-weitere-lehrwege.py` (app.py + index.html). ## 4. Fallen, die am 31.10. Zeit gekostet haben 1. **Die Seite wird aus `/var/www/steuer127/` ausgeliefert**, nicht aus dem Panel-Ordner. Änderung an `index.html` also immer dorthin kopieren. 2. **`import`/Variablen erst nach dem Einfügen prüfen.** Ein Patch hatte `SCHRITT_ORDNER` erst *benutzt*, dann geprüft, ob es existiert — dadurch wurde die Definition nie eingefügt und das Panel lief in eine Neustart-Schleife (`NameError`). Nach jedem Patch: `python3 -c "import ast; ast.parse(...)"` **und** `systemctl status` prüfen. 3. **Eine `.env` wird eingelesen (`. datei`), nicht ausgeführt.** In einem Sammellauf stand `$(…/neu03.env; echo $NAME)` — die Datei ist nicht ausführbar, `NAME` blieb leer, alle folgenden Schritte liefen ins Leere. 4. **Auskommentierte Zeilen zählen als „vorhanden".** Das Einlesen des Inventars suchte `if name in s:` — die Zeile `# wegwerf-03-nextcloud … (gelöscht)` enthält den Namen, also wurde nie geschrieben. Jetzt: jede Zeile mit dem Namen entfernen (auch auskommentierte), dann neu eintragen. 5. **Der Sammellauf findet seine Schritte über ein Namensmuster** (`neuNN-$n-*.sh`). Hießen die Dateien `neu03-3.sh`, passte das Muster nicht und der Lauf brach mit „Schritt 3 hat kein Skript" ab. Jetzt tragen alle Schritte einen sprechenden Namen (`neu03-3-grundausstattung.sh`). 6. **Rechte**: Skripte `755`, `.env` `644`, Besitzer `steueruser1`. Als `root` erzeugte Dateien sind lesbar, aber der Dienst läuft als `steueruser1`. 7. **Der Ruck-Zuck-Knopf fragt nach** (Sicherheitsfrage mit OK/Abbrechen). Das ist gewollt; im Kopf steht noch „alle acht Schritte", auch wenn die Strecke sieben hat. ## 5. Prüfen, ob es läuft ```bash systemctl is-active steuer-panel.service # active curl -s http://127.0.0.1:8080/api/schritte # alle Schritte als JSON curl -s -X POST -H 'Content-Type: application/json' -d '{}' \ http://127.0.0.1:8080/api/server/neu99/alles # muss "Skript fehlt" melden curl -sk -H 'Host: steuer127.g3.local' https://127.0.0.1/ | grep data-server ``` Der dritte Aufruf ist der beste Test: eine **unbekannte** Kennung muss eine saubere Fehlermeldung bringen — dann ist die Route da, ohne dass etwas startet. ## 6. Die Strecken, die es jetzt gibt | Kennung | Panel-Eintrag | Server | Schritte | |---|---|---|---| | `neu05` | 10 · Ansible-Lehrweg | 05 Buttons | 8 | | `neu09` | 11 · Audio/Telefon | 09 Audio | 8 | | `neu01` | 12 · LiveKit / Telefonie | 01 LiveKit | 7 | | `neu03` | 13 · Nextcloud / Avatar | 03 Nextcloud | 7 | | `neu08` | 14 · VPN / headscale | 08 headscale | 6 | ## 7. Beleg eines vollständigen Laufs Der erste vollständige Ruck-Zuck-Lauf über die Oberfläche (Strecke 13, 31.10.2026, 20:36–20:54) liegt als Protokoll im Projekt: `docs\belege\20261031-203629-neu03-alles.log`. Er zeigt je Schritt die Ansible-Ausgabe, die PLAY RECAPs und die Abnahme — genau das, was im Panel rechts mitläuft. Ausgewertet in `docs\29-SERVER03-WIEDERAUFBAU.md` Abschnitt 7.