85 lines
5.2 KiB
Markdown
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.
|