← zur Übersicht

Panel steuer127 — wie neue Server-Strecken funktionieren


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

TeilPfad
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/
Dienststeuer-panel.service (127.0.0.1:8080, davor nginx)
Adressehttps://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

(kennung, schritt), Wert (pfad zum Skript, Titel).

ein Knopf, ein Playbook, keine freie Kommandozeile.

in den Browser; die Zeilen werden eingefärbt.

(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:

neuNN-<schritt>-<kurzname>.sh. Jedes Skript:

WEITERE_LEHRWEGE liest alle neu01-…, neu03-…, neu08-… beim Start ein.

Für eine neue Kennung genügt es, sie in dieses Tupel zu schreiben.

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

Panel-Ordner. Änderung an index.html also immer dorthin kopieren.

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.

Sammellauf stand $(…/neu03.env; echo $NAME) — die Datei ist nicht

ausführbar, NAME blieb leer, alle folgenden Schritte liefen ins Leere.

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.

(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).

erzeugte Dateien sind lesbar, aber der Dienst läuft als steueruser1.

Das ist gewollt; im Kopf steht noch „alle acht Schritte", auch wenn die

Strecke sieben hat.

5. Prüfen, ob es läuft


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

KennungPanel-EintragServerSchritte
neu0510 · Ansible-Lehrweg05 Buttons8
neu0911 · Audio/Telefon09 Audio8
neu0112 · LiveKit / Telefonie01 LiveKit7
neu0313 · Nextcloud / Avatar03 Nextcloud7
neu0814 · VPN / headscale08 headscale6

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.