231 lines
15 KiB
Markdown
231 lines
15 KiB
Markdown
# 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:
|
||
|
||
```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.
|