Broker unterstützt jetzt mehrere WSGI Worker

This commit is contained in:
concierge committed 2026-11-03 16:47:20 +01:00
1 parent 1e2a58e563
commit f5b0c9509c
13 files changed
+1252 -327

No files matched your search

+25 -5
View File
@@ -70,12 +70,32 @@ Die Zeitfenster lassen sich über Umgebungsvariablen konfigurieren:
eingehende Nachricht inklusive Absender, Client-ID, Code und ermitteltem
Empfängerkreis nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die
Ausgabe abschalten.
- `CMBNET_WS_BUS_POLL_INTERVAL` (Default `0.5`): Intervall in Sekunden, in dem
jeder Worker die gemeinsame Queue für seine lokal verbundenen Clients prüft.
- `CMBNET_WS_EPHEMERAL_TTL_SECONDS` (Default `30`): Lebensdauer kurzlebiger
Code-2-Zustellaufträge.
- `CMBNET_WS_WORKER_ID`: optionale feste Worker-ID; muss je Worker-Prozess
eindeutig sein. Standardmäßig wird `<hostname>:<pid>` verwendet.
Die Client-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie
überstehen damit kurze WebSocket-Unterbrechungen, nicht aber einen
Seiten-Reload mit neuer Client-ID oder einen Neustart des Servers. Der mobile
Client puffert zusätzlich ausgehende fachliche Nachrichten kurzzeitig im
Speicher und sendet sie nach erfolgreicher Authentifizierung automatisch nach.
Die Client-Queues und Sequenznummern liegen in der gemeinsamen SQLite-Datenbank
(`ws_clients`, `ws_client_queue`). Dadurch überstehen sie einen Worker-Neustart
und einen Reconnect auf einem anderen WSGI-Worker. Jeder Worker betreibt eine
eigene Zustellschleife und liefert nur an seine lokal verbundenen Clients aus.
Die Latenz für workerübergreifende Nachrichten ergibt sich aus
`CMBNET_WS_BUS_POLL_INTERVAL` (Default `0.5` Sekunden). Der mobile Client
puffert zusätzlich ausgehende fachliche Nachrichten kurzzeitig im Speicher und
sendet sie nach erfolgreicher Authentifizierung automatisch nach.
Für den Betrieb mit mehreren Workern muss Gunicorn ohne `preload_app` laufen,
damit Heartbeat und Zustellschleife in jedem Worker-Prozess starten:
```bash
gunicorn --worker-class gevent --workers 4 --bind 127.0.0.1:5000 wsgi:app
```
SQLite läuft dabei im WAL-Modus mit einem `busy_timeout`. Bei sehr vielen
Clients oder hoher Schreiblast sollte statt SQLite ein Redis- oder
PostgreSQL-Bus verwendet werden.
Eine ausführliche Beschreibung des Protokolls, der Brokerlogik, der
Nebenläufigkeit und der aktuellen Abweichungen steht in