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

5.4 KiB
Raw Permalink Blame History

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.