Files
rust-discovery/docs/windows-feature-runtime-upgrade.md
T
2026-11-14 03:53:48 +01:00

85 lines
5.2 KiB
Markdown

# Optionale IPC-Clientfunktion identitätserhaltend ausrollen
Stand 2026-11-14: Der neue Runner
`deploy/windows/runtime_feature_upgrade.py` ist **implementiert, neu nativ
qualifiziert und auf der bestehenden Windows-VM erhaltend ausgeführt**.
`runtime_upgrade.py` und seine abgeschlossenen historischen Fälle bleiben
unverändert. Die frühere native Default-/Helperunit-Abnahme ersetzt nicht die
neue Featureabnahme.
Der Runner erlaubt ausschließlich den belegten Übergang vom bisherigen passiven
Agentbinary `f64e81155a4d86089a9dd7e6ec42ffba50b939442386c3187a28769a4de1aa0b`
zu einem neuen Build mit `system-helper`. Er liest den maßgeblichen
`current-runtime.json` samt unveränderlichem tatsächlichem Upgradebeleg und
vergleicht vor der ersten Wirkung Image, öffentliche Identität, Konfiguration,
ACLs und Metadaten des unexportierten Geräteschlüssels. Die ursprüngliche
Sechsfeldkonfiguration und automatische WSS-/HTTPS-Auswahl bleiben erhalten.
Helper, Pin, Jobs, Uhr- oder Serverpolicy werden dabei nicht installiert/aktiviert.
Der neue Quell-/Artefaktmanifest bindet auch `helper_runtime`, `helper_ipc`,
`helper_system`, die Helperbinaryquelle und den unabhängigen Shared-Core-Helper.
`build-local` verlangt die weiterhin geschlossene Produktionsuhr, baut offline
und führt Clippy mit `-D warnings` aus. Der Eltern-Orchestrator führt anschließend
`qualify-native` aus: Alle genau 21 neu gebauten Bibliotheks- und sechs Binarytests
müssen auf der Windows-VM bestehen. Die tatsächlichen Artefakthashes und die
Windows-/Linux-Jobzähler sowie Policy-/Faultflags werden davor und danach
verglichen. Das sind Administrator-Bootstrap-Units, kein laufender SYSTEM-Dienst
und kein positiver Pipebeleg.
Die native Upgradephase benutzt einen eigenen create-only Namensraum
`runtime-feature-{UUID}` mit `runtime-feature-active-intent.json`. Sie überschreibt
den alten V1-Intent nicht. Das feste PowerShellverfahren wird mit engen,
eindeutigen Ersetzungen aus der erhaltenen V1-Quelle abgeleitet. Es erhält
Datenbankidentität, ursprüngliche Tabellen, unbestätigte Telemetriebytes,
Sequenzkontinuität, Geräte-/Zertifikats-/CAidentität und ACLs. Vor Stop, Austausch
und Start stehen dauerhafte Intents. Nach einem unklaren SSH-Ausgang wird
`enter` nicht wiederholt; `finish` liest den tatsächlichen Zustand, ein Rollback
ist eine gesonderte ausdrückliche Aktion mit eigenem einmaligem Startversuch.
Erst nach zwei tatsächlichen WSS-Heartbeats, bestätigter Inventarübertragung,
Mandantengegenprobe und unveränderten Job-/Servergrenzen schreibt der Runner
`system_helper_client_feature=true` in Ergebnis und aktuellen Runtimeindex.
Der Indexwechsel prüft den erwarteten vorherigen Hash oder denselben bestehenden
Fall; ein fremder Übergang wird nicht überschrieben. Nach Rollback darf ein
historisches Feature-Ergebnis nicht als aktueller Zustand veröffentlicht werden.
Alle Finish-Aufrufe lesen das tatsächliche ausgewählte Image erneut.
Phasenfolge; tatsächliche Ergebnisse dieses Durchlaufs unten:
1. `runtime_feature_upgrade.py build-local`
2. `runtime_feature_upgrade.py qualify-native --manifest <neuer Manifest>`
3. `runtime_feature_upgrade.py upgrade-passive --manifest <derselbe Manifest> --qualification <neuer tatsächlicher Unitbeleg>`
4. Bei verlorenem Reply nur `finish --id <bestehender Fall>`; eine ausdrücklich
gewünschte Wiederherstellung verwendet `rollback --id <derselbe Fall>`.
5. Erst danach [den passiven SYSTEM-Helper installieren und die echte
LocalService-Pipeverbindung nachweisen](windows-system-helper-bootstrap.md).
Tatsächlich lokal ausgeführt: Python-Syntaxprüfung, PowerShell-Parser aller drei
abgeleiteten Quellstrings und vier gezielte Guards bestanden. Diese prüfen
exakte/eindeutige Ableitung, getrennten Namensraum, Ablehnung des alten
Defaultprofils als Featurequalifikation, aktuelle Zustandsprüfung nach Rollback
und CAS-Ablehnung eines fremden Runtimeindex. Keine VM-/Serveraktion und kein
RMM-Job wurde durch diese lokalen Prüfungen ausgelöst.
## Tatsächlich auf der Windows-VM ausgeführt
Neuer Buildmanifest `923aa4e8-d1e7-43fb-bffb-6450b2fe233f` bindet57 Quellen.
Lokaler Offline-Releasebuild und Clippy bestanden. Neuer eigener nativer Fall
`23b0e0aa-d5c5-433b-a025-53293d86c1a0`: alle21 Library- und6 Binarytests
bestanden, ohne Skip, als Bootstrapadministrator. Unverdrahtete MSI-/Eventlog-
Quellen sind dadurch nicht als native Provider qualifiziert.
Anschließend Fall `cea4d30f-06a1-4f80-b483-f8b1bb6b0899`: neues Agentimage
`2beed7fa…`, tatsächlicher LocalService-PID5140, Auto/WSS, ursprüngliche
Konfiguration/ACLs/Identität/Schlüsselmetadaten/Telemetrie-DB erhalten. Zwei
frische Heartbeats, konkretes Inventar-ACK und Fremdtenant-Verweigerung bestanden;
Windows0/0/0/0 und Linux30/30/26/0 erhalten. Der erste nachgelagerte Nur-Lese-
SSH-Aufruf lief in ein Timeout; ausschließlich `finish` desselben Falls wurde
wiederholt, kein zweiter Dienststart oder Binärtausch. Der aktuelle Index bindet
den tatsächlichen verifizierten Abschluss.
`system_helper_client_feature=true` bezeichnet den kompilierten optionalen
Client, keine SYSTEM-Aktionsfreigabe. Uhr und Jobs bleiben geschlossen; noch
kein Signingbinding/Verbrauchsledger/Jobsverzeichnis beim Netzwerkagenten.
Die tatsächliche Dienst-Pipeverbindung ist ein getrennter nächster Nachweis.