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

5.2 KiB

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.

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.