Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s

This commit is contained in:
2026-11-18 17:21:12 +01:00
parent f37b6dc4f7
commit 6963ad332c
188 changed files with 370 additions and 34933 deletions
+7 -45
View File
@@ -1,48 +1,10 @@
# Entwicklungsfenster für Windows Update
# Befristetes Windows-Updatefenster im Entwicklungsprofil
Auf dem per HTTPS aufgenommenen Windows-Testgerät läuft der Agent als LocalService. Das temporäre Wartungsfenster verwendet den SYSTEM-Helper desselben veröffentlichten Agentpaares. Die beiden zulässigen Skripttexte sind in der [Domain](../crates/domain/src/jobs.rs) festgelegt. Alle Anträge laufen über die reguläre Gerätewarteschlange und die sichtbare WebUI-Genehmigung.
Der reguläre Windows-Agent verwendet für administrative Skripte den dauerhaft eingerichteten [SYSTEM-Helper](../deploy/windows/README.md). Für den eigenen Windows-Testgast ohne bestehenden Helper gibt es zusätzlich einen Geräteoperator für die Identitätsprobe und die fest hinterlegte Updatevorlage. Er erwartet eine per HTTPS eingeschriebene Installation mit Enrollmentgeneration und Zuweisungsversion 1 sowie den registrierten Entwicklungszugang. Ein vorhandener Helper schließt das Öffnen eines neuen Fensters aus. [Operator](../tools/windows_update_scope.py)
1. Aus dem Checkout den angemeldeten Entwicklungsclient, seine laufenden Prozesse und den zentralen Zustand lesen.
1. Vom Entwicklungsrechner `python3 tools/windows_update_scope.py inspect` und `python3 tools/windows_update_scope.py plan` ausführen. Ziel, installierte Version und registriertes Agent-/Helperpaar abgleichen.
2. Für den konkret beauftragten Test `python3 tools/windows_update_scope.py window --minutes 15` starten und die ausgegebene Fall-ID festhalten. Der Controller prüft Gerätebindung und signierte Zeit, pausiert während des Fensters das Release-Polling und meldet `central_scope_open`, sobald die Regel bereitsteht.
3. Die zentrale Fensterregel gilt für den sichtbar simulierten Nutzer `simulated-testprincipal-a` in der privaten Entwicklungs-WebUI. Dort die festgelegte Bibliotheksrevision für genau dieses Gerät als SYSTEM einreichen und den festen Plan prüfen. Die Identitätsprobe `Write-Output ([System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value)` mit genau einem abschließenden LF liefert `S-1-5-18`. Dafür höchstens 30 Sekunden Laufzeit wählen. Die Vorlage „Windows-Updates installieren“ darf bis zu 3.600 Sekunden laufen. Die Fensterdauer zuvor passend zur voraussichtlichen Aktion wählen.
4. Nach dem terminalen Ergebnis den Controller mit Strg+C schließen oder die Ablaufzeit abwarten. Nach Unterbrechung mit `python3 tools/windows_update_scope.py close --case FALL-UUID` fortsetzen. Der Controller zieht die zentrale Regel zurück und baut den temporären lokalen Helper nach dem Abgleich zurück. Zum Schluss den laufenden Agenten, den Update-Dienst und einen frischen Geräteabgleich prüfen.
```sh
python3 tools/windows_update_scope.py inspect
python3 tools/windows_update_scope.py plan
```
2. Ein Fenster öffnen und den Befehl während der Wartung im Vordergrund laufen lassen.
```sh
python3 tools/windows_update_scope.py window --minutes 15
```
Der Befehl gibt die Fall-ID aus. Der Dev-Operator setzt die aktuelle HTTPS-Erstaufnahme mit Enrollmentgeneration 1 und Zuweisungsversion 1 voraus. Vor der ersten Geräteänderung speichert der Server die Fall-ID, den signierten Ausgangscheckpoint, beide Binärhashes und die ursprüngliche Richtlinie. Beim Öffnen prüft der Operator die signierte Paarversion, den laufenden Agenten und seine Gerätebindung. Nach einem passenden Geräte-Heartbeat und einer aktuellen signierten Helper-Uhr meldet der Operator `central_scope_open`. Ab dann steht die Richtlinie bereit. Die einzige zugelassene Bedienperson im Entwicklungsprofil ist `simulated-testprincipal-a`. Das Release-Polling pausiert während des Fensters. Die Ablaufzeit des Fensters steht in UTC in der Ausgabe. Ein anderes noch aktives SYSTEM-Fenster bleibt dem bisherigen Betreiber zugeordnet.
3. In der privaten WebUI das Windows-Gerät und die gewünschte gespeicherte Skriptversion wählen. Zur Prüfung der Identität eine Bibliotheksrevision für Windows PowerShell und Identität `system` verwenden. Der Skripttext ist die folgende Zeile mit genau einem abschließenden LF.
```powershell
Write-Output ([System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value)
```
Bei der Identitätsprobe höchstens 30 Sekunden wählen. Den unveränderlichen Plan prüfen, den Antrag absenden und in der sichtbaren dev/test-WebUI genehmigen. Erwartete Ausgabe ist `S-1-5-18` bei Exitcode 0. Die separate Katalogvorlage „Windows-Updates installieren“ darf bei einem entsprechenden Wartungsauftrag bis 3.600 Sekunden laufen. Sie meldet Updateergebnisse und den Neustartbedarf.
4. Nach dem Ergebnis mit Strg+C schließen oder die Ablaufzeit abwarten. Die Zentrale entzieht den Scope, der Controller wartet auf terminale Versuche, entfernt den temporären Helper und stellt die geschützte Agentkonfiguration wieder her. Endgültige Arbeitsprojektionen dieses Fensters werden unter ihrem ursprünglichen Job-/Grant-Schlüssel lokal archiviert. Zentrale Ergebnisse, Startnachweise, Signaturen und alte Checkpoints bleiben lesbar. Ein neuer Geräteabgleich darf denselben Job oder Grant nicht wieder annehmen. Er prüft LocalService, Release-Polling und den nachfolgenden Heartbeat ohne SYSTEM-Capability. Bei unterbrochener SSH-Verbindung oder einem abrupt beendeten Controller den Rückbau mit der angezeigten Fall-ID fortsetzen.
```sh
python3 tools/windows_update_scope.py close --case FALL-UUID
```
Die zentrale Richtlinie läuft auch bei Verbindungsverlust ab. Der lokale Helper hält den nächsten Agent-Paarwechsel bis zum abgeschlossenen Rückbau an. Ein noch laufender beziehungsweise ungeklärter Auftrag wird im regulären Auftragsablauf geklärt. Der Befehl zum Schließen kann anschließend erneut ausgeführt werden.
Die native Identitätsabfrage und der vollständige Rückbau sind im [Entwicklungsnachweis vom 17. November](evidence/windows-update-window-20261117.json) dokumentiert.
Derselbe `close --case` schließt eine abgebrochene Einrichtung, sobald die Fall-ID ausgegeben wurde. War der Helper schon synchronisiert, vergleicht der Controller den ursprünglichen und den aktuellen signierten Checkpoint mit den lokalen Journalen. Zum Abschluss müssen Agent und Release-Polling laufen und ein neuer synchroner Heartbeat ohne SYSTEM-Fähigkeiten vorliegen.
Die [native Abbruchabnahme](evidence/windows-update-early-abort-20261117.json) beendet den Controller nach dem ersten passenden authentisierten Helper-Heartbeat und vor dem Öffnen der Richtlinie. Auf einem freien Windows-Entwicklungsgerät lässt sich der Ablauf wiederholen.
```sh
python3 tests/windows_update_early_abort.py --execute
```
Auch nach einem abgebrochenen Test gibt der Befehl die Fall-ID aus, mit der sich der Rückbau fortsetzen lässt.
Die echte Installation von KB890830 v5.147 und der zugehörige administrative Wartungsneustart sind [nativ belegt](evidence/windows-update-installation-20261117.json). Dabei wurde der zuvor gestoppte Windows-Zeitdienst aktiviert und eine gemessene Zeitabweichung korrigiert. Native CP850-Ausgabebytes bleiben unverändert erhalten. Die WebUI bietet für native PowerShell-Ausgabe eine CP850-Textansicht mit expliziter Dekodierungswahl. Der Umlaut im gespeicherten Updateergebnis und der bytegleiche Download wurden im Browser geprüft. [Darstellungsnachweis](evidence/powershell-output-encoding-20261117.json)
Bei ungeklärtem Versuch den vorhandenen Auftrag und seinen Nachweis prüfen. Ein noch laufender oder ungeklärter Versuch kann den Rückbau anhalten. Die Fall-ID erlaubt es, denselben Rückbau fortzusetzen. [Wiederanlauf nach Abbruch](evidence/windows-update-early-abort-20261117.json) · [Native Installation](evidence/windows-update-installation-20261117.json)