Files
rust-discovery/docs/script-console-cloud-upgrade-v1.md
2026-11-14 17:42:44 +01:00

231 lines
15 KiB
Markdown
Raw Permalink 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.
# Begrenzter Cloudserver-Nachfolger für Skriptkonsole 1.20
`deploy/cloud_script_console_upgrade_v1.py` ist eine neue, einmalige
Bereitstellungsquelle für den festgelegten ARM64-Cloudserver. Bestehende Runner,
Compose, Dockerfile, Ingress, Policies und Produktquellen werden nicht verändert.
Die Quelle ist lokal geprüft; ein echter Servercase, SSH-Aufruf, ARM64-Build,
Migrationslauf und eine Bereitstellung wurden damit noch **nicht ausgeführt**.
## Feste Quellen und Ausgangslage
- Frozen `run-29461892-343f-42f4-b469-88703535425e`, Manifest-SHA256
`ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd`:
alle 158 nachgewiesenen Compiler-/Vertragsdateien, einschließlich des
Full-Helper-Binarypins und Migration `0014_windows_msi_catalog.sql`.
- Zusätzlich separat gepinnte `deploy/Dockerfile`, `.dockerignore` und
`deploy/server.compose.yaml`: insgesamt **161 Dateien** in einem eigenen
ausgewählten Quellarchiv. Kein Live-Checkout als Buildkontext und kein
Überschreiben von `/opt/rust-discovery/crates` oder alten Quellen.
- Dockerfile-COPYs und produktive Includes sind enthalten: Cargo-Manifeste und
Lockfile, sämtliche Crates einschließlich OIDC-SQL, Migrationen, APT-Python,
Hook und eingebettete APT-Unit. Der bestehende `.dockerignore` filtert den
Kontext zusätzlich. Credentials, Devstate, Git, Target und Node-Module gelangen
nicht in diesen Kontext. Der ARM64-Build verwendet den unveränderten Dockerfile;
lokale x86-64-Binärdateien werden nicht als Serverruntime eingesetzt.
- Genau drei Dateien des bereits lokal geprüften Web49-Bundles. Index-SHA256
`95d6f9058cc713c6af36fbd22ccc60678f081765a853b53d19ac6f0d219804f8`,
JS-SHA256 `f611662042eb4cc44f25c7d5ddc0d2d0562e32be267d3d5fb1db31b0d310f879`,
CSS-SHA256 `916e8870d4e9a9553de452b3ff6c71671bb6a7a22355de0aff432db516a9f3e7`.
Der Nachfolger baut die UI nicht erneut.
- Erwartetes bisheriges Runtimeimage
`sha256:25697f948325a11f755893e16ec5be2da138c3333c8e60f75a18f973d6ac26e2`
aus dem dokumentierten 31278be-/9058f6a3-Stand. Dies ersetzt keine frische
Read-only-Baseline; ein anderer tatsächlicher Stand wird verweigert.
Das lokale Manifest bindet außerdem Runner, vollständige erzeugte Workerquelle,
beide SSH-Supportquellen, Quellarchiv, Webarchiv, alle Einzeldateien und die
SHA384-Checksummen der SQLx-Migrationen. Der bestehende geprüfte SSH-Key-/Hostkeyweg
wird wiederverwendet. `--access-root` bezeichnet nur den vorhandenen Hauptcheckout
mit geschützter `credentials/server.conf`; dessen Quellen werden nicht gebaut.
Ziel ist ausschließlich Root-Bootstrap auf 88.99.80.202 bzw. dessen festem Namen.
TLS verwendet dieselbe getrennte Vertrauenszuordnung wie die bestehenden
Compose-Mounts: API18443 mit Name `localhost` und
`devstate/api-pki/ca.pem`; Gateway18444 mit Name `localhost` sowie öffentlicher
Gateway443 mit Name `discovery.ease-technologies.de` und jeweils
`devstate/pki/ca.pem`. Der dokumentierte Server-SAN und die bestehende
Renewalquelle enthalten beide Namen. Keine CA wird kopiert, ersetzt oder
rekonfiguriert, und keine Zertifikats-/Namensprüfung wird abgeschaltet. Fehlendes
CA-Material verweigert den jeweiligen TLS-Aufruf; Status weist den Teilfehler aus
und erhält die übrigen Readbackdaten. `inspect` ist ausschließlich die beschriebene
Metadaten-/Datenbankbaseline und behauptet keinen TLS-Healthnachweis.
## Ablauf und Nachweise
`inspect` liest ohne Zielveränderung eine aktuelle Baseline. Sie enthält die
Runtimeimage-ID, alte API-/Gateway-/PG-Container, nur erlaubte nicht geheime
Rolleneinstellungen, Loopbackports, Mounts, den tatsächlichen PG-Volume-Pfad samt
Inode/Device und den alten UI-Indexhash. Compose/Dockerfile/Dockerignore und
Ingressunits werden gehasht. Für `.env`, PKI und Jobschlüssel werden nur
Dateimetadaten aufgenommen; private Inhalte werden nicht geöffnet. Für die
nicht geheime Rootpolicy werden zusätzlich der unten beschriebene feste Hash,
das Schema und die bereits abgelaufene Deny-all-Grenze geprüft. Die
Docker-Templateauswahl gibt nur ausdrücklich benannte nicht geheime Einstellungen
aus. Keine vollständige Containerumgebung gelangt in Python oder einen Bericht.
Die Datenbankprobe läuft als feste Read-only-Abfrage in einem konsistenten
Snapshot. Aus allen dauerhaften Plan-, Genehmigungs-, Job-, Outbox-, Permit-,
Receipt-, Audit-, Rollen- und Katalogtabellen verlassen nur Anzahl und
SHA256-Zeilenfingerprints PostgreSQL. Stabile Geräte-/Zertifikatsidentitäten und
die vollständige bestehende SQLx-Ledger 1–13 werden gebunden. Passive
Kontakt-/Synczähler und Beobachtungen dürfen fortschreiten. Bereits offene,
unbekannte oder laufende Jobs verweigern diesen Nachfolger.
`prepare` arbeitet ausschließlich lokal aus dem geprüften Archiv und der explizit
angegebenen Baseline. Ein neues privates Caseverzeichnis wird genau einmal
angelegt. Der Offline-Paketcheck ersetzt keine reale Linux-Abnahme.
`build` legt zuerst einen lokalen einmaligen Aufrufintent an. Auf dem Server
prüft der Runner erneut die vollständige Baseline, Migrationchecksummen und
unveränderte Deploymentkontrollen. Erst dann legt er den privaten Zielcase an,
schreibt Intent und Artefakte und startet einen festen systemd-Worker. Dieser
baut nativ für `linux/arm64` in seinem eigenen Kontext und einem neuen
`rust-discovery-server:script-v1-<UUID>`-Tag. Er verändert weder Runtime-Tag,
Services, Datenbank noch UI. Nach dem Build müssen Quellen und Baseline erneut
übereinstimmen; erst dann entsteht ein erfolgreicher Buildbeleg. Ein
prozessübergreifender Lock serialisiert die Worker dieses Nachfolgers; er ersetzt
keine Koordination mit älteren Deploymenttools.
`deploy` hat einen eigenen lokalen und entfernten Create-once-Intent. Der Worker
prüft alle Ausgangswerte und das tatsächliche erfolgreiche Candidateimage erneut.
Er hält API und Gateway kurz an; PostgreSQL und öffentlicher TCP-Ingress laufen
weiter. Nach dem Stop werden Historie, Container, PG-Volume und Index nochmals
gegen die Baseline geprüft; weitere Datenbank-Clientverbindungen sind unzulässig.
Dadurch können während der Migration keine normalen UI-/MCP-Schreibvorgänge oder
Agent-Jobstarts stattfinden. Ein rootprivates `pg_dump` und der alte Index werden
vor der Migration erhalten. Backupinhalte werden nicht zurückgegeben.
Die feste Reihenfolge ist:
1. Vollständiges Webarchiv vor jedem Publish prüfen; neue Hashassets create-only
ablegen. Existierende gleiche Hashdateien müssen exakt dieselben Bytes haben.
Alter Index, alte Assets und der bindgemountete Dist-Verzeichnisinode bleiben.
2. Runtime-Tag einmal auf die feste Candidateimage-ID setzen. Genau einen
Migrationscontainer mit festem Case-Namen starten und erhalten, auch bei
Fehlern. Keine automatische Entfernung oder zweite Migration.
3. SQLx-Zeilen 1–13 müssen vollständig unverändert sein; ausschließlich Version14
mit erwarteter SHA384 darf hinzukommen. Sämtliche ursprünglichen
Historienfingerprints und Identitäten müssen unverändert bleiben. Der neue
MSI-Katalog ist leer, FORCE-RLS-geschützt, für `rmm_app` nur SELECT/INSERT und
mit aktivem Immutable-Trigger versehen.
4. Nur API und Gateway aus dem festen neuen Image starten. Verifizierte TLS-
Healthchecks und ehrliche private Authkonfiguration prüfen. Öffentlicher
Gateway liefert für UI, Login, Session, MCP und Verwaltungsrouten weiterhin404;
der Signierschlüssel verlangt weiterhin ein authentifiziertes Gerät. UID,
Ports, Mounts und geschlossene Root-/SYSTEM-/Faultgates müssen erhalten sein.
5. Erst nach diesen Backendnachweisen den bisherigen Indexhash abschließend
vergleichen und den neuen Index atomar veröffentlichen. Alle drei tatsächlich
privat über TLS ausgelieferten Dateien müssen ihre festen Bundlehashes haben.
Datenbank, geschützte Metadaten, PG-Volume und Rollen nochmals prüfen.
Nachweise werden als einzelne fsync-gesicherte, unveränderliche Phasenbelege
erhalten. `passed` entsteht ausschließlich nach den Prüfungen. Die Quelle erzeugt
keine Jobs, Genehmigungen, neuen Versuche, Katalogrezepte oder Policyfreigaben.
WebUI-Login/CSRF/Plangenehmigung bleiben normale Produktpfade; kein Login- oder
Approvaltoken wird für diesen Ablauf gelesen oder erzeugt. Die spätere native
Skriptabnahme braucht weiterhin MCP → pending ohne Ausführungsartefakte → echte
simulierte Dev/Test-UI-Interaktion → Ergebnis, zuerst auf der Cloud-Linux-VM.
## Geplante Bedienung, nicht ausgeführt
Nach Rootreview, aktuellem Frozen-/Linuxnachweis und gesicherter Ausgangslage:
```text
python3 deploy/cloud_script_console_upgrade_v1.py inspect --access-root /pfad/zum/hauptcheckout
python3 deploy/cloud_script_console_upgrade_v1.py prepare --baseline /pfad/zur/gespeicherten/baseline.json
python3 deploy/cloud_script_console_upgrade_v1.py build --id CASE --access-root /pfad/zum/hauptcheckout --execute-cloud-build
python3 deploy/cloud_script_console_upgrade_v1.py status --id CASE --access-root /pfad/zum/hauptcheckout
python3 deploy/cloud_script_console_upgrade_v1.py deploy --id CASE --access-root /pfad/zum/hauptcheckout --execute-cloud-deploy
python3 deploy/cloud_script_console_upgrade_v1.py status --id CASE --access-root /pfad/zum/hauptcheckout
```
Ein Aufruffehler oder verlorene Antwort erlaubt **nur `status` desselben Cases**.
Nicht `build`/`deploy` wiederholen, keinen neuen Case als Reparatur anlegen, keinen
Migrationscontainer entfernen und nicht pauschal auf das alte Image zurückrollen.
Readback funktioniert auch bei fehlendem oder nur teilweise hochgeladenem Case;
es erzeugt keine Zielpfade und startet keine Prozesse mit Wirkung. Neben den
erhaltenen Belegen liest es tatsächlich aktuelles Image, Historie, Container,
Kontrollmetadaten und privat ausgelieferte UI-Hashes. Einzelne Lesefehler werden
als solche ausgewiesen. Es repariert keinen Zustand.
Ein Fehler nach dem Service-Stop kann beide Rollen angehalten lassen. Ein Fehler
nach dem Tag-/Migrationswechsel kann bereits Schema14 bedeuten. Das ist ein
bewusst erhaltener unvollständiger Case für eine konkret geprüfte manuelle
Fortsetzung, keine automatische Wiederholung oder Datenbankrücksetzung. Ein
späterer Rollback muss insbesondere neu gespeicherte 1.20-Pläne berücksichtigen.
Die alten Quellen unter `/opt/rust-discovery` bleiben historisch erhalten. Der
neue Runtimebezug ist der Casekontext mit seinen Hashes, nicht die Behauptung,
dass dieser alte Checkout nun die laufenden Produktbytes darstellt. Ein späterer
Deploymentlauf muss diese tatsächliche Runtimebasis berücksichtigen.
## Tatsächliche lokale Prüfung und Grenzen
Python-Syntax und die erzeugte vollständige Workerquelle sind kompilierbar.
Ein ausschließlich temporäres, danach verworfenes Paket mit ausdrücklich
synthetischer Baseline enthielt exakt158Frozen+3Deploymentdateien sowie die drei
richtigen Webdateien. Alle Einzelhashes stimmen. Create-once verweigert den
zweiten Schreibversuch. Die tatsächliche CAS-Funktion verweigert unabhängig
veränderte Runtimeimage-, PG-Volume-, Migrations-, Jobhistorien-, Index-, Kontroll-
und Containerwerte. Die tatsächliche `status`-Funktion auf einem fehlenden Case
legt nichts an und startet keinen Unterprozess. Frozen158 blieb unverändert.
Beleg: `devstate/script-console-cloud-upgrade-v1-local-review/guards.json`.
Die vorhandene Compose-CLI-Hilfe wurde tatsächlich lokal gelesen; insbesondere
wird das dort bei `run` nicht vorhandene `--no-build` nicht verwendet. Es wurden
keine SQL-Abfragen gegen eine echte Datenbank und keine Cloudaktionen durch den
Ersteller dieses Nachfolgers ausgeführt. Die SQL-, ARM64-, Stillstands-, Backup-,
Migrations-, Ingress- und tatsächlichen UI-Nachweise sind **noch offen** und
werden erst durch den echten Case belegt. Produktions-OIDC, Clientinstallation,
Fullprofileaktivierung und eine native Skriptwirkung sind keine Ergebnisse eines
Serverbuilds oder dieser Bereitstellung.
### Tatsächlicher Inspect-Befund und erhaltene Rootschließung
Beim ersten durch den Hauptagenten ausgeführten **rein lesenden** Serverinspect
verweigerte der erste Guard die tatsächliche bestehende Konfiguration:
`RMM_DEV_ROOT_ENABLED=true` gilt unverändert seit der MVP-Abnahme für API und
Gateway. Root ist durch die abgelaufene Policy geschlossen, nicht durch ein
falsches Flag. Dieser Guardfehler war kein Build-, Deployment-, Tag- oder
Migrationserfolg; es wurde kein Cloud-Buildcase erzeugt.
Die korrigierte Quelle verlangt genau diesen belegten Bestand: Rootflag `true`,
Rootpolicydatei `/root-policy/policy.json` im bereits bestehenden schreibgeschützten
Bindmount, SYSTEM-Flag und SYSTEM-/Faultdateieinstellungen nicht vorhanden,
DeliveryFaults exakt `false`. Zusätzlich liest sie ausschließlich die bekannte
nicht geheime Policy und verlangt SHA256
`cf15cbb68b590475df6def28e7dcffb7d88e0ca2d2555a06174fb654eeff05f4`,
übereinstimmend mit dem Main-MVP-Closeout und dem aktuellen System-Readback des
Hauptagenten. Geschützter Eigentümer10001, reguläre Datei0600, Einzelhardlink,
Höchstgröße64KiB und der sichere Elternpfad werden geprüft. Schema1,
Developmentprofil, feste oberste Felder, Scope-Liste und ein expliziter
Zeitzonenbezug der Ablaufzeit sind erforderlich; die Ablaufzeit muss bereits
vergangen sein. Damit verweigern sowohl bisherige als auch neue Serverversion
sämtliche Rootscopes. Der volle feste Hash bindet auch alle historischen
Scopeinhalte; die Quelle akzeptiert keine beliebige abgelaufene Ersatzpolicy.
Flag, Policy und Mount werden weder verändert noch neu angelegt. Die gleichen
Prüfungen gelten für neue Baseline, Build-CAS, Deploy-CAS und Nachbelege. Bei
Readback werden Policy-Lesefehler als Teilfehler erhalten. Ein neuer Inspect nach
dem korrigierten Sourcefreeze sowie alle tatsächlichen Cloud-Build-/Deployment-
Nachweise stehen weiter aus. Die frühere allgemeine Aussage „keine Cloudaktion
durch den Ersteller“ bezeichnet weiterhin diese Subagentenarbeit; der hier
dokumentierte Read-only-Inspect wurde vom Hauptagenten ausgeführt.
Der zusätzliche lokale Guard prüfte die tatsächlichen Funktionen mit synthetischen
Dateimetadaten und nicht geheimen Umgebungswerten: unbekannter Policyhash,
unbewiesenes Rootflag, geänderte Flags/Mountbindung sowie zwölf Schema-, Zeit- und
Metadatenabweichungen werden verweigert. Um die nachgelagerten Schema-/Zeitguards
isoliert zu erreichen, wurde ausschließlich in diesen Fixturefällen die
Digestfunktion ersetzt; dies ist kein Nachweis über tatsächliche Serverpolicybytes.
Die echte Hashprüfung wurde separat mit unverändertem SHA256 ausgeführt und
verweigerte die fremden Fixturebytes. Beide bestehenden Rollen benötigen den
geschlossenen Policybeleg. Syntax/Workerquelle und Frozen158 blieben gültig.
Beleg: `devstate/script-console-cloud-upgrade-v1-local-review/closed-policy-guard.json`.
Der gezielte TLS-Guard ruft die tatsächliche HTTPS-Hilfsfunktion mit gemockten
Verbindungsobjekten für alle drei festen Endpunkte auf: jeweils richtige CA,
TCP-Loopbackziel und unverändertes SNI, keine echte Verbindung. Fehlende API-CA
wirft einen Lesefehler ohne Fallback auf die Gateway-CA; falsche Port-/Namenspaare
werden verweigert. Dieser lokale Guard ersetzt keine echte TLS-Abnahme.