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

119 lines
7.0 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
**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:**
```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.