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 (z. B. 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. PLAMIS-LEARNBesucher hängthängen per Cookie lb an einem KnotenKnoten. (Sticky).Ist Apps mit nur einemder Knoten sinddraußen, beimleitet Neustartder diesesHAProxy Knotenssie kurzauf weg.den anderen um (option redispatch).
Dienstenginx mit Programmaustausch, php-fpm sofort neu.
Prüfungennginx, php8.4-fpm, /healthz. In A das Testskript je App (app-test-<app>.py) und bei BookStack /status und die Anmeldeseite.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 17.18.11.2026 · Quelle: docs/engineering/UPDATE_STRATEGIE.html im Repo TENTEN-INFRA · Commit 0698180ff71bf7 2026-11-1718 · Diese Seite wird aus dem Repo erzeugt, Änderungen bitte dort.