Files
rust-discovery/docs/reboot-acceptance.md
T
2026-11-13 19:49:12 +01:00

7.0 KiB
Raw Blame History

Letzte Linux-Cloud-VM-Rebootabnahme

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. Der Beleg muss bei erstmaliger Abnahme außerdem jünger als fünf Minuten sein; 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:

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.