Files
rust-discovery/docs/agent-update-observation-scope.md
T
2026-11-15 16:44:24 +01:00

90 lines
5.4 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.
# 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.