Files
rust-discovery/docs/script-console-cloud-upgrade-v1.md
kevin_janssen 38f986f410
Rust development slice / linux (push) Failing after 6s
Keep client addresses in private deployment configuration
2026-11-14 19:29:34 +01:00

15 KiB
Raw Permalink Blame History

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 discovery.ease-technologies.de 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:

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.