90 lines
5.4 KiB
Markdown
90 lines
5.4 KiB
Markdown
# Migration0016: passives Updateinventar annehmen
|
||
|
||
Am2026-11-15 ist Migration0016 tatsächlich auf dem permanenten Server mit dem
|
||
regulären SQLx-Migrationspfad ausgeführt und separat nachgelesen worden. Der
|
||
bisherige Check `observations_source_id_check` ließ nur `linux.base` und
|
||
`windows.base` zu. Die laufende Gatewayversion kannte bereits die passive
|
||
`agent.update`-Beobachtung; der Datenbankcheck verweigerte deren Speicherung.
|
||
Nach dem neuen Windowsagentenwechsel waren15 entsprechende Fehler beobachtet
|
||
worden. Diese verweigerten Nachrichten werden nicht nachträglich als gespeichert
|
||
ausgegeben.
|
||
|
||
Die additive Datei `migrations/0016_agent_update_observation_scope.sql` erweitert
|
||
ausschließlich diese feste Dreiermenge. Freie Scopes bleiben verboten. Im
|
||
normalen SQLx-Transactionrahmen wird der alte Check ersetzt und der neue Check
|
||
validiert; ein Fehler rollt die Transaktion zurück. `lock_timeout=3s` begrenzt
|
||
das Warten auf Tabellenlocks, `statement_timeout=15s` jedes DDL-Statement.
|
||
Keine DML-, RLS-, FK-, PK-, Tenant-/Geräte-/Zertifikats-, Job-, Grant- oder
|
||
Policyänderung gehört zur Migration.
|
||
|
||
Tatsächlicher Fall: `cc3ea56d-6186-425a-8ef3-90562212fb1b`. Verwendet wurde das
|
||
bereits vom Orchestrator nativ ARM64 gebaute Image
|
||
`sha256:6a76343bf65c126458244f5540d4cb740988144fc77877b409f790251e7ddcc7`.
|
||
Es enthält den vorhandenen `rmm-server migrate`-Entrypoint und die echte
|
||
SQLx-`migrate!`-Migrationseinbettung. Es wurde kein zusätzlicher Builderlauf
|
||
gestartet und keine SQLx-Tabellenzeile manuell angelegt oder geändert.
|
||
|
||
Ein eigenes privates Compose-Overlay wählte ausschließlich für den temporären
|
||
`migrate`-Container dieses bereits vorhandene Image (`pull_policy: never`,
|
||
read-only RootFS, CapDropALL, NoNewPrivileges). Die vorhandene Migration-URL
|
||
blieb im normalen Compose-/Prozesskontext; sie wurde nicht ausgegeben. Der
|
||
unterstützte `docker compose … run --no-deps … migrate` führte genau einen
|
||
wirklichen SQLx-Lauf aus, Exit0. Der eigene gestoppte Container wurde nach
|
||
seinem Exit-/Image-/Falllabelbeleg entfernt. Kein API-, Gateway- oder
|
||
PostgreSQLdienst wurde durch diesen Agenten ersetzt oder neu gestartet.
|
||
API-Filterung und API-only-Deployment sind ein eigener Orchestratorschnitt.
|
||
|
||
Die tatsächliche SQLx-Historie besitzt danach Versionen1–16 jeweils mit
|
||
`success=true`; die alten15 Checksums stimmen unverändert mit den Quellinputs
|
||
überein. Version16 heißt `agent update observation scope` und besitzt SHA384
|
||
`e66ec49233c210555b5107d20b925ca6715925871aa2bf94dfb86bd5cfb39c6dc769fdf0049b615fcad503332e1cd8fc`.
|
||
Die SQL-Datei hat SHA256
|
||
`fa0953262e3a8da7f3f0366db6f3fa77ad7976ec04327b126036739eea46eebb`.
|
||
|
||
Vor dem echten SQLx-Start wurden3127 bestehende Observationzeilen serverseitig
|
||
über ihre vollständige JSON-Zeilendarstellung gehasht; unmittelbar danach waren alle
|
||
unverändert. Der ursprüngliche Fallbaseline enthielt3123Zeilen. Deren
|
||
unveränderte Fingerprints und die vollständige RLS-/Owner-/ACL-/Policy-,
|
||
FK-/PK-/sonstige Check- und Job-/Plan-/Authorization-/Outbox-/Permit-/Receipt-
|
||
Zeugen wurden nochmals in einem getrennten Read-only-SQL-Aufruf bestätigt.
|
||
Neue passive Zeilen durften parallel regulär hinzukommen. Die neue Constraint
|
||
war tatsächlich `VALIDATED` und enthielt genau
|
||
`linux.base`, `windows.base`, `agent.update`. API und Gateway liefen während
|
||
dieser Migration unverändert mit Image422c2c28; PostgreSQL behielt seine
|
||
ursprüngliche Container-/Imageidentität.
|
||
|
||
Ein weiterer lesender Serverabgleich fand bereits drei angenommene
|
||
`agent.update`-Zeilen, zuletzt15:40:50UTC. Das beweist die normale Speicherung
|
||
dieses Scopes nach der Migration, keinen separat geprüften Windows-ACK,
|
||
keine neue Basisinventarabnahme und keine Zeit-/Jobbereitschaft.
|
||
|
||
Die Vorherarchive enthalten Katalog-/Migrations-/Policyzeugen und
|
||
Zeilenfingerprints; ein vollständiger **Vorher-`pg_dump` wurde nicht angelegt**.
|
||
Ein vollständiger privater Customformat-Dump wurde ausdrücklich **nach** der
|
||
Migration archiviert: `after-migration-0016.pg_dump`,49,455,447Bytes, SHA256
|
||
`b89e74eaaea7ec2faa17a44358acca3aead1db0fcf9ccf673e2c5808b3259398`.
|
||
Er bleibt ausschließlich im Root0700-Fall auf dem Server, Datei0600, und wurde
|
||
nicht heruntergeladen oder als Vorherbackup bezeichnet. Ein Restoretest wurde
|
||
hier nicht ausgeführt.
|
||
|
||
Zwei harmlose Vorbedingungen scheiterten vor dem eigentlichen SQLx-Lauf und
|
||
bleiben erhalten: zunächst die Annahme eines vollständigen Buildkontexts
|
||
statt des tatsächlichen Minimal-Kontexts; danach ein hier nicht unterstütztes
|
||
Compose-Flag `--no-build`. Für letzteren Fall waren Exit1, Ledger15 und die
|
||
Abwesenheit eines eigenen Containers belegt. Nach Roots konkreter Korrektur
|
||
wurde derselbe Originalfall mit einem neuen Create-only-Fortsetzungsintent
|
||
verwendet; alte Fehler-/Vorherdateien wurden nicht überschrieben. Ein weiterer
|
||
reiner Absenzmatcher wurde an die tatsächliche Kleinschreibung der Docker-
|
||
Fehlermeldung angepasst, ebenfalls vor jedem Container-/SQLx-Start. Keine
|
||
verlorene SQLx-Wirkung wurde blind wiederholt.
|
||
|
||
Geschütztes Serverarchiv:
|
||
`/opt/rust-discovery/devstate/observation-scope-migration-cc3ea56d-6186-425a-8ef3-90562212fb1b/`.
|
||
Lokaler Belegordner im eigenen Worktree:
|
||
`devstate/observation-scope-migration/cc3ea56d-6186-425a-8ef3-90562212fb1b/`.
|
||
Die separate lokale `receipt.json` bindet Originalintent, Fehler, tatsächlichen
|
||
SQLx-Erfolg, getrennten Read und Nachbackup; SHA256
|
||
`00ff8f8ffa689bf3917937ce14ae23457e464b921ae7793e9091eab9a83d76c7`.
|
||
Private Zugangsdaten und
|
||
Datenbankinhalte wurden weder veröffentlicht noch in Git aufgenommen.
|