Direkt zum Hauptinhalt

B2 Web-App-Server

Update-Strategie · Teil B · B2
Eigenheiten je System
externCluster mit StaffelWAPS02 Stufe 1, WAPS01 Stufe 2
Steckbrief
SystemeWAPS01, WAPS02 (Cluster webapp_shared), Web-Apps mit Konten und Daten (PLAMIS-LEARN, BookStack), alle Apps auf beiden Knoten
Klasse · Art · Stufeextern · Cluster mit Staffel · WAPS02 Stufe 1, WAPS01 Stufe 2
VerteilungWie die Webserver über /healthz je Knoten. Besucher hängen per Cookie lb an einem Knoten. Ist der Knoten draußen, leitet der HAProxy sie auf den anderen um (option redispatch).
Dienstenginx mit Programmaustausch, php-fpm sofort neu.
Prüfungennginx, php8.4-fpm, /healthz. In A das Testskript je App und bei BookStack /status und die Anmeldeseite je Instanz.
DatenDie App-Daten liegen im DB-Cluster. Bei einem Neustart von WAPS bleiben die Daten unberührt.

Ablauf

Wie bei den Webservern (B1), Reihenfolge WAPS01, dann WAPS02. In Schritt A prüft die Staffel statt der Sites:

1Prüfung wie im Fenster (nginx, php8.4-fpm, /healthz).
2Testskript je App (app-test-<app>.py, z. B. PLAMIS-LEARN).
3BookStack je Instanz: /status meldet DB, Cache und Sitzung als ok (bis zu 3 Versuche), die Anmeldeseite lädt.
42 min stabil, zurück, 5 min mit Verkehr beobachten.

Fehlerfall

Wie bei den Webservern: Der Knoten bleibt draußen, der andere trägt alle Apps, FEHLER-Mail mit Schritt. Besucher des herausgenommenen Knotens wechseln auf den anderen. Bei BookStack liegen die Sitzungen in der DB, Angemeldete bleiben angemeldet.

Eingriffe von Hand

infra-run ansible-playbook playbooks/kernel-rolling.yml -l athq-ls-waps02
infra-run ansible-playbook playbooks/maintenance.yml -e maintenance_class=extern -l athq-ls-waps02 --check

Herausnehmen und Zurückgeben über die Drain-Datei wie in B1. Staffel abschalten: ha_active.webapp_shared auf false.

Sonderfälle und Grenzen

  • Die Apps brauchen den DB-Cluster. Die DB-Staffel (04:00) und die WAPS-Staffel laufen nie gleichzeitig (Sperre). Wandert die DB-VIP, bauen die Apps ihre Verbindung neu auf.
  • Neue BookStack-Dateien schiebt lsyncd sofort zum anderen Knoten, nachts um 02:30 gleicht ein Abgleich Abweichungen aus (BOOKSTACK.md). Was während eines Neustarts nicht ankam, holt dieser Abgleich nach.
  • Neue Hauptfassungen der Apps kommen nicht über die Updates, sondern über das Ausrollen der App.

Gemessen

DatumLaufWert
15./16.11.2026Staffel mit Neustart (Test, ohne neuen Kernel)WAPS01 8 min 10 s, WAPS02 8 min 45 s, beide ok
18.11.2026Fenster ohne Bedarf5–6 s je Knoten

Stand 18.11.2026 · Quelle: docs/engineering/UPDATE_STRATEGIE.html im Repo TENTEN-INFRA · Commit ff71bf7 2026-11-18 · Diese Seite wird aus dem Repo erzeugt, Änderungen bitte dort.