docs: consolidate actual M0 to M4 evidence and remaining MVP scope
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-13 20:18:20 +01:00
parent d7bb30bf71
commit 75e4412b12
3 changed files with 188 additions and 339 deletions
+58 -168
View File
@@ -1,180 +1,70 @@
# Rust Discovery / RMM — Linux-MVP und Windows-Client
# Rust Discovery / RMM
> **Entwicklung wiederaufgenommen (2026-11-13).** Der endgültige Server läuft auf
> `discovery.ease-technologies.de`; der Entwickler-PC dient
> ausschließlich als Entwicklungsrechner, ohne installierten RMM-Client. Die
> Cloud-Linux-VM und eigenständiger Windows-11-Gast sind die Testclients. Topologie und
> Deploymentstand: [docs/server-deployment.md](docs/server-deployment.md).
> Die lokalen Serverbefehle und Slice-Beschreibungen unten sind historisch.
Aktueller Entwicklungsstand: **Linux-MVP M0–M5 noch nicht vollständig abgenommen**,
Spezifikation 1.13, 2026-11-13. Der endgültige Server ist
`discovery.ease-technologies.de`. Der Linux-Client läuft ausschließlich auf der
Ubuntu-Cloud-VM; das Notebook dient ausschließlich der Entwicklung. Die
Windows-11-Test-VM ist ein eigener Gast und darf parallel entwickelt werden.
**Aktuell (Spezifikation 1.13):** Windows darf auf ausdrücklichen Userwunsch bereits
parallel entwickelt werden. Erster nativer Windows-Client als LocalService mit
mTLS/WSS, gespeichertem Inventar, zwei frischen Heartbeats und Mandantentrennung
auf der Windows-11-VM nachgewiesen. Sieben native Tests bestanden.
Keine Windows-Jobcapability, erster Build unsigniert.
Linux-Cloud-Agent, getrennte API/Gateway-Rollen, echte WebUI-Genehmigung und
native Basis-/Rootdienstjobs, begrenzte Rootlogs und übereinstimmende gespeicherte
UI-/HTTP-/MCP-Ergebnisse sind nachgewiesen. TLS-Lebenszyklus, tatsächliche
Doppelzustellung/ACK-Verlust und automatischer WSS→HTTPS-Fallback bestanden.
Ursprüngliche APT-Teilwirkung ehrlich als fehlgeschlagen abgeglichen; danach
eigener genehmigter Configureversuch mit APT0/installed1.0, aber verweigerter
Abnahme wegen Host-Neustartmarker. Dieser Versuch bleibt **unknown**, keine
rückwirkende Acceptance oder Wiederholung. Readonly-Abgleich, Upgrade1.1/Noops,
Offline-/Abbruch-/Rebootabnahme und MVP-Endaudit weiter offen. Aktueller Stand:
[Implementierungsstand](docs/implementation-status.md),
[Windows-Client](deploy/windows/CLIENT.md), [Plattformmatrix](docs/platform-support.md),
[Entwicklungszugang](deploy/windows/README.md).
## Tatsächlich nachgewiesen
## Historischer erster passiver Slice
| Bereich | Aktueller Nachweis |
| --- | --- |
| M0 | Gepinnter Rust-Workspace, Migrationen/RLS, native ARM64-Serverbuilds und erhaltende Deployments; getrennte API-/Gatewayrollen, PostgreSQL intern und Verwaltungszugang über SSH-Tunnel. |
| M1 | Nativer unprivilegierter Linux-Dienst, Enrollment/mTLS, WSS und HTTPS, passives Inventar/Heartbeats; tatsächlicher Auto-Fallback nach zwei WSS-Abweisungen. TLS-Negativfälle, Rotation und Widerruf auf derselben Cloud-VM nachgewiesen. |
| M2, Teilabnahmen | Feste persistente Anträge, tatsächliche WebUI-Genehmigung, Journale/Startgrants; Hello, Live-Inventur und Rootdienstjobs; doppelte Zustellung und verlorenes Ergebnis-ACK ohne zweite Wirkung. Offline- und Prozessabbruchabnahmen bleiben offen. |
| M3 | Gespeicherte Geräte-/Jobergebnisse über WebUI, HTTP und MCP; Mandantentrennung; separat genehmigte begrenzte Rootlogs mit Quelle, Zeit und ehrlicher Teilabdeckung. |
| M4, begrenzter Katalog | Echtes Fixture-Update 1.0→1.1 mit unabhängiger Paket-/Nutzdateinachprüfung und nativer Acceptance; danach eigene erfolgreiche `ensure_package`- und `apply_updates`-Noops auf 1.1. |
**Kein fertiges MVP, keine Produktionsfreigabe.** Implementiert sind ein Rust-Workspace,
PostgreSQL mit mandantenlokalen Transaktionen/RLS und eine passive Linux-Agentstrecke:
Enrollment → lokaler P-256-Schlüssel → Gerätezertifikat → mTLS-WSS → Heartbeat/Basisinventar.
Es gibt **keine Jobtypen, Ausführungsqueue, Startgrants, Shell oder Executor**. Jobs bleiben
bis zu M2 einschließlich interaktiver menschlicher WebUI-Genehmigung ausgeschlossen.
Die Paketabnahme gilt ausschließlich für die gepinnten Rezepte von
`rmm-mvp-test` auf Ubuntu 24.04 x86-64. Beide Noops belegen
`changed=false`, `already_desired=true` und `transaction_executed=false`;
`apply_updates` ist dabei keine zweite Updateausführung. Der tatsächliche
Host-Neustartbedarf bleibt sichtbar `true`; ein Reboot wurde dadurch nicht
angestoßen. Beliebige Pakete, Repositories sowie OS-/Kernelupdates sind nicht
abgenommen.
**Lokal nachgewiesen:** PKI-Bootstrap unter OpenSSL 1.1.1w sowie Ende-zu-Ende-Tests
mit Docker-Server/PostgreSQL und nativem lokalem Linux-Agenten bestehen. Auf der tatsächlichen
Linux-Test-VM sind außerdem Enrollment/mTLS-WSS, passives Basisinventar und zwei frische
Heartbeats über den PC-initiierten Loopback-Reversetunnel nachgewiesen. Der begrenzte
Testprozess wurde danach gestoppt. **Systemd und M1 insgesamt sind nicht abgenommen.**
Details im Implementierungsstand.
Frühere APT-Teilwirkungen und der Configureversuch wurden originalgebunden und
über normalen signierten Sync ehrlich als fehlgeschlagene Abnahmen geschlossen.
Eine fehlende historische Host-Vorhermessung wurde nicht erfunden. Auch der erste
Noop mit veralteter Baseline bleibt als wirkungsloser `STATUS_FINGERPRINT`-Fehler
erhalten; der spätere erfolgreiche Noop hatte einen eigenen festen UI-Plan.
Verbindliche Produkt- und Arbeitsregeln: [Spec](Rust_RMM_Implementierungsspezifikation.md),
[AGENTS.md](AGENTS.md), [Entwicklungsweg](docs/development.md).
Den tatsächlichen Prüfstand und offene Abnahmen nennt [implementation-status](docs/implementation-status.md).
**Noch offen:** aktive Offline-/Frist-/Genehmigungsentzugsfälle,
Agentabbruch nach möglicher Wirkung mit gebundenem Abschluss, abschließender
MCP-Referenzbericht und zuletzt der eigene WebUI-genehmigte Reboot samt
Wiederanmeldung/Nachprüfung. [Abschlussaudit](docs/mvp-final-audit.md) und
[Abnahmegates](docs/mvp-gates.md) führen den verbleibenden Umfang.
## Voraussetzungen
## Genehmigung und Entwicklungsgrenzen
- Linux x86-64, Docker Engine und Compose v2, Python 3, OpenSSL.
- Für native Entwicklung: exakt **Rust 1.99.1**, `rustfmt`, `clippy`, C-Compiler,
`pkg-config` und OpenSSL-Entwicklungsbibliotheken. Toolchain über `rust-toolchain.toml`;
vollständige Dependency-Auflösung über `Cargo.lock`.
- Docker baut Server und Agent mit `rust:1.99.1-bookworm`; Laufzeit Debian Bookworm.
PostgreSQL ist intern, hat **keinen veröffentlichten Port**. Ausschließlich der
TLS-Port `127.0.0.1:18443` wird am PC veröffentlicht.
Jeder Ausführungsjob beginnt als persistenter Antrag `pending_approval`.
Vor dem WebUI-Klick existieren keine ausführbaren Jobs, Outboxeinträge oder
Startgrants. Die bisherigen positiven Abnahmen verwenden die ausdrücklich
erlaubte, sichtbar simulierte dev/test-Identität; das ist keine menschliche
Produktionsfreigabe. MCP und Automatik können nicht genehmigen. Passive
Standardinventur und Lesen gespeicherter Ergebnisse benötigen keinen Job.
## Lokaler Server
Der Windows-Client ist als LocalService mit Enrollment, mTLS/WSS, gespeichertem
Inventar und Mandantentrennung nativ passiv geprüft; sieben native Tests
bestanden. Der Entwicklungsbuild ist unsigniert und hat keinen Jobexecutor.
Windowsausbau, weitere Agentplattformen, PVE/PBS/Cluster/Backups und Betriebsreife
folgen außerhalb des Linux-MVP. RustDesk ist ausdrücklich ausgelassen.
```sh
python3 deploy/dev.py init
python3 deploy/dev.py up
python3 deploy/dev.py status
```
## Projektunterlagen
`init` erzeugt zufällige Datenbankpasswörter, getrennte Dev-Leseidentitäten und eine
Dev-CA mit Server-SAN **rmm-dev.internal** ausschließlich unter gitignored `devstate/`
(Verzeichnis 0700, Secrets 0600). Es überschreibt keinen vorhandenen Zustand.
Die isolierte `deploy/openssl.cnf` definiert CA-, Server- und Clientrollen ohne
Host-Konfigurationsübernahme oder doppelte Erweiterungen. Vorhandene fehlerhafte
PKI nicht durch erneutes `init` oder Löschen von Schlüsseln/Agentidentitäten ersetzen;
sie benötigt eine separat geprüfte lokale Reparatur.
`up` baut das Image, startet das eigene Compose-Projekt **rust-discovery-dev**, führt
SQLx-Migrationen als `rmm_migrator` aus und startet den unprivilegierten Server.
Ein frischer Zustand muss initialisiert werden; alte Datenvolumes werden nicht automatisch gelöscht.
Nur der Server ist zusätzlich im Ingress-Bridge-Netz, damit Docker den Loopback-Port
veröffentlicht; PostgreSQL und Migrator bleiben ausschließlich im internen Backend-Netz.
- [Verbindliche Spezifikation](Rust_RMM_Implementierungsspezifikation.md),
[AGENTS.md](AGENTS.md), [Projektentscheidungen](docs/project-decisions.md).
- [Tatsächlicher Implementierungsstand](docs/implementation-status.md),
[Plattformmatrix](docs/platform-support.md), [Abschlussaudit](docs/mvp-final-audit.md).
- [Server und aktuelle Topologie](docs/server-deployment.md),
[Entwicklungsregeln](docs/development.md), [Übergabe](docs/handover.md).
- [APT-Nachweise und Hostflagvertrag](docs/apt-ambient-reboot.md),
[Zustellungsabnahme](docs/delivery-acceptance.md),
[Auto-Fallback](docs/transport-acceptance.md),
[Windows-Client](deploy/windows/CLIENT.md), [Aufgaben nach dem MVP](docs/post-mvp.md).
Zwei feste **Entwicklungsmandanten**:
| Mandant | ID | geschützte lokale Leseidentität |
|---|---|---|
| A | `11111111-1111-4111-8111-111111111111` | `devstate/viewer-a.token` |
| B | `22222222-2222-4222-8222-222222222222` | `devstate/viewer-b.token` |
Dev-Bearer sind reine Leser genau eines Mandanten, keine Freigeber. `RMM_PROFILE=development`
und `RMM_DEV_AUTH=true` sind beide zwingend. Alle Produktionsprofile verweigern den Start,
auch mit deaktiviertem Dev-Auth: ein OIDC-Produktionsadapter existiert noch nicht.
`RMM_SERVER_ROLE=api|gateway|all` wählt die tatsächlich vorhandenen Rollen; lokal
ist `all` explizit konfiguriert. `api` lädt keinen CA-Signierschlüssel und bietet
keine Agentendpunkte an; `gateway` bietet keine Verwaltungs-Leseendpunkte an.
Produktive Dienstidentitäten/Signer-Isolation sind damit noch nicht abgenommen.
TLS-Healthprüfung ohne DNS-/Hosts-Änderung:
```sh
curl --noproxy '*' --cacert devstate/pki/ca.pem \
--resolve rmm-dev.internal:18443:127.0.0.1 \
https://rmm-dev.internal:18443/healthz
```
API: `GET /api/v1/tenants` und `GET /api/v1/tenants/{tenant_id}/devices`, mit
`Authorization: Bearer <Inhalt der passenden geschützten Token-Datei>`.
Secrets nicht in Shell-History, Terminalausgabe oder Diagnoseprotokolle kopieren.
Gerätelisten sind vorerst auf 100 begrenzt; weitere Datensätze werden als `truncated`
ausgewiesen, Cursor/Pagination und Einzelgerät-API fehlen noch.
## Linux-Agent lokal entwickeln
```sh
cargo build --locked -p rmm-agent -p rmm-server
python3 deploy/dev.py token a
RMM_AGENT_STATE=devstate/agent \
RMM_CA_FILE=devstate/pki/ca.pem \
RMM_ENROLLMENT_TOKEN_FILE=devstate/enroll-a.token \
RMM_CONNECT_ADDR=127.0.0.1:18443 \
target/debug/rmm-agent
```
Enrollment-Token sind einmalig und 15 Minuten gültig. Der Agent erzeugt den privaten
Geräteschlüssel **lokal** (0600), schreibt seine Identität in sein privates Zustandsverzeichnis
und verwendet sie nach Neustart erneut. Nach erfolgreichem Enrollment die lokale
Tokenkopie entfernen. Ein zweiter Prozess auf demselben Agentzustand wird per Lock abgewiesen.
Nicht denselben Agentzustand in VM-Templates klonen.
`RMM_CONNECT_ADDR` überschreibt ausschließlich das TCP-Ziel, **nicht** TLS-SNI oder
Namensprüfung: geprüft wird immer `rmm-dev.internal` gegen die explizite Dev-CA.
Keine Proxy-/System-CA-Abkürzung, kein Abschalten von TLS-Prüfungen.
Heartbeat 27–33 Sekunden, Vollinventar bei Verbindung und täglich; Root-Dateisystem
mit verfügbaren Bytes/Inodes, `/etc/os-release`, Hostname und Architektur. Das Inventar
ist ausdrücklich `partial` — kein vollständiges Hardware-/Softwareinventar.
## Echte Linux-VM / SSH-Reversepfad
Der verbindliche Pfad und Hostkey-Vertrauensklärung stehen in `docs/development.md`.
**Benutzerlokaler passiver VM-Test ausgeführt; keine dauerhafte systemd-Installation/-Abnahme.**
Die Vorlage `deploy/rmm-agent.service` ist daher nicht als nativ abgenommen zu verstehen.
Ausgeführte Befehle, Grenzen und private Evidenzpfade stehen in `docs/development.md`.
`python3 deploy/vm_access_check.py` ist der minimale lesende Zugangscheck.
`python3 deploy/vm_passive_test.py` führt dagegen einen echten begrenzten Bootstrap/
Enrollment-Test aus und erzeugt eine neue Dev-Geräteidentität samt Historie; nicht
unbesehen wiederholen. Er stoppt nur seine eigenen Agent-/Tunnelprozesse und erhält
das private VM-Testverzeichnis. Keine Root-/Paket-/Hosts-/Firewalländerungen oder Jobs.
Geplanter Transport, erst nach bestätigtem SSH-Hostkey und freigegebenem Bootstrap:
```text
PC ssh -N -T -o BatchMode=yes -o StrictHostKeyChecking=yes
-o ExitOnForwardFailure=yes -o ServerAliveInterval=30
-o ServerAliveCountMax=3
-R 127.0.0.1:18443:127.0.0.1:18443 <bestätigtes-VM-Ziel>
VM-Agent RMM_CONNECT_ADDR=127.0.0.1:18443
```
Der VM-Agent benötigt nur Binary, öffentliche CA und einmaliges Token. **Keine CA-Privat-
oder Server-/Viewer-Schlüssel auf die VM kopieren.** Kompatible glibc/OpenSSL-Laufzeit
vor Bootstrap lesen und prüfen. Keine Remote-Paketinstallation, Updates oder Reboots
als stillschweigende Voraussetzung. Für eine manuell gestartete Abnahme Logs und PID
im privaten Agentverzeichnis halten und beim Beenden nur diesen Prozess stoppen.
## Prüfungen
```sh
cargo fmt --all --check
cargo clippy --locked -p rmm-domain -p rmm-protocol -p rmm-persistence \
-p rmm-server -p rmm-agent-linux -p rmm-agent --all-targets -- -D warnings
cargo test --locked -p rmm-domain -p rmm-protocol -p rmm-agent-linux -p rmm-agent
python3 tests/bootstrap.py
python3 tests/local_integration.py
```
Integration benötigt laufenden lokalen Compose-Server und gebaute Debug-Binaries.
Sie erstellt echte temporäre Geräte/Token, startet den nativen lokalen Linux-Agenten,
prüft Enrollment-Rennen, TLS-Fehler, RLS, Mandantentrennung, Heartbeat, Neustart und Widerruf.
Testgeräte werden anschließend widerrufen; Historie bleibt im Entwicklungsbestand.
Tests lesen **keine VM-Credentials** und ersetzen keine VM-/Dienstabnahme.
Stoppen ohne Daten-/Schlüsselverlust: `python3 deploy/dev.py down`.
Keine ungezielte Docker-Bereinigung verwenden; fremde Container bleiben unangetastet.
Rust und Lockdatei sind auf die vorhandene Toolchain **1.99.1** festgelegt.
Lokale Builds und isolierte Tests ergänzen die nativen Cloudnachweise.
Historische lokale Server-, Notebook-Agent- und Reverse-Tunnelanleitungen sind
keine aktuellen Startanweisungen; maßgeblich bleibt die dokumentierte Cloudtopologie.