Rust development slice / linux (push) Failing after 6s
Keep release verifier and native drivers unchanged. Independently reviewed as an isolated contract after provisioned-file-key correction; eight local release contracts and format/clippy checks pass. Runtime persistence, approvals, service ownership, apply and rollback remain unimplemented.
527 lines
35 KiB
Markdown
527 lines
35 KiB
Markdown
# Agent-Selbstupdate: kleinster zusätzlicher Schnitt
|
|
|
|
Stand 2026-11-14, **Integrationsvorschlag mit implementiertem reinem Prüfkern**,
|
|
keine neue Produktnorm und kein Installations-/Applynachweis. Die reinen
|
|
Linux-/Windows-Kernnachweise sind unten getrennt verlinkt. Basis:
|
|
Spezifikation1.19, Kapitel0,4,13,16,19,22,25.
|
|
Der User möchte den Agent-Autoupdater jetzt parallel zur Skriptkonsole. Damit
|
|
wird ausschließlich dieser Teil aus M7 vorgezogen; Restore, HA, Relay und Lasttest
|
|
werden dadurch keine zusätzlichen MVP-Aufgaben. APT-/MSI-Fixturerezepte verwalten
|
|
andere Software und implementieren **keinen Agent-Selbstupdater**.
|
|
|
|
## Verhalten und Genehmigung
|
|
|
|
Der installierte Agent prüft regelmäßig, ob ein passendes, freigegebenes Release
|
|
vorliegt. Der erste Vorschlag ist ein täglicher passiver Metadatencheck mit
|
|
Jitter, zusätzlich beim Prozessstart, über den bereits konfigurierten Server.
|
|
Dies sammelt ausschließlich feste Release-Metadaten und startet keinen Job,
|
|
Installer, Download beliebiger URLs oder Codewechsel. Fehlende Konfiguration
|
|
meldet `not_configured`, abgelaufene Metadaten `unknown` samt Zeitpunkt/Fehler.
|
|
|
|
Ein Update erhält eine eigene typisierte Aktion `update_agent`. UI/MCP dürfen
|
|
einen festen Plan vorbereiten und als `pending_approval` beantragen. Der Plan
|
|
bindet pro Gerät Release-Manifesthash, Artefakte, exakten Vorgänger, Plattform,
|
|
Versuch, Frist, Parallelitätsgrenze und erlaubte einmalige Wiederherstellung.
|
|
WebUI-Genehmigung, aktuelle Startprüfung und dauerhafter Einmalverbrauch bleiben
|
|
erforderlich. Ein Mensch kann einen festen Rollout gemeinsam genehmigen;
|
|
`latest`, zukünftige Versionen, Wildcardziele und periodische Selbstfreigabe
|
|
sind keine zulässigen ausführbaren Parameter. `updates:apply` wird zusätzlich
|
|
zu den jeweiligen Root-/SYSTEM-Rechten geprüft; eine Policy begrenzt nur.
|
|
|
|
Der UI-Text muss Agent-/Helper-Dienstunterbrechung und mögliche Management-
|
|
Unterbrechung anzeigen. Dieser Schnitt fordert keinen Hostreboot an und darf
|
|
keinen Installer wählen, der ungeplant neu startet. Notwendiger Hostreboot
|
|
verlangt einen eigenen festen genehmigten Job. Automatischer Versionscheck,
|
|
freigegebener Rollout und bestätigter Updateerfolg bleiben getrennte Zustände.
|
|
|
|
## Festes Releaseformat1
|
|
|
|
Ein Release besteht zunächst aus genau zwei Rohdateien: Agent und privilegierter
|
|
Helper. Kein Archiv, Postinstall-Skript, freier Pfad oder beliebiges Kommando.
|
|
Linux verwendet `x86_64-unknown-linux-gnu`, Windows
|
|
`x86_64-pc-windows-msvc`. Die Plattformkennung ist eine geschlossene Auswahl.
|
|
Ein neuer Updater selbst ist **nicht** Teil dieses ersten Selbstupdatepfads.
|
|
APT-/MSI-Pakete können später denselben signierten Vertrag umschließen; der
|
|
erste Rohbinaryschnitt darf nicht als APT-/MSI-Upgrade beworben werden.
|
|
|
|
Das Envelope enthält `schema_version=1`, `key_id`, `payload_bytes` und
|
|
`signature` (feste Ed25519-Signatur,64Bytes). Für JSON-Transport werden
|
|
`payload_bytes` und `signature` als kanonisches Base64url ohne Padding übertragen,
|
|
keine unbeschränkten Zahlenarrays. Der erste Bibliothekskern nimmt bereits
|
|
dekodierte begrenzte Bytes entgegen; die spätere Transportintegration muss das
|
|
Envelope vor Decodierung begrenzen. Der Payload ist streng typisiertes
|
|
JSON mit festen Feld-/Listenreihenfolgen, ohne unbekannte Felder, doppelte Keys,
|
|
Floats oder alternative Encodingform. Nach Parsen muss exakt dieselbe kanonische
|
|
Serialisierung entstehen. Signaturbytes sind die Domäne
|
|
`rmm.agent-release.v1\0` gefolgt von den unveränderten Payloadbytes. Der
|
|
Manifesthash ist SHA256 derselben Payloadbytes. Verifikation begrenzt das
|
|
Payload vor Parsen auf16KiB und verwendet `verify_strict` aus dem schon gepinnten
|
|
`ed25519-dalek=2.2.0`; keine Algorithmusverhandlung.
|
|
|
|
| Payloadfeld | Festgelegte Bedeutung |
|
|
|---|---|
|
|
| `schema_version` | Genau1 |
|
|
| `release_id` | UUID; unveränderlicher veröffentlichter Datensatz |
|
|
| `release_sequence` | Positive monotone Veröffentlichungsnummer je Plattform; Versionsvergleich nutzt diese Nummer |
|
|
| `version` | Sichtbare nichtleere ASCII-Versionskennung; kein lexikografischer Semververgleich |
|
|
| `platform` | Eine der beiden festen x64-Plattformkennungen |
|
|
| `published_at`, `expires_at` | UTC-Epochsekunden, gültig nur mit vertrauenswürdigem Clockkontext |
|
|
| `protocol_major` | Exakte unterstützte Hauptversion; die erste Stufe erlaubt nur dieselbe aktuelle Version |
|
|
| `state_schema` | Exakte kompatible Zustandsversion; erste Stufe erlaubt **keine** Zustandsmigration |
|
|
| `minimum_updater_version` | Positive numerische Implementierungsversion des unabhängigen Updaters |
|
|
| `artifacts` | Genau Agent, danach Helper; je `role`, unveränderliche `artifact_id`, SHA256 und Länge |
|
|
|
|
Artefakthashes sind64kleine Hexzeichen; Längen positiv und höchstens256MiB pro
|
|
Datei. Artefakt-UUIDs dürfen nicht doppelt sein. Rollen sind `agent` und `helper`,
|
|
keine eigenen Dateinamen aus dem Netzwerk. Die Veröffentlichung ist erst
|
|
verfügbar, wenn beide vollständigen Dateien existieren und deren Hash/Länge
|
|
mit dem signierten Manifest übereinstimmen. Serverkatalog und Tenantberechtigung
|
|
bestimmen Sichtbarkeit; das Manifest selbst verleiht keinerlei Ausführungsrecht.
|
|
|
|
## Vertrauen, Ablauf und Versionsschutz
|
|
|
|
Update-, Job-/Grant- und Geräte-/TLS-Schlüssel sind getrennt. Lokaler Bootstrap
|
|
provisioniert einen root-/SYSTEM-geschützten Update-Keyring mit SHA256-Key-ID,
|
|
rohem32Byte-Publickey, Plattformbindung und zulässigem Sequenzbereich. Kein
|
|
Schlüssel aus einem Job, Manifest oder Download wird automatisch vertrauenswürdig.
|
|
Veraltete/gesperrte Keys verweigern auch eine ansonsten passende Signatur.
|
|
|
|
Erste kleine Stufe unterstützt Rotation/Widerruf durch kontrollierte, separat
|
|
provisionierte Keyringgeneration; neue Generation muss größer sein, alte
|
|
Schlüssel werden nicht implizit übernommen. Dynamisches Online-Rootrotation-
|
|
Protokoll ist noch offen und wird nicht als TUF-Implementierung ausgegeben.
|
|
Dies hat eine konkrete Grenze: Ein lange isolierter Client kennt einen späteren
|
|
Widerruf erst bei frischer authentisierter Trustprovisionierung. Daher beginnt
|
|
ohne frischen Kontakt und aktuellen Trustkontext kein Apply.
|
|
|
|
Lokal gibt es getrennt (a) die aktuell aktive Manifest-ID/Sequenz, (b) die höchste
|
|
erfolgreich aktivierte Sequenz als Antirollbackgrenze, (c) den höchsten gesehenen
|
|
Katalogstand für Replaydiagnose und (d) einen offenen Übergabeintent. Bloßes
|
|
Ansehen eines neuen Releases autorisiert keine Wirkung. Ein älteres Release
|
|
unter der bestätigten Antirollbackgrenze ist niemals ein neues Updateziel.
|
|
Gleiche Sequenz mit anderen Manifestbytes ist ein Konflikt; dieselben Bytes sind
|
|
ein Metadatenduplikat, keine neue Wirkung. Versionslabels allein reichen nicht.
|
|
|
|
`verify_release` prüft ausschließlich **zukünftige Updatekandidaten**. Nach
|
|
einem Code-Rollback (`active=3`, bestätigter Floor=5) verweigert diese Funktion
|
|
auch das aktive Manifest3 als erneutes Updateziel. Das bedeutet keine Korruption
|
|
oder Ungesundheit der aktuell laufenden Version. Passive Anzeige und Health
|
|
verwenden den gesonderten geschützten `InstalledReleaseRecord` mit explizitem
|
|
Rollbackstatus; sie dürfen diese Kandidatenprüfung nicht als Current-Healthcheck
|
|
verwenden. `SameActiveManifest` ist nur oberhalb/auf dem unveränderten Floor
|
|
erreichbar und bleibt ausschließlich ein Metadatenvergleich.
|
|
|
|
Die einzige Rückkehr zu einer niedrigeren aktiven Sequenz ist die im selben
|
|
genehmigten Versuch vorab gebundene letzte bekannte Codeversion, deren Dateien
|
|
noch unverändert lokal vorhanden sind. Die Antirollbackgrenze wird dabei nicht
|
|
gesenkt. Widerrufene/ausdrücklich verbotene Vorgänger werden auch als Rollback
|
|
verweigert. Ein späteres Downgrade verlangt einen getrennten Recoveryvertrag.
|
|
|
|
## Servertransport und UI/MCP-Vertrag
|
|
|
|
Vorgeschlagener zusätzlicher lesender Endpunkt:
|
|
`GET /agent/v1/releases/current?platform=<feste-plattform>`, über vorhandenes
|
|
Geräte-mTLS, ohne Redirects, höchstens32KiB Envelope, Serverzeit und Katalog-
|
|
beobachtungszeit getrennt. Antwort enthält einen signierten festen Manifestenvelope
|
|
oder explizites `not_configured`/keine angebotene Version. Kein neuer öffentlicher
|
|
Login oder allgemein adressierbarer Installerdownload. Ein veraltetes aber noch
|
|
gültiges Manifest ist durch reine TLS-/Hashprüfung allein nicht als aktuellste
|
|
Version beweisbar; der Check meldet nur die tatsächlich beobachtete Version.
|
|
|
|
Der vorhandene geräte-/Job-/Versuch-gebundene
|
|
`/agent/v1/artifacts/{artifact_id}`-Pfad kann derzeit nur Artefakte bis256KiB
|
|
beziehen: `LocalArtifacts::put/get` **und** das SQL-`CHECK` in
|
|
`migrations/0006_catalog.sql` begrenzen sie entsprechend. Sein512KiB-
|
|
Chunklimit erweitert weder Store noch SQL und lädt heute das ganze Objekt in
|
|
einen `Vec`.
|
|
**Damit kann er Agentbinaries nicht transportieren.** Die bis256MiB großen
|
|
Deskriptoren des neuen reinen Prüfkerns sind für eine noch offene, ausdrücklich
|
|
Update-spezifische begrenzte Streaming-Erweiterung vorgesehen. Weder Import,
|
|
Downloadroute noch Serverlimit werden in diesem Schnitt verändert. Spätere
|
|
Integration muss dieselben Geräte-/Job-/Versuchs- und exakten Manifestbindungen
|
|
auch für große Streams durchgehend erhalten. Kein vom LLM gelieferter
|
|
Downloadhost, TCP-Override, Dateipfad oder TLS-Ausnahmeschalter.
|
|
Der zukünftige Download wird gestreamt und vor Verwendung gegen
|
|
Länge/SHA256 geprüft; Zusatzbytes und vorzeitiges EOF verweigern. Nach Reconnect
|
|
stammt neue Startautorität immer aus dem normalen Plan-/Grantpfad.
|
|
|
|
`operations.plan(action=update_agent)` erhält nur die gespeicherte Release-ID
|
|
und feste Ziele; Server löst unveränderliche Bytes aus dem berechtigten Katalog
|
|
auf und bindet tatsächlichen gespeicherten Vorgänger sowie beide Artefakte.
|
|
`operations.submit` bleibt Antrag; `jobs.get` zeigt Staging, Übergabe,
|
|
Dienstprüfung, erhaltene Identität, Rollback und tatsächlichen Ausgang. Vor
|
|
Genehmigung zeigt WebUI alle Hashes, Versionen, Rechte und Ausfall-/Rollbackgrenzen.
|
|
Neue Datenverträge sind mit dem Skriptkonsolen-Eigentümer abzustimmen; dieser
|
|
Vorschlag ändert noch keine Domain-/Protokoll-/Server-/Webdatei.
|
|
|
|
## Unabhängiger Worker und erhaltende Übergabe
|
|
|
|
Der Netzwerkagent bleibt unprivilegiert. Ein kleiner separat installierter
|
|
Updater wird unter Root/SYSTEM mit restriktiver IPC/Peerprüfung angesteuert.
|
|
Er prüft selbst Releasekey, Manifest, exakten Originaljob/-grant, aktuelle
|
|
Identitäts-/Zuordnungs-/Boot-/Clock-/Syncbindung und lokalen Policykontext.
|
|
Die schon vorhandenen Helperprüfungen dürfen nicht durch bloßes `approved=true`
|
|
oder einen Dateimarker ersetzt werden. Sein eigener Journal-/Verbrauchsbezug
|
|
muss vor Start serverseitig bekannt und unabhängig synchronisiert sein.
|
|
|
|
Der Updater startet nicht aus der gerade zu ersetzenden Agent-/Helperdatei und
|
|
überlebt deren Stop. Geräteweite Locks serialisieren Paketmanager, Updates,
|
|
Root-/SYSTEM-Skriptwartung und Reboots. Offene oder unbekannte Versuche sperren
|
|
die erste Updateversion; keine Aktualisierung mitten in einer Wirkung.
|
|
|
|
1. Exakten Vorgänger, Trust-/Policy-/Serviceidentitäten, freie Kapazität und
|
|
Zustandskompatibilität prüfen. Geschützte Stagingdateien create-only auf
|
|
demselben Dateisystem; Files und Verzeichniseinträge dauerhaft flushen.
|
|
2. Manifest und beide Dateien unabhängig prüfen; keine Wirkung vor Genehmigung.
|
|
Ein Downloadfehler vor Übergabe bleibt belegter Nichtstart der Aktivierung.
|
|
3. Vor Stop/Swap dauerhaften Intent mit Originaljob/Versuch/Grant und allen
|
|
Vorherzeugen schreiben, Grant/Versuch einmalig verbrauchen. Nach unklarem
|
|
Ausgang ausschließlich Zustand desselben Intents lesen, nie Execute wiederholen.
|
|
4. Dienste geordnet einmal stoppen; aktive handles/Locks und SQLiteintegrität
|
|
prüfen. Identitäten, Geräteschlüssel, Zertifikats-/Rotationstore, Konfiguration,
|
|
ACLs, DBinodes/FileIDs, Originaltabellen/-zeilen, Journale/Signaturen und offene
|
|
Outbox bleiben erhalten. Private Schlüsselbytes werden nicht exportiert.
|
|
5. Für den ersten Aktivierungsschnitt empfehle ich **bestehende feste
|
|
Service-Imagepfade erhalten**. Der unabhängige Updater stoppt und bestätigt
|
|
beide Dienste, tauscht alle gebundenen Code-/Pin-Dateien unter den Locks,
|
|
prüft vollständig die neue Kombination und startet erst dann einen Dienst.
|
|
So läuft kein altes/neues Paar gleichzeitig, obwohl die Dateiersetzungen
|
|
**kein atomarer Dateisystem-Bundleswap** sind. Der dauerhafte Intent benennt
|
|
jede bereits erfolgte Ersetzung; ein Absturz lässt beide Dienste bis zum
|
|
eindeutig belegten Abschluss oder Code-Rollback gesperrt. Vorhandene Runner
|
|
zeigen dieses Wartungsfenster bereits, sind aber noch kein Selfupdater.
|
|
Ein neuer Launcher würde Service-PID-/Image-/Peerprüfungen verändern und ist
|
|
für diesen ersten Schnitt unnötig. Ein einzelner atomarer Versionsselector
|
|
bleibt eine spätere Alternative mit eigener vollständiger Qualifikation.
|
|
6. Neue Dienste einmal starten; actual Imagehash/Identität, passive Heartbeats,
|
|
bestätigtes Inventar und erfolgreiches signiertes Sync mit geschlossenen
|
|
Effectgates bis zum vollständigen Abgleich nachweisen. `Running` allein reicht
|
|
nicht. Erst dann aktives Release/Antirollbackgrenze dauerhaft bestätigen.
|
|
7. Bekannter Fehlstart darf genau die vorab gebundene Codeversion einmal
|
|
zurückselektieren und starten; derselbe aktuelle Datenzustand bleibt liegen.
|
|
Keine DB-/Ledger-/Generation-/Clock-/ACLrücksetzung. Fehlender/unklarer
|
|
Rückkehrnachweis bleibt `unknown`, keine Schleife automatischer Startversuche.
|
|
|
|
Vorhandene SSH-Bootstraprunner (`vm_runtime_upgrade.py`,
|
|
`cloud_shared_core_upgrade_v2.py`, `windows/runtime_feature_upgrade.py`) zeigen
|
|
nützliche erhaltene DB-/Inode-/FileID-/Schlüsselmetadatenprüfungen und dauerhafte
|
|
einmalige Intents. Sie sind administrative Einzeltools, keine ausgelieferten
|
|
Selfupdater und keine Ersatzgenehmigung dieses Produktpfads. Frühere fehlerhafte
|
|
Verifierberichte bleiben historisch; neue Abnahme muss konkrete aktuelle Daten
|
|
binden, einschließlich vorhandener zulässiger Hardlinkpublikationen.
|
|
|
|
## Kleinster prüfbarer Quellschnitt und danach offene Arbeit
|
|
|
|
Nach Entwurfsreview implementiert: neue kleine `crates/updater`-Bibliothek,
|
|
keine Daemonhülle. Dateien `Cargo.toml`, `src/lib.rs`, `src/manifest.rs` und
|
|
neun gezielte Vertragsprüfungen mit vollständiger kanonischer Goldenfixture.
|
|
Root-`Cargo.toml`/`Cargo.lock` nur für Workspacebindung; keine neuen fremden
|
|
Paketversionen. Alle benutzten Abhängigkeiten waren bereits im Lockfile.
|
|
Implementierte Funktion: bounded canonical manifest decode, strikte Ed25519-Verifikation gegen
|
|
getrennten übergebenen Keyring, Plattform-/Clock-/Kompatibilitäts-/Versionsprüfung
|
|
und begrenzte Streaming-Hash-/Längenprüfung von Artefakten. Keine Aktivierung,
|
|
kein Netzwerk, keine generische OS-Dateischreib-API. Ein validiertes Objekt
|
|
beweist nur gültige Releasebytes; dessen API darf weder Approval noch Startgrant
|
|
behaupten oder aus dessen Besitz ein Applyrecht ableiten.
|
|
|
|
Der Kern wurde mit echten lokalen Signaturen und manipulierten/alten/falschen
|
|
Releasebytes geprüft, ohne einen Agenten auf dem Notebook zu starten.
|
|
Danach bleiben explizit offen: Serverkatalog/Veröffentlichung und echter
|
|
Releasekeybetrieb, täglicher Agentcheck und gespeicherte Updatebeobachtung,
|
|
typisierte Plan-/Grant-/UI-/MCP-Bindung, getrennte Updater-Verbrauchssynchronisation,
|
|
geschütztes OS-Staging, unabhängiger Updaterbootstrap, mehrstufiger Dateiaustausch,
|
|
Health-/Rollbackpfad, echte Linux-VM-Abnahme zuerst und Windows-VM-Abnahme danach.
|
|
Ein Bibliotheksbuild ist weder Autoupdaterinstallation noch AT-26-/MVP-Erfolg.
|
|
|
|
Tatsächlich ausgeführt: vollständige Pflichtnormen gelesen und vorhandene
|
|
Upgrade-/Kryptoverträge untersucht; eigener isolierter Worktree ab287a784.
|
|
Der vorhandene Dockerbuilder mit Rust1.99.1 wurde offline, ohne Netzwerk und
|
|
mit nur lesbarem Quellmount verwendet, eigener Targetausgabe. Image-ID:
|
|
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
|
Alle folgenden Prüfungen bestanden für `x86_64-unknown-linux-gnu`:
|
|
|
|
```text
|
|
cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater -- --check
|
|
cargo clippy --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets -- -D warnings
|
|
cargo test --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets --release
|
|
```
|
|
|
|
Neun ausgeführte Vertragsprüfungen bestanden ohne Skip. Sie prüfen feste
|
|
kanonische Bytes, echte domänengetrennte Ed25519-Signaturen, falschen/gesperrten
|
|
Key und dessen Sequenzbereich, unbekannte/doppelte Felder,16KiB-Grenze,
|
|
Plattform/Clock/Trustgeneration/Protokoll/Zustand/Updaterkompatibilität,
|
|
Versionsfloor und gleichen Sequenzkonflikt, exakt zwei Artefaktrollen,
|
|
Hash-/EOF-/IOfehler sowie512KiB+7Bytes mit tatsächlichem32KiB-Readlimit.
|
|
Der verwendete private Testsignierschlüssel ist ausschließlich eine feste
|
|
öffentliche Testfixture und wird nie als Vertrauensanker ausgeliefert.
|
|
|
|
Lokaler Beleg (gitignored): `devstate/agent-updater/local-qualification.json`
|
|
bindet Quellen, Image-ID, tatsächliche Befehle/Loghashes und alle neun Testnamen.
|
|
Die Linux-Release-Testexe ist1544584Bytes groß, SHA256
|
|
`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`.
|
|
Das ist ein lokaler Container-/Vertragsnachweis, **kein Cloud-VM-Nachweis**.
|
|
Der danach durch Root ausgeführte eigene Native-Linux-Schritt bestand9/9
|
|
auf der Cloud-Test-VM, Fall `420d53da-6e34-4e04-b871-0b571d8d3fc4`,
|
|
Proof-SHA256 `bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`.
|
|
Details und klare Grenzen: [Native Kernqualifikation](agent-updater-native-contracts.md).
|
|
Danach bestand derselbe Prüfkern als Windows-GNU-Unitbinary9/9 auf dem
|
|
Windowsgast, Fall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`, Proof-SHA256
|
|
`fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`;
|
|
[separater Nachweis](agent-updater-windows-contracts.md), kein MSVC-/Dienstbeleg.
|
|
Serverintegration und tatsächlicher genehmigter Codewechsel bleiben
|
|
offen. Kein Installer, keine Dienständerung, keine Freigabe und kein RMM-Job
|
|
durch diesen reinen Prüfkern; der Subagent führte keine eigene VM-Aktion aus.
|
|
|
|
Zusätzlicher lokaler Reviewstand nach1.20: ein isolierter typisierter
|
|
Handoff-/Healthkernel und geschlossener Linux-Fullrenderer sind implementiert,
|
|
ohne den qualifizierten Verifier oder Runtime zu ändern. Die tatsächliche
|
|
Linuxzieltopologie General+Full+Agent wird ausdrücklich berücksichtigt;
|
|
Full bleibt kein pauschaler Ausschluss. Konkreter Vertrag, acht lokale
|
|
Prüfungen, notwendige Reviewentscheidungen und weiterhin fehlende Integration:
|
|
[Erhaltende Handoffgrenze](agent-updater-handoff.md). Dies ist keine neue
|
|
Produktnorm, Zielinstallation oder native Applyabnahme.
|
|
|
|
## Nächster Integrationsschnitt zur Freigabe: fester Codepaar-Updatejob
|
|
|
|
Die folgende Änderungsliste ist **nur Entwurf, nicht implementiert**. Sie
|
|
ersetzt keine Sourcefreigabe, Bootstrapabstimmung oder native Abnahme. Mit dem
|
|
Skriptkonsolen-Eigentümer abgestimmt: `update_agent`, `agent.update.apply/1`
|
|
und `updates:apply` kollidieren nicht mit `full_maintenance_v1`. Dessen separater
|
|
Helperpfad und das allgemeine/APT-Profil bleiben getrennt; alle benutzen dieselbe
|
|
geräteweite Wirkungssperre und erhaltene Verbrauchshistorie.
|
|
|
|
### 1. Unveränderliche Action und Planbindung
|
|
|
|
Vorgeschlagene additive `Action::UpdateAgent { update: ResolvedAgentUpdate }`,
|
|
eigener Modulvertrag `crates/domain/src/agent_update.rs`. Kein Aufruf von
|
|
`run_script`, APT oder MSI. Alte Action-/Job-/Plan-/Grantbytes bleiben exakt
|
|
erhalten. `JobPayload` behält seine bestehenden IDs, Identitätsgenerationen,
|
|
Zeitgrenzen und Limits; `ExecutionPermit.action` lautet `update_agent` und
|
|
bindet wie bisher den gesamten `job_payload_hash`. Vor Genehmigung erzeugt
|
|
der Server die vollständigen Bytes je festem Ziel/Versuch.
|
|
|
|
`ResolvedAgentUpdate` hat in dieser festen kanonischen Feldreihenfolge:
|
|
|
|
| Feld | Typ und Bindung |
|
|
|---|---|
|
|
| `schema_version` | Genau1 |
|
|
| `profile` | Genau `fixed_code_pair_v1` |
|
|
| `release_envelope` | Schema1, Update-Key-ID, Payload/Signatur als Base64url ohne Padding; keine freien URLs |
|
|
| `release_envelope_sha256` | SHA256 des kanonischen vollständigen Envelopes, einschließlich Signatur/Key-ID |
|
|
| `manifest_sha256` | SHA256 der dekodierten exakten Release-Payloadbytes |
|
|
| `predecessor` | Feste Release-ID, Sequenz, Manifesthash, `installed_record_sha256`, Agent-/Helperhash |
|
|
| `updater` | Exakter installierter Updaterbinaryhash, lokale Policyhash, Keyringgeneration und Keyringhash |
|
|
| `peer_pin_transition` | Typisierte Plattformvariante, feste Vorher-/Nachher-Settings-/Pinhashes; siehe unten |
|
|
| `recovery` | Genau `restore_exact_predecessor_once` |
|
|
| `health_profile` | Genau `mtls_inventory_sync_v1` |
|
|
| `health_timeout_seconds` | Genau180 im ersten Schnitt; gesamter Job maximal600Sekunden |
|
|
| `no_reboot` | Genau `true` |
|
|
|
|
Die beiden Artefakte und ihre Reihenfolge kommen ausschließlich aus dem signierten
|
|
Manifest. `artifact_ids` als zusätzliche Requestparameter sind für diese Action
|
|
verboten. Der Plan enthält je Job/Versuch genau die beiden daraus abgeleiteten
|
|
`JobArtifactReference`s; generisches Nachladen weiterer Dateien ist verweigert.
|
|
Weil die bisherigen Resolver kleine `artifacts` voraussetzen, erhält ausschließlich
|
|
`update_agent` einen eigenen Resolver gegen den Updatekatalog. Alte Resolver und
|
|
ihre Grenzen bleiben bestehen. Fehlende/doppelte/fremde Referenzen, geänderter
|
|
Vorgänger oder ein von der Plattform abweichendes Release sperren bereits Planung
|
|
und nochmals Submit, WebUI-Genehmigung, Revalidation, Startgrant und Download.
|
|
Der vollständige Job muss weiter in die vorhandene64KiB-Helpergrenze passen.
|
|
|
|
Erste Einrichtung importiert die tatsächlich installierte bekannte Codepaar-
|
|
Baseline als separat release-signierten Datensatz mit eigener Sequenz, prüft
|
|
ihre Dateien und provisioniert daraus `InstalledReleaseRecord` und Floor.
|
|
Dadurch besitzt auch das erste Update einen exakten bekannten Vorgänger; kein
|
|
`unknown`, frei vom Agenten behaupteter Hash oder ungeprüftes Legacy-Downgrade.
|
|
Dies ist Teil des gesonderten erhaltenden Updaterbootstraps, kein Codeupdate.
|
|
|
|
Windows benötigt einen festen Pure-Renderer: ausschließlich
|
|
`Settings.agent.binary_sha256` und `Settings.helper.binary_sha256` werden aus
|
|
den Zielartefakten ersetzt; alle Rechte, Dienste, Identitäten, Pfade, Runtime-
|
|
und Clockflags bleiben gleich. Der daraus kanonisch abgeleitete Settingshash
|
|
und öffentliche `Pin`-Hash stehen **vor Genehmigung** fest. Grundlage ist ein
|
|
typisierter aktueller öffentlicher Deploymentbeleg des bestehenden Helpers,
|
|
keine Secretdatei. Der lokale Updater prüft vor/nach unabhängig, dass exakt diese
|
|
beiden Felder geändert werden. Der Server darf nur die exakt genehmigte neue
|
|
Code-/Policybindung aktivieren; dadurch entstehen keine neuen Aktionsrechte.
|
|
Linux verwendet bei unverändert codeunabhängigen Generalpins die Variante
|
|
`unchanged_general_pin_v1`. APT-Akzeptanzbelege werden nicht neu signiert oder
|
|
als für neue Codebytes gültig ausgegeben; gegebenenfalls bleibt APT geschlossen.
|
|
Nicht unterstützte weitere Pinprofile sperren dieses erste Update, statt sie
|
|
automatisch mitzunehmen oder neue Akzeptanznachweise zu erfinden.
|
|
|
|
### 2. Rechte, Beobachtung und Capability
|
|
|
|
Planurheber und Freigeber benötigen jeweils die üblichen Operationsrechte plus
|
|
`updates:apply` und Linux `root:execute` beziehungsweise Windows `system:execute`.
|
|
`scripts:execute` wird nicht daraus abgeleitet. Eine zusätzliche versionierte
|
|
zentrale/local-Updaterpolicy begrenzt exakte Geräte-/Generations-/Principal-,
|
|
Updater-/Keyring-/Manifest-/Vorgänger- und Pinbindungen. Standard bleibt deny.
|
|
Die WebUI zeigt Ziel und Vorgänger, beide Binärhashes, Rechte, Unterbrechung,
|
|
Rollback, Pinänderung und Fristen; MCP verwendet nur Plan/Submit/Status.
|
|
|
|
`agent.update.check/1` wird nach tatsächlich funktionierendem reinem Metadaten-
|
|
Check gemeldet. `agent.update.apply/1` erst nach nativer aktueller Qualifikation
|
|
des installierten unabhängigen Updaters, IPC-/Peer-/Lock-/Ledgerprüfung und
|
|
bestätigtem signiertem Sync. Ein Librarybuild erzeugt keine Capability. Check
|
|
speichert Quelle, tatsächlich beobachteten Manifesthash, Zeit, Qualität und
|
|
`available`/`same`/`not_configured`/`error`; er lädt keine großen Dateien und
|
|
legt weder Jobs noch Outbox für Wirkungen an. `rolled_back` beim installierten
|
|
Record ist von der angebotenen Kandidatenversion getrennt sichtbar.
|
|
|
|
### 3. Begrenzter Releasekatalog und eigener großer Artefaktpfad
|
|
|
|
Neue immutable Tenanttabellen `agent_releases` und `agent_release_artifacts`
|
|
mit zusammengesetzten Tenant-FKs, RLS/FORCE-RLS und ohne UPDATE/DELETE für die
|
|
Anwendungsrolle. Release-ID/Sequenz/Plattform sind eindeutig; Publizieren
|
|
verifiziert Signatur, kanonische Bytes, Rolle, Länge und Hash beider Dateien.
|
|
Keine Änderung am262144Byte-`CHECK` der bestehenden `artifacts`-Tabelle.
|
|
Ein tenantgebundener `AgentReleaseStore` arbeitet mit bereits geprüften
|
|
content-addressierten, unveränderlichen Objekten und begrenzten Readhandles;
|
|
kein `get()->Vec<u8>` für bis256MiB. Publikation ist ein Plattformbetriebsrecht,
|
|
kein vom Modell befüllbarer allgemeiner Upload-/Signierdienst.
|
|
|
|
Neuer `GET /agent/v1/update-artifacts/{artifact_id}` mit `job_id`, `attempt_id`,
|
|
`offset`, `length`: Geräte-mTLS, genau genehmigter aktueller `update_agent`-Job,
|
|
aktuelle Tenant-/Geräte-/Generations-/Rechte-/Planbindung und exakt eine der
|
|
beiden Referenzen. Jeder Chunk prüft diese Bindung erneut; höchstens512KiB,
|
|
Gesamtobjekt höchstens256MiB, begrenzte Parallelität/IOzeit und kein Redirect.
|
|
`Content-Range`, Gesamtgröße und SHA256 sind an den Deskriptor gebunden.
|
|
Server verifiziert Objektidentität/-länge vor Read und streamt begrenzt;
|
|
Agent/Updater prüft unabhängig den vollständigen Gesamt-SHA256 und exaktes EOF.
|
|
Nach Antwortverlust dürfen nur fehlende Downloadbytes desselben geschützten
|
|
Stagingobjekts weiterbezogen werden, niemals ein neuer Installer-/Aktivierungs-
|
|
versuch. Eine fortgesetzte Datei wird vor Verwendung vollständig neu gehasht.
|
|
|
|
### 4. Stabiler Updater, einmalige Übergabe und Absturzverhalten
|
|
|
|
Separat bootstrapped stabiles Updaterbinary; dieser erste Updatejob verändert
|
|
es nicht. Feste Linux-UID-/Windows-Dienst-SID-/PID-/Image-/ACLprüfungen, keine
|
|
vom Agenten gewählten Programme/Pfade. Bestehende Agent-/Helper-Servicepfade
|
|
bleiben erhalten. Alle tatsächlich installierten Profile, die dieselbe
|
|
Helperbinary verwenden, müssen im fest provisionierten Dienstset stehen und
|
|
vor Austausch bestätigt gestoppt sein; unbekanntes Profil verweigert. Der
|
|
Updater gehört selbst nicht zu diesem Stopset.
|
|
|
|
Die erste Empfehlung ist **denselben bestehenden Helperverbrauchsledger und
|
|
`executor.lock`** zu verwenden, wie heute schon mehrere Helperprofile, statt
|
|
einen ungebundenen neuen Ready-/SQLitepfad zu eröffnen. Bootstrap fügt nur eigene
|
|
append-only Updateintents hinzu, ohne alte Zeilen/Schemaobjekte zu ersetzen.
|
|
Updater prüft seinen aktuellen Prozess-/Boot-/Clock-/Signatur-/Syncbezug selbst;
|
|
ein anderer Prozess vererbt keine Bereitschaft. Ob der vorhandene gemeinsame
|
|
Helpersnapshot dies ohne Wireerweiterung vollständig bindet, ist vor Runtime-
|
|
Code anhand `HelperSync`/`ExecutorLedgerGuard` zu prüfen. Falls nicht, bleibt
|
|
Apply geschlossen bis zu einer separat versionierten Participantbindung;
|
|
kein weiterer Journal-ID-Slot wird stillschweigend in alten Tags versteckt.
|
|
|
|
Der Updater darf seinen eigenen Updateversuch nach Verbrauch als einzigen
|
|
offenen Versuch führen; jeder **andere** offene/unknown-/unsettled-Versuch
|
|
sperrt. Root-/SYSTEM-Wartungsskripte und Paket-/Rebootwirkungen verwenden
|
|
dieselbe Sperre. Nach Übergabe überlebt der Updater Agent-/Helperstop und
|
|
journalisiert im eigenen erhaltenen Intent die folgenden Phasen:
|
|
|
|
| Phase | Dauerhafter Beleg und zulässige Folgerung nach Absturz |
|
|
|---|---|
|
|
| `staged_verified` | Nur geprüfte Dateien vorhanden, noch kein Stop/Swap; Nichtstart nur mit unabhängig belegtem Nichtdispatch |
|
|
| `handoff_consumed` | Originaljob/Grant/Versuch und vollständige Vorherzeugen fest, kein zweites Execute |
|
|
| `stop_intent` / `all_stopped` | Einmaliger Stop angekündigt/bestätigt; unklare Dienste erst lesen, nicht blind erneut stoppen/starten |
|
|
| `replace_intent(role)` / `replaced(role)` | Jede einzelne Code-/Pinersetzung bindet Original-/Zielhash, ACL und retained Backup; tatsächliche Datei entscheidet über Teilzustand |
|
|
| `pair_verified` | Gesamtes neues Code-/Pinset vollständig geprüft, vor jedem neuen Dienststart |
|
|
| `start_intent(service)` / `started(service)` | Jeder Start nur einmal, tatsächliche SCM-/systemd-/PID-/Imagebelege, kein Retry bei verlorenem Reply |
|
|
| `health_verified` | Neues mTLS, tatsächlicher Codepaarbeleg, Inventar-ACK und signierter Sync für selben Originalversuch innerhalb180Sekunden |
|
|
| `rollback_intent` / `rollback_verified` | Ausschließlich gebundene Originalcode-/Pinbytes einmal zurück, gleicher aktueller Datenzustand und unveränderter Floor |
|
|
| `outcome_persisted` | Originalerfolg oder bekannter Fehlstart samt Rollbackresultat dauernd gespeichert; unverändert bis ACK erneut übermitteln |
|
|
|
|
Anwendungsweite Effectgates bleiben während Wechsel und Health geschlossen;
|
|
der eigene bereits verbrauchte Updateversuch darf gezielt abgeglichen werden,
|
|
ohne dadurch neue allgemeine Starts zu erlauben. Sonst würde die eigene offene
|
|
Updatezeile Health-Sync dauerhaft blockieren. Nach frischem Prozessstart ist
|
|
kein alter Gate-/Leasezustand gültig. Ein unbekannter Teiltausch/Start bleibt
|
|
`unknown`; Recovery liest vorhandene Dateien/Intents und darf daraus keine
|
|
neue Wirkungserlaubnis konstruieren. Allgemeines Resume bei ungeklärtem
|
|
Dispatch und Endlosschleifen automatischer Rollbacks gehören nicht dazu.
|
|
|
|
### 5. Konkrete Datei-/Abnahmefolge nach erneutem Review
|
|
|
|
| Lieferung | Geplanter enger Dateiscope und überprüfbares Ergebnis |
|
|
|---|---|
|
|
| Gemeinsamer Vertrag | Additives `domain/src/agent_update.rs`, zugehörige `Action`-Matches und Golden-/Legacyfixtures; `updater` bleibt eigenständiger Verifier, keine OSwirkung |
|
|
| Katalog und feste Planung | Neue Migration, `server/src/agent_releases.rs`, eigener Store/Streaminghandler, begrenzte Ergänzungen in `jobs`, `job_gateway`, Policy und MCPschema; alte Paketlimits bleiben bestehen |
|
|
| Passive Agentbeobachtung | Bestehende Transport-/Inventarworker ergänzen festen Releasecheck und gespeicherte Beobachtung; keine angeforderte Liveaktion als Telemetrie tarnen |
|
|
| Geschlossener Updaterworker | Neues unabhängiges Binary/OSadapter und versionierte Bootstrapdefinition, feste IPC/Locks/Ledger/Intents/Pinrenderer; keine offenen neuen Capabilities vor Qualifikation |
|
|
| Linux-Abnahme zuerst | Reine Kernunits nativ auf Cloud-Linux; danach ein fixes WebUI-genehmigtes Update samt getrennten belegten Fehler-/Redelivery-/Stateerhaltungsfällen |
|
|
| Windows danach | Native Kern-/IPC-/SCM-/Pin-/Codepaar-/Rollbackabnahme auf Windowsgast, dieselbe WebUI-/Tenantgrenze; keine Notebookdienste |
|
|
|
|
Vor Runtimefreigabe sind vor allem gemeinsamer Syncteilnehmer, exakt erlaubte
|
|
Pinprofile und erfolgreiche Health bei ausschließlich eigenem offenen
|
|
Updateversuch zu entscheiden. Diese Liste enthält keine neue Terminalengine,
|
|
generischen Paketprovider, Keyrotationplattform, Restorefunktion oder weiteren
|
|
Produktumfang. Alle genannten Dateien/Befehle/Abnahmen dieses Abschnitts sind
|
|
**geplant, nicht ausgeführt**.
|
|
|
|
## Geprüftes Runtimegate: eigener offener Versuch und Health
|
|
|
|
Sourcebefund, **Entwurf ohne Produktänderung**: `HelperSync::apply` in
|
|
`crates/agent-core/src/helper_reconcile.rs:482` darf einen gültigen negativen
|
|
signierten Abgleich dauerhaft übernehmen. Die Startlease bleibt geschlossen:
|
|
`apply_inner` verlangt definitive Outcomes für sämtliche Zeilen und
|
|
`can_start` zusätzlich null offene `consumed.result IS NULL`-Zeilen
|
|
(`:575`, `:666`, `:696`). Deshalb darf Update-Health niemals allgemeines
|
|
`ready=true` voraussetzen oder trotz eigener offener Zeile erzeugen.
|
|
|
|
Der normale Wiederabgleich macht gestartete unvollständige Versuche bewusst
|
|
unknown (`agent-core/src/reconcile.rs:233`, `server/src/synchronization.rs:717`)
|
|
und `ClientSync::confirm_helper` verweigert offene Helperwirkungen (`:127`).
|
|
Dies zu ignorieren wäre keine Healthimplementierung. Benötigt wird ein neuer,
|
|
ausdrücklicher **dauerhafter `pending/inflight`-Handoffvertrag** des genau
|
|
genehmigten Updateversuchs. Er muss kontrollierte Eigentümer-/Prozessübergaben
|
|
von einer tatsächlich unklaren Wirkung unterscheiden, ohne frühere Unknown-
|
|
Events, definitive Unknown-Outcomes, Startzeugen oder Deadlines umzuschreiben.
|
|
Fehlender Owner-/Handoff-/Zeitnachweis bleibt unknown und geschlossen; ein
|
|
späterer Healthbeleg heilt ihn nicht und berechtigt keinen erneuten Start.
|
|
|
|
Windows hält `LedgerGuard` während der gesamten Helper-Dienstlebensdauer
|
|
(`agent-windows/src/helper_system.rs:222`, `:822`). Der separate Updater kann
|
|
denselben echten Lock daher nicht gleichzeitig erwerben und über den neuen
|
|
Helperstart halten. Empfohlener enger Pfad: alter Helper prüft Originalgrant
|
|
und verbraucht genau einmal, speichert immutable Delegations-/Ownerintent;
|
|
stabiler Updater übernimmt denselben Ledger ausschließlich während bestätigtem
|
|
Helperstop, prüft/tauscht Code+Pins und gibt die Ownership vor dem neuen
|
|
Helperstart ausdrücklich zurück. Der neue Helper hält danach wieder seinen
|
|
bestehenden Guard. Kein globaler Umbau zu schwächeren Locks pro Einzelrequest.
|
|
|
|
Vorhandene IPC vertraut ausschließlich dem Netzwerkagenten: Linux verweigert
|
|
Root-Peers ausdrücklich (`privileged-helper/src/main.rs:92`), Windows bindet
|
|
Agent-Service-SID/SCM-PID/Peerimage (`agent-windows/src/helper_ipc.rs:227`).
|
|
Ein Updater darf sich nicht als dieser Agent ausgeben. Er benötigt eine neue
|
|
eng typisierte **lokale Participantbindung** mit festem eigenem Dienst,
|
|
UID/SID, tatsächlichem PID-/Image-/Prozessgeburts-/Policybeleg und ausschließlich
|
|
Original-Handoff, Healthbezug und Finalisierung dieses einen Versuchs. Root
|
|
oder SYSTEM allein sind kein ausreichender Peerbeleg. Bestehende ACL-/FileID-
|
|
Prüfungen dürfen dabei nicht stillschweigend gelockert werden.
|
|
|
|
Gemeinsames erhaltenes Helperledger und aktueller Sync-Wirevertrag reichen für
|
|
die Historie grundsätzlich; eine zweite ungebundene Server-Journal-ID ist
|
|
für diesen Pfad nicht erforderlich. Ein negativer aktueller SignedSync ist
|
|
nur Kontrollkettennachweis. Zusätzlich vorgeschlagen: ein **evidenz-only**
|
|
signierter `UpdateHealthReceipt` mit eigener Domäne, Originalplan/Job/Versuch/
|
|
Grant, Manifest/Codepaar/Pins, Ownernonce, Boot/Verbindung, tatsächlich
|
|
angewandtem SignedSync und frisch serverseitig gespeicherten Inventarbelegen.
|
|
Er ist weder ExecutionPermit noch Startlease, reaktiviert keine Genehmigung
|
|
und verlängert weder Originalstart- noch Health-/Gesamtdeadline.
|
|
|
|
Erst nach unabhängigem lokalem Code-/Peer-/Intenterhaltungsnachweis und gültigem
|
|
Receipt dürfte der neue Helper das **noch ausstehende ursprüngliche** definitive
|
|
Outcome create-once speichern. Originale Signaturen/Events bleiben erhalten;
|
|
generisches Ersetzen eines vorhandenen Unknown-Outcomes ist ausdrücklich
|
|
ausgeschlossen (`ledger::persist_outcome`/Completion-CAS). Anschließend sollen
|
|
vorhandene Helper→Agent-Spiegelung und normaler signierter Abgleich die gleiche
|
|
Outcome-Bytefolge übernehmen und gezielt entsperren
|
|
(`agent-core/src/reconcile.rs:898`, `helper_reconcile.rs:616`). Die vorhandenen
|
|
Reboot-Sonderregeln für geänderte Outcomebytes werden nicht auf Updates
|
|
verallgemeinert (`helper_reconcile.rs:1312`, `reconcile.rs:1237`).
|
|
|
|
Vor Applycode sind Pending-/Inflight-Lebenszyklus, Ownershipwechsel, neue lokale
|
|
IPC-/ACLbindung und die rein beweisende Receiptsemantik normativ zu prüfen.
|
|
Dieser Befund ist **keine Freigabe oder Implementierung** dieser Erweiterungen.
|