71 lines
13 KiB
Markdown
71 lines
13 KiB
Markdown
# Lieferplan für Skriptverwaltung, Installation und Agentupdates
|
|
|
|
**Abschlussstand 17. November 2026. Echte Windows-Updates und der Wiederanlauf nach frühem Abbruch sind nativ abgenommen.** Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md)
|
|
|
|
## Produkt und Betriebsstand
|
|
|
|
| Funktion | Im Entwicklungssystem nachgewiesen | Nächster Schritt oder Beleg |
|
|
| --- | --- | --- |
|
|
| Server, WebUI und MCP | Dedizierter ARM64-Server mit TLS, getrenntem Gateway und privater Verwaltung. Die WebUI genehmigte je eine feste Skriptrevision auf Linux und Windows. MCP und WebUI lieferten dieselbe Ausgabe und dieselbe Versuch-ID. | [Ergebnisse beider Geräte](evidence/script-library-acceptance-20261117.json) |
|
|
| Linux- und Windows-Client | Auf beiden Gästen HTTPS-Polling mit mehreren echten Kontakten. Ein Leerlaufkontakt übermittelt Inventar und Heartbeats auch bei leerer Auftragsliste. | [Bereinigung und Geräteabgleich](evidence/dev-cleanup-pull-20261117.json) |
|
|
| Skriptbibliothek | Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. Die Windows-Update-Vorlage ist enthalten. | KB890830 v5.147 über den festen SYSTEM-Bibliotheksauftrag installiert. [Installationsbeleg](evidence/windows-update-installation-20261117.json) |
|
|
| Veröffentlichung und Erstaufnahme | Auf dem dedizierten Server liegen signierte Linux- und Windows-GNU-Releases. Beide öffentlichen Installer wurden mit einem per WebUI erzeugten Einmalcode auf den Testgästen erfolgreich ausgeführt. | Regulärer PowerShell-Auftrag auf dem frisch aufgenommenen Windows-Gerät mit Exitcode 0. |
|
|
| Selbstupdate | Linux wechselte auf `0.1.0-mvp.2`, der frische Windows-GNU-Client nach seinem Skriptauftrag auf `0.1.3` und anschließend `0.1.4`. Prozesshash und Geräteidentität wurden nativ geprüft. | [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows](evidence/windows-https-release-20261117.json) |
|
|
| Entwicklungsbereitstellung | Linux-, Windows- und ARM64-Builder nutzen feste Git-Revisionen. SSH-Staging prüft den übertragenen Hash. Der Serverrunner prüft laufende Binärdatei, Migrationen, beide TLS-Healthchecks und die ausgelieferte WebUI. | Siehe [Entwicklungsbefehle](development.md). |
|
|
|
|
## Schritt für Schritt
|
|
|
|
### 1 · Geräte im Leerlauf und unter Pull betriebsbereit machen — auf den Testgästen nachgewiesen
|
|
|
|
1. Der ausdrücklich benannte Windows-Entwicklungsantrag zu Job `7d756c34…` wurde mit Plan, Operation, Grant und Outbox gelöscht. Ein zweiter Versuch `5007cbd9…` ist zentral korrekt abgelaufen. Der Server hatte dafür keinen Grant ausgegeben. Die veraltete lokale Ergebnisnachricht blockierte das Replay. Beide Projektionen wurden auf dem Gast bereinigt, beide Dienste wieder gestartet.
|
|
2. Gerätesperre, Parallelquoten und Rollout zählen `closed_unknown` als abgeschlossen. Ein offenes `unknown` mit Reservierung hält die Sperre. Bei abgelehntem Start behandelt die neue Agentversion nur eine explizit an genau den unreservierten Versuch gebundene Antwort als erneut planbar. Vor einem neuen Abruf durchläuft der Agent den signierten Abgleich. Die Regression einschließlich vertauschter Versuchs-ID und mehrdeutiger Ablehnung wurde im gemeinsamen Agentkern getestet.
|
|
3. Auf Linux wurden 81 veraltete Kontroll-Captures ohne zugehörige Entscheidung entfernt. Danach wurden die 3.961 vorhandenen Snapshots bytegenau in eine Darstellung mit geteilten identischen Versuchsdaten überführt. Die Transaktionen prüften jeweils den vollständigen Rücklesewert. Die Freiliste stieg von 51 auf 113.176 Seiten bei 4 KiB pro Seite, SQLite `quick_check` ergab `ok`. Entscheidungsdaten wachsen weiterhin mit der Zahl der Abgleiche.
|
|
4. Nach der Bereinigung meldeten beide Gäste am 17.11. gegen 14:51 UTC wiederholt `https`, `sync_ready=true` und `helper_sync_ready=true`. Die Windows-Uhr war beim nativen Nachtest qualifiziert. Bereits vorhandene Abnahmen für einzelne Skripte stehen unter [Linux](script-console-linux-full-results.md) und [Windows](windows-general-script-acceptance.md).
|
|
|
|
### 2 · Ein Bibliotheksskript von der Anlage bis zum Ergebnis liefern — auf beiden Entwicklungsgeräten abgenommen
|
|
|
|
„Linux-Kernelversion“ und „Windows-PowerShell-Version“ wurden je als v1 geplant, anschließend als v2 geändert und als v1 in der sichtbaren dev/test-WebUI genehmigt. Vor dem Klick gab es je null ausführbare Jobs, danach je einen. Die Testgeräte lieferten `Linux 6.8.0-149-generic` und `PowerShell 5.1.26100.9818` mit Exitcode 0. Die Ausgaben und Versuch-IDs stimmen in WebUI und MCP überein. Fremdmandant über MCP abgewiesen. Die Updatevorlage wurde hierbei nicht ausgeführt. [Nativer Beleg](evidence/script-library-acceptance-20261117.json)
|
|
|
|
### 3 · Windows-Updates als Bibliotheksfunktion abbilden — Vorlage und administrative Skriptstrecke geprüft
|
|
|
|
„Windows-Updates installieren“ ist eine versionierte PowerShell-Vorlage im serverseitigen Katalog. Sie verwendet die Windows Update Agent API, protokolliert die Ergebnisse je Update und meldet den Neustartbedarf. Der feste Plan bindet Skriptinhalt, Ziel, SYSTEM-Rechte und Zeitlimit. Nur für die freigegebene Vorlagenrevision kann die gesonderte Wartungsrichtlinie bis zu 3.600 Sekunden zulassen. [Vorlagentext](../crates/domain/src/windows_update.ps1) · [Laufzeitprüfung](../crates/domain/src/jobs.rs)
|
|
|
|
Der Windows-Installer richtet den Agenten als LocalService ein. Der [Dev-Operator](windows-update-dev-window.md) richtet für die konkrete Geräteidentität und das signierte Agentpaar ein befristetes Wartungsfenster ein. Auf Windows `0.1.4` wurde die feste lesende Identitätsabfrage über die sichtbare dev/test-WebUI genehmigt und als regulärer Pullauftrag genau einmal mit Exitcode 0 und `S-1-5-18` ausgeführt. WebUI und MCP zeigen denselben Versuch. Anschließend wurden der zentrale Scope entzogen, der lokale Helper entfernt und die exakt gebundenen abgeschlossenen Arbeitsprojektionen archiviert. Ein neuer Geräteabgleich bestätigte um 16:08 UTC `sync_ready=true` ohne SYSTEM-Capability, bei laufendem Agent und Updatedienst. Am 17. November installierte der separat genehmigte Auftrag KB890830 v5.147 mit Exitcode 0, WUA-Resultcode 2 und HRESULT 0. Das Windows-Systemprotokoll bestätigt Ereignis 19. Ein bereits vorher erforderlicher Neustart wurde administrativ ausgeführt und anhand der neuen Bootzeit bestätigt. Danach waren WUA- und CBS-Neustartmarker gelöscht. [Echte Installation](evidence/windows-update-installation-20261117.json) [Nachweis für Einrichtung, Ausführung und Rückbau](evidence/windows-update-window-20261117.json)
|
|
|
|
### 4 · Signierte Binaries zentral veröffentlichen — im Entwicklungsmandanten nachgewiesen
|
|
|
|
Jeder Plattformkanal besitzt einen eigenen Ed25519-Schlüssel. Agent und Helper werden mit ihren exakten Hashes vor Veröffentlichung geprüft. Der anfangs erforderliche stabile Updater ist separat an den plattformspezifischen Bootstrap-Hash gebunden. Für Linux und Windows GNU wurden je zwei Versionen über die reguläre Verwaltungs-API veröffentlicht. [Veröffentlichungsbefehl](development.md)
|
|
|
|
### 5 · Über öffentliches HTTPS aufnehmen — beide Plattformen nativ aufgenommen
|
|
|
|
Die [Linux-](https://discovery.ease-technologies.de:8443/install/linux.sh) und [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) sind über die öffentliche Zertifikatskette erreichbar. In der privaten WebUI erzeugte Einmalcodes wurden jeweils beim Enrollment verbraucht. Auf den vorhandenen Testbetriebssystemen entstanden neue Produktidentitäten. Linux läuft als `rmm-discovery`, Windows als LocalService. Der Notebook-Host ist weiterhin ausschließlich Entwicklungsrechner.
|
|
|
|
### 6 · Automatischen Versionswechsel auf dem Gerät prüfen — beide Plattformen nativ nachgewiesen
|
|
|
|
Das über den Installer neu aufgenommene Linux-Gerät `dda2c891…` führte die freigegebene Bibliotheksrevision mit Exitcode 0 aus. Der systemd-Timer aktivierte am 17.11. um 15:06 UTC den Release `0.1.0-mvp.2`. Der SHA-256 des über `/proc` geprüften laufenden Agenten und der Helperdatei stimmen mit dem signierten Manifest überein. Enrollmentgeneration und Geräteidentität blieben gleich. [Vollständiger Beleg](evidence/linux-public-installer-update-20261117.json)
|
|
|
|
Windows-A meldete sich mit neuer Identität `1626b5a3…`, Version `0.1.0` und gültigem `windows.base`. Der reguläre Updaterdienst aktivierte um 15:10 UTC Version `0.1.1` mit derselben Identität. Die Manipulationskontrolle wies eine um ein Byte veränderte Helperkopie ab. Das neu aufgenommene Windows-GNU-Gerät `858a27db…` mit Prüfer v2 führte unter `0.1.2` die PowerShell-Bibliotheksrevision erfolgreich aus. WebUI und MCP bestätigen denselben Versuch und Exitcode 0. Beim ersten nachfolgenden Abruf lagen die geprüften Dateien bereits auf dem Gast. Eine Windows-Dateisperre verhinderte zunächst das atomare Umschalten. Der stabile Updater wurde über den direkten Entwicklungsweg korrigiert und mit dem wiederverwendbaren Repo-Befehl übernommen. Anschließend aktivierte er um 15:45:22 UTC selbstständig `0.1.3`. Der Prozesshash stimmt mit dem signierten D-Paket überein, beide Dienste laufen und die Geräteidentität ist gleich. Der nächste reguläre Abruf aktivierte um 15:50 UTC auch `0.1.4`, wiederum mit Hash- und Gerätekontrolle. [Nativer Windows-Beleg](evidence/windows-https-release-20261117.json)
|
|
|
|
### 7 · Lieferung von einem frischen Checkout nachvollziehen — geprüft und im Lieferbranch gesichert
|
|
|
|
Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der Rustserver offline mit dem Lockfile gebaut. Releasewerkzeug, SSH-Staging und Deploymentrunner sind im Checkout vorhanden. Fünf Linux-Installerregressionen sowie die Release-, Mandanten-, Token- und Rotationstests gegen einen isolierten TLS-Server und echtes PostgreSQL 17 bestanden. Der Migrationsbenutzer ohne Superuserrechte wendete alle 25 Migrationen an. Der Direktweg für ein bereits gebautes WebUI-Bundle wurde zusätzlich auf dem Entwicklungsserver ausgeführt. [Befehle](development.md)
|
|
|
|
**Abnahme.** Ein zweiter Entwickler kann Build, Bereitstellung, Release, Erstaufnahme und Ergebnisabruf den dokumentierten Einstiegspunkten zuordnen. Für beide Geräte gibt es die Kette Installer → Leerlauf → Bibliotheksskript/Ergebnis → automatischer Versionswechsel. Bereits ausreichend belegte Schritte werden referenziert.
|
|
|
|
**Arbeitsverteilung.** Der Integrator bündelt die noch fehlenden Zielbelege. Künftige Teilaufträge bekommen jeweils einen konkreten Fehler oder ein gesondert beauftragtes Nutzerergebnis. Sie ändern getrennte Dateien oder stimmen gemeinsame Routen vorher ab. Bei einem Blocker die nächste fehlende Beobachtung hier im betroffenen Schritt eintragen. Abnahmeprotokolle liefern den Beleg, keine weitere Aufgabenliste. Zusätzliche native Provider, Relay/Terminal, RustDesk und Hypervisor-/Backupfunktionen liegen außerhalb dieser Lieferung.
|
|
|
|
|
|
## Fortsetzung nach dieser Lieferung
|
|
|
|
Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen.
|
|
|
|
Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte API-/Gatewayrevision ist `a799272`, Datenbankschema 25. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.4`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum.
|
|
|
|
### Wiederanlauf nach frühem Abbruch — nativ abgenommen
|
|
|
|
Der Controller wurde nach registriertem Helperkontakt vor der zentralen Freigabe mit Exitcode 85 beendet. Ein unabhängiger erneuter Aufruf stellte den normalen Geräteabgleich wieder her. Geräteidentität, Archivnachweise und Release blieben gebunden, die Probe erzeugte keine Aufträge. [Abnahme vom 17. November](evidence/windows-update-early-abort-20261117.json)
|
|
|
|
### Tatsächliche Updateinstallation — abgenommen
|
|
|
|
Der ursprüngliche Installationsversuch `6d5f9437…` wurde nach kurzzeitigem `unknown` durch den signierten Abgleich als `succeeded`, Revision 2 bestätigt. Es gab genau einen nativen Grantverbrauch und Start je Ledger, keinen weiteren Versuch. Das Wartungsfenster wurde anschließend geschlossen. Um 17:05 UTC liefen Agent und ReleasePull mit bereitem Sync, ohne SYSTEM-Fähigkeit und ohne offene Jobs. Die Windows-Zeitsynchronisation wurde aktiviert und ihre zuvor gemessene Abweichung korrigiert. Die WebUI erlaubt nun das feste 3.600-Sekunden-Budget der Originalvorlage auch in der gemeinsamen Planprüfung. Drei Python-Zeitstempelregressionen und 68 WebUI-Tests bestanden. [Gesamtbeleg](evidence/windows-update-installation-20261117.json)
|