Files
rust-discovery/docs/reboot-acceptance.md
T
2026-11-13 22:14:44 +01:00

204 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Letzte Linux-Cloud-VM-Rebootabnahme
## Tatsächliche Originalabnahme und Schließung bestanden
Originaljob8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa jetzt **succeeded/revision3**,
genau ursprünglicher Grant25a4bf3f-772c-487d-825d-73bcbbc418fd. Neuer Boot
45aba743-be1d-4ae5-ba00-139fb9363bfe unabhängig nachgewiesen; ursprünglicher
Inventarbeleg1cf6146c-15fb-491f-a35a-8c4a0bb8f679 tatsächlich20:28:40.877951UTC,
innerhalb unveränderter180Sekunden ab20:26:12.430245UTC. Separater frischer
Sameboot-Belegc8214203-04e8-4c75-9aa3-7a786bf64692 empfangen21:11:02.272955UTC.
Genau ein tatsächliches `reboot_postcondition_verified`-Audit bindet beide IDs/
Zeiten und gleichen Job/Versuch/Grant/Boot/Generation. Normaler signierter
Sync Generation103 von Agent UND Helper angewandt, beide ready, restore_blockedfalse.
Root18/0offen/0Faults, keine sonstigen offenen Agentversuche, alle17alten
Verbrauchszeilen und drei DBinodes erhalten. Einmalige tatsächliche simulierte
WebUI-Genehmigung, proJob1/1/1, keine zweite Wirkung.
Danach zentrale Rebootpolicy deny-only geschlossen und **exakt ursprüngliche**
General-Konfigurations-/Pinbytes mitallow_rebootfalse wiederhergestellt.
Private `result.json` und `closed.json` jeweils verifiedtrue. Altebefore.json,
Checkpoint und ursprüngliche Artefaktpins blieben unverändert; separater
hashgebundener capacity-upgrade.json qualifiziert lediglich den erhaltenden
storage-onlyArtefaktaustausch auf9e9f/d6fb. [Kapazitätsnachweis](journal-capacity.md).
Der ursprüngliche BootfehlerCLOCK_UNTRUSTED/Restart=no bleibt realer Befund.
Danach enge Konfigurationskorrektur nativ bestanden: nur Restart=no durch
Restart=on-failure/RestartSec=5 ersetzt. Kontrollierte fehlende Konfigurationsdatei
ließ Helper vor Ledgeröffnung mitExit1 scheitern, tatsächlichesNRestarts1
belegt. Exakter temporärer Override entfernt; **ohne zweiten Start-/Restart-
befehl** lief derselbe Helper automatisch stabil (NRestarts2/active). Agent
während dieser Bootstrapprobe gestoppt; alleRoot18-Verbrauchszeilen/DBinodes/
RootDBbytes, Identitäten, Schlüssel, Policies und Binärdateien erhalten. Keine
Job-/Paketwirkung, keinOSreboot; eigenesRollbacktimer entfernt nur exakten
Probeoverride und wurde nach Erfolg gestoppt. Private startup-retry-{intent,
preflight,apply-intent,result}.json, Ergebniscompleted/automatic_recovery/
state_preservedtrue. Tatsächliche GeneralUnitSHA jetzt
104a7d6f01ec79aa2d6730f098e433418ce3bd04fc180fc4847dc94d873bb5a7.
Dies belegt automatische Retry-/Recoverywirkung nach Startfehler; kein weiterer
OSboottest nach Unitkorrektur wurde ausgeführt. Noch APT-Messungsrequalifikation,
MCP-Endbericht und Endaudit erforderlich.
## Historischer Zwischenstand vor endgültigem Abschluss
Der einzelne feste WebUI-Job8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa mit
Grant25a4bf3f-772c-487d-825d-73bcbbc418fd wurde tatsächlich einmal ausgeführt.
Neue Boot-ID45aba743-be1d-4ae5-ba00-139fb9363bfe statt
603e9280-801d-403e-bbfe-7340784e000a, zentrale Reservierung20:26:12.430245UTC,
Originalfrist20:29:12.430245UTC. Tatsächliche neue Bootinventare
6f5bd8a6-a33b-4e45-a102-63d43e12c23d um20:27:40.878097UTC und
1cf6146c-15fb-491f-a35a-8c4a0bb8f679 um20:28:40.877951UTC sind rechtzeitig.
Kein zweiter Neustart ist autorisiert oder vorgesehen.
Noch **unknown**, nicht abgenommen: General scheiterte beim Boot an
CLOCK_UNTRUSTED/Restart=no. Nach realer Uhrbereitschaft derselbe Helper
operativ gestartet. Spec1.14/Zwei-Beleg-Serverfix unter Candidate7be1f330
nativ erhaltend deployt, drei isolierte PostgreSQL-Tests/Clippy/Format bestanden.
Originalfrist, alte Daten/Grants/DBinodes und UI blieben erhalten. Erneuter
Finishleselauf konnte noch keinen signierten Erfolg belegen. Seitdem
Rootjournal268414976Bytes nahe256MiB, keine neuen Helpercaptures/Agentrequests.
Agent für begrenzte Kopiediagnose angehalten; keine Ledgerbereinigung.
MVP bleibt offen. Private Belege im unten genannten festen Fallordner,
zusätzlich proof-upgrade-{before,deployed,resumed}.json und
reconcile-diagnostic-quiesced.json.
Die folgenden Vorbereitungsabschnitte und Formulierungen „noch nicht ausgeführt“
sind historische Vorstufen, kein aktueller Wirkungsstand.
Vor dem tatsächlichen Reboot neun bereits verifizierte frühere Gates an feste
JSON-/SHA-Referenzen gebunden. Root17/0offen/faultfrei, Zentrale29/29/25/0,
Agent/General aktiv+enabled, APTinactive/disabled und Endpunkt entfernt.
Zusätzliche tatsächliche Bootprüfung fand den **inaktiven, aber enabled**
historischen`rmm-helper-dev-test.service`, der denselben Root-StateDirectory
verwendet. Vor dem Reboot ausschließlich dessen Autostart deaktiviert, kein
Dienststart/-stop/-restart. Tatsächliche Root-ownedUnit/Binärpfad/Shared-State-
Metadaten zuerst geprüft; bestehende Anpassung`SystemCallFilter=adjtimex`
erklärt Abweichung vom Repo-UnitSHA. CAS mit unabhängig gelesenen tatsächlichen
Unitbytes, keine Änderung dieser Unit oder ihrer Konfiguration. Vor/nach
Disable gleicher Boot, aktuelle PIDs, drei DBinodes und Root-Verbrauchszeilen.
Private Belege unter`devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/`
mit`pre-reboot-unit-state.json`, `legacy-unit-metadata.json` und
`legacy-autostart-disabled.json`. Noch keine OS-Rebootwirkung durch diese
administrativen Vorbereitungen.
**Vorbereitet, noch kein nativer Reboot ausgeführt.** Dieser Schritt darf erst
nach den APT-, Offline-, Crash-/Redelivery-, Transportfallback- und MCP-Gates
folgen. Die frühere Autorisierung des einzelnen Test-VM-Reboots ersetzt keine
Genehmigung des neuen festen Jobs in der tatsächlichen WebUI.
## Verbindliche Bedeutung der Wiederverbindungsfrist
Der feste Reboot-Plan nennt `reconnect_timeout_seconds`. Seine zentrale Frist
beginnt bei `execution_permits.created_at`, der dauerhaft gespeicherten
serverseitigen Startreservierung des **gleichen Jobs, Versuchs und Grants**.
Dieser Zeitpunkt liegt vor dem tatsächlichen Helperstart. Die Verwendung ist
bewusst konservativ: Ein späterer lokaler Start oder lokal gespeicherter
`reconnect_deadline` verlängert die zentrale Frist nicht. Gerätezeitstempel,
neue Verbindungsversuche und neue Inventare verlängern sie ebenfalls nicht.
Erstmaliger Erfolg braucht einen tatsächlich gespeicherten Inventarbeleg
derselben Identität und des aktuellen neuen Boot-IDs. Dessen serverseitige
Empfangszeit muss **nach** der Startreservierung und **spätestens zur Frist**
liegen. Bei später als fünf Minuten erfolgender Erstverifikation braucht der
unveränderliche rechtzeitige Originalbeleg einen zusätzlichen, unabhängig
empfangenen aktuellen Sameboot-Beleg jünger als fünf Minuten und den aktuellen
authentisierten Geräte-/Generationskontext. Beide tatsächlichen IDs und
Empfangszeiten werden im signierten Ergebnis und Audit gebunden. Ein erst
verspätet empfangener Originalbeleg bleibt verweigert. Die alte Boot-ID muss aus dem zum gleichen Grant gehörenden
`start_reserved`-Audit stammen und vom neuen Boot abweichen. Fehlende oder zu
späte Belege bleiben `unknown`; daraus entsteht weder ein geratenes `failed`
noch eine Wiederholungserlaubnis.
Ein bereits autoritativ bestätigter Erfolg behält seinen **ursprünglichen
konkreten Inventarbeleg**. Späterer RootSync darf dessen rechtzeitige, dauerhaft
gespeicherte Empfangszeit erneut prüfen, auch wenn die aktuelle Uhrzeit inzwischen
hinter der Frist liegt. Ein jüngeres, verspätetes Inventar darf diesen Beleg nicht
ersetzen. Neue Boot-ID und tatsächliche aktuelle Identität müssen weiter passen.
Exakte Nachrichtenwiederholung verwendet die bestehende Quittung.
Auch ein eingehendes Reboot-Erfolgsergebnis muss denselben unabhängigen
Grant-/Boot-/Inventar-/Fristnachweis besitzen. Vom Client gelieferte Zeitangaben
oder eine behauptete Inventar-ID reichen nicht. Die Ergebnisfelder
`reboot_reserved_at`, `reconnect_deadline` und `inventory_received_at` müssen zu
den tatsächlichen Datenbankzeitpunkten passen. Der unveränderte Helper prüft
weiter den signierten Abgleich und den tatsächlich neuen lokalen Boot-ID.
## Tatsächlich ausgeführte lokale Prüfung
Die gezielte Serverprüfung verwendete einen eigenen PostgreSQL-Container ohne
Netzwerkfreigabe, Migrationen 1–13 und die nicht privilegierte Anwendungsrolle
mit RLS. **Drei Tests bestanden**, keine ausgelassen:
- Frist ausschließlich aus gültigem festem Plan und vorhandener Reservierung;
fehlende Reservierung, ungültiger Timeout und Zeitüberlauf werden verweigert.
- Tatsächliche SQL-Auswahl: Grenze einschließlich akzeptiert, eine Mikrosekunde
zu spät verweigert; falscher Mandant/Agent/Boot, Belege vor Reservierung,
Zukunft und veraltete Erstabnahme verweigert. Der ursprüngliche rechtzeitige
Erfolgsbeleg bleibt später wiederverwendbar.
- Tatsächlicher Ergebnis-Ingress mit ausschließlich synthetischen isolierten
Datenbankzeilen: verspätete behauptete Erfolgsnachricht und erfundene Frist
zurückgewiesen, Job bleibt `unknown`, keine Quittung. Rechtzeitiger unabhängiger
Beleg akzeptiert; exakte Wiederholung erzeugt keine zweite Quittung.
Dies ist ein lokaler Server-/Datenbanknachweis und **keine native Rebootabnahme**.
Helper-/Providerartefakte, VM-/Serverlaufzeit und Systemuhren wurden für diese
Prüfung nicht verändert. Die einmalige echte positive Rebootabnahme folgt erst
nach den vorherigen MVP-Gates und ihrer eigenen WebUI-Genehmigung.
## Vorbereiteter Cloud-Runner, noch nicht ausgeführt
`deploy/cloud_reboot_acceptance.py` und
`deploy/browser/cloud_reboot_acceptance.cjs` bilden ausschließlich den letzten
einzelnen Reboot ab. Vorher müssen APT-Abnahme und beide 1.1-Noops, die drei
aktiven Offlinefälle, Crash-/Redelivery, tatsächlicher Transportfallback und
MCP-Isolation nativ bestanden sein. Ein geschütztes Manifest enthält
`schema_version:1`, den festen `target` und `checks` für `apt_native_update`,
`ensure_package`, `apply_updates`, `offline_wait`, `expired_offline`,
`revoked_before_start`, `agent_crash`, `transport_fallback`, `mcp`. Jeder Eintrag
bindet einen geschützten tatsächlich verifizierten Ergebnisbericht über `path`
und `sha256`. Fixture 1.1 wird aus den früher genehmigten gespeicherten
APT-Ergebnissen geprüft; keine neue SSH-Paketabfrage wird als Nachweis ausgegeben.
Vor der Vorbereitung müssen die dauerhaften Agent-/General-Helperdienste bereits
aktiv und dauerhaft `enabled` sein. Der Runner aktiviert keinen Autostart
stillschweigend. Der APT-Endpunkt muss nach dessen Abnahme wieder entfernt und
sein Dienst gestoppt sein. Die vorhandene General-Unit bleibt unverändert:
`systemctl reboot` verwendet den vorhandenen D-Bus-Provider, direkte
Reboot-Syscalls bleiben gesperrt. Diese Quellcodeprüfung ist noch kein nativer
Rebootnachweis.
Bootstrap ändert lediglich `allow_reboot` von false auf true und den zugehörigen
gemessenen General-Pin, unter gestoppten Diensten und Executor-Lock. Originale
werden versioniert; Identitäten, Journale, DB-Inodes, alte Grants und APT-Historie
bleiben vor Neustart bytegleich. Zentral gilt nur eine maximal 30 Minuten gültige
Scope für Reboot; Skripte, Dienste, APT und zusätzliche Logrechte sind verboten.
Bootstrap selbst ruft keinen Reboot auf.
**Geplant, nicht ausgeführt:**
```sh
python3 deploy/cloud_reboot_acceptance.py enable --prerequisites devstate/cloud-reboot/prerequisites.json
python3 deploy/cloud_reboot_acceptance.py accept --id <Lauf-ID>
python3 deploy/cloud_reboot_acceptance.py close --id <dieselbe-Lauf-ID>
```
`accept` erstellt und beantragt genau einen festen Root-Job über die tatsächliche
WebUI, beweist `pending_approval` mit **0/0/0** und öffnet erst danach eine eigene
WebUI-Genehmigungssitzung. Der Job nennt den ausdrücklichen Grund, Gruppe
`single-test-vm`, Parallelität 1, Laufzeit 240 s und Wiederverbindungsfrist 180 s
ab zentraler Startreservierung. Alte Boot-ID und unveränderlicher Plan werden
vor Genehmigung gespeichert. Kein SSH-Reboot oder direkter Freigabeaufruf existiert.
Erst tatsächliche ausgehende Wiederanmeldung, neuer Boot-ID, rechtzeitig
gespeichertes Inventar, angewandter signierter RootSync und terminaler Erfolg
bestätigen den gleichen Grant. Alte Ledgerzeilen und DB-Inodes müssen erhalten
sein; genau ein neuer Rootverbrauch sowie **1 Job / 1 Outbox / 1 Grant** sind
erforderlich. Unterbrochenes Warten darf ausschließlich `finish --id` für diesen
gleichen Versuch fortsetzen. Unknown oder Timeout erlauben keinen zweiten Reboot.
Nach normal bestätigter Rückkehr schließt `close` zuerst die zentrale Scope und
stellt dann die ursprünglichen Config-/Pinbytes mit `allow_reboot:false` wieder
her. Diese operative Rücknahme startet Agent und General-Helper neu, führt aber
keinen zweiten Reboot aus. Tatsächliche Durchführung bleibt bis zur Freigabe des
abschließenden Schritts ausdrücklich offen.