Files
rust-discovery/docs/server-deployment.md
T
2026-11-18 17:21:12 +01:00

41 lines
4.0 KiB
Markdown

# Aufbau des dedizierten Servers
Der ARM64-Server `discovery.ease-technologies.de` betreibt die WebUI, den MCP-Endpunkt, die Geräte-API und PostgreSQL. Unter `/opt/rust-discovery` liegen Deploymentkonfiguration, WebUI und der private Betriebszustand. Der externe Zugriff verteilt sich auf zwei TLS-Eingänge.
| Öffentlicher Zugang | Weiterleitung auf dem Server | Zweck |
| --- | --- | --- |
| TCP 443 | Socket-Proxy an `127.0.0.1:18444` | Gerätegateway. Registrierte Geräte authentisieren sich mit ihrem Clientzertifikat. |
| HTTPS 8443 | Nginx an `127.0.0.1:18445` | Öffentliche WebUI, lokale Anmeldung und MCP. |
| HTTPS 8443, Installer- und Bootstraprouten | Nginx an `127.0.0.1:18444` | Download der Installer und der freigegebenen Bootstrapdateien mit öffentlich vertrauenswürdiger TLS-Kette. |
Die private Entwicklungs-API lauscht auf `127.0.0.1:18443`. PostgreSQL ist nur im internen Netz erreichbar. Der HTTPS-Proxy prüft den Namen und die Zertifikatskette des jeweiligen Upstreams. Die öffentliche API verwendet das Produktionsprofil. [Gerätesocket](../deploy/server-ingress.socket) · [HTTPS-Ingress](../deploy/server-bootstrap-ingress.conf) · [Öffentliche API](../deploy/server.public-access.compose.yaml)
## Laufenden Stand aktualisieren
Der Deploymentrunner liest die tatsächlichen Compose-Dateien aus den Labels der laufenden Container. Er übernimmt Volumes und Richtlinien, wendet die Migrationen an, vergleicht deren Prüfsummen mit der gewählten Git-Revision und aktiviert API, Gateway und die vorhandene öffentliche API. Abschließend prüft er die Binärhashes, die TLS-Healthchecks und die ausgelieferte Startseite. Für einen reinen Frontendwechsel genügt der WebUI-Modus. [Build- und Deploymentbefehle](development.md)
## Signierte Zeitbelege
Der Hostdienst `rmm-time-broker.service` stellt dem Gateway signierte Zeitbelege aus. Die Zeitquelle prüft die konfigurierte Chrony-Prozessgeneration. Ein Wechsel des Prozesses kann eine erneute Prüfung dieser Bindung erfordern. Das Gateway erreicht den Broker über den Unix-Socket `/run/rmm-time-source/broker.sock`. Das Compose-Overlay bindet sein Verzeichnis schreibgeschützt ein. [Gateway-Mount](../deploy/server.time-broker.compose.yaml) · [Zeitbroker](../crates/time-broker-linux/src/native.rs)
Bei fehlendem Zeitbeleg auf dem Server zuerst Zustand und Startzeit beider Dienste sowie den Sockettyp lesen. Diese Abfrage benötigt keinen Zugriff auf private Schlüssel.
```sh
systemctl show rmm-time-broker.service chrony.service -p ActiveState -p MainPID -p ExecMainStartTimestamp
stat -c '%F %a %U:%G %n' /run/rmm-time-source/broker.sock
```
Auf dem Windows-Testgerät ist die automatische Wiederherstellung der Bereitschaft nach einem Gatewaywechsel dokumentiert. [Gerätebeobachtung](evidence/windows-gateway-clock-recovery-20261117.json)
## Öffentlichen Zugang einrichten
Auf einem bereits mit interner API, Gateway und öffentlicher TLS-Kette eingerichteten Entwicklungsserver richtet `tools/dev_public_access.py` die öffentliche Verwaltung ein. `prepare` provisioniert das lokale Bootstrapkonto, `activate` startet die zusätzliche API und kontrolliert deren Anmeldemodi. `publish` prüft die Nginx-Konfiguration und aktiviert den Ingress. `prepare` im Checkout mit dem bestehenden privaten `credentials/` ausführen. Die Zugangsdaten verbleiben beim Betreiber.
```sh
python3 tools/dev_public_access.py prepare
python3 tools/dev_public_access.py activate
python3 tools/dev_public_access.py publish
```
Der Server liest Benutzerkonten aus der geschützt eingebundenen `devstate/public-auth/users.json`. Änderungen dieser Kontokonfiguration werden beim Neustart von öffentlicher API und Gateway geladen. Das öffentliche Installerzertifikat und die internen Zertifikate haben getrennte Erneuerungsdienste. Ihre Zeitsteuerung ist in den Unit-Dateien hinterlegt. [Öffentliche TLS-Erneuerung](../deploy/server-bootstrap-tls-renew.timer) · [Interne TLS-Erneuerung](../deploy/server-tls-renew.timer) · [Zugänge](operations-access.md)