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

4.0 KiB

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 · HTTPS-Ingress · Öffentliche API

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

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 · Zeitbroker

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.

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

Ö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.

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 · Interne TLS-Erneuerung · Zugänge