docs: consolidate actual M0 to M4 evidence and remaining MVP scope
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user