Implement guarded Linux updater runtime and compatible baseline tooling
Rust development slice / linux (push) Failing after 8s
Rust development slice / linux (push) Failing after 8s
This commit is contained in:
@@ -160,3 +160,93 @@ Ein eigener Runner ist ausschließlich für zwei eigene native Prozessfixtures
|
||||
vorbereitet; er ist noch nicht ausgeführt. Details, frühere fehlgeschlagene
|
||||
Fixtureprüfung und verbleibende MVP-Gates stehen im
|
||||
[Readercensusnachweis](agent-updater-reader-census-results.md).
|
||||
|
||||
## Quellenfortschreibung 2026-11-16: Full-Admission und stabiler Linux-Daemon
|
||||
|
||||
Die zuvor fehlende Quellverbindung enthält jetzt einen getrennten festen
|
||||
`rmm-agent-updater --serve`-Einstieg und eine Systemd-Vorlage. Der Dienst erhält
|
||||
keine Jobfreigabe-API. Die vorhandene Full-Helperstrecke prüft die vollständig
|
||||
vorab geladenen Agent-/Helperdateien unabhängig vom Netzwerkagenten und legt
|
||||
vier exakt gebundene Root-Stages an. Erst danach speichert die bestehende
|
||||
HelperSync-Transaktion unter derselben Original-Executorsperre Consumption,
|
||||
Startzeuge, Handoff, Delegation und StopIntent atomar. Die Antwort
|
||||
`agent_update_handoff_accepted_v1` ist ausdrücklich kein Outcome und enthält
|
||||
`ready=false` und `terminal=false`. Der Helper antwortet zuerst dem Agenten;
|
||||
erst anschließend aktiviert er einmal den tatsächlich gebundenen Updater.
|
||||
Die Cloud-VM wurde dadurch noch nicht aktualisiert.
|
||||
|
||||
Die Quellstrecke erhält auch den aktuellen TLS-Selektor und die tatsächlich
|
||||
aktive Zertifikatsversion anhand von Dateimetadaten. Sie liest dabei keine
|
||||
privaten Schlüsselbytes. Ein fester, descriptor-relativ geöffneter
|
||||
Agent-Cachepfad bleibt auf UID 993 und den bestehenden privaten Agent-Statebaum
|
||||
beschränkt; die Root-Installationsverzeichnisse behalten ihre eigene strenge
|
||||
Root-Pfadauflösung.
|
||||
|
||||
Der zusätzliche Full-Aufruf `update_observe_v1` ist ausschließlich lesend.
|
||||
Er prüft die tatsächliche HelperSync-Lease, Baseline/Release-Trust, Historie,
|
||||
Floor, feste Dienstgenerationen, Readerregistry und den laufenden Updater.
|
||||
Ein optionaler Kandidat wird als ursprünglicher ReleaseEnvelope mit eigener
|
||||
Keyringgeneration entgegengenommen und unabhängig geprüft. Erst danach rendert
|
||||
Full die genaue Kandidaten-Konfiguration und den Pin für die spätere
|
||||
WebUI-Anzeige. Katalogmetadaten allein liefern keinen CandidatePreview. Der
|
||||
Aufruf lädt keine Binärdateien, legt keine Stage an und schreibt keine
|
||||
Start-/Handoff-/Ready-Zeile.
|
||||
|
||||
Der V2-Rückweg ist im Linux-Worker für den konkret unterscheidbaren Fall eines
|
||||
nach einmal bestätigt dispatchtem Start gescheiterten neuen Full-Helfers
|
||||
verbunden. Ein vorher im ersten LedgerReturnIntent reservierter bedingter Stop
|
||||
beendet ausschließlich die tatsächlich gehaltene neue General-Generation.
|
||||
Agent/Full ohne erfolgreichen Start erhalten getrennte negative Belege und
|
||||
keine erfundenen erfolgreichen Stops. Erst nach beendetem Reader, beiden
|
||||
ursprünglichen Sperren und erneutem vollständigen FD-/maps-Census öffnet der
|
||||
Updater wieder das Originalledger. Die vier Dateien werden in Gegenrichtung
|
||||
über getrennte create-once Intents zurückgeführt; Kandidat und Vorgänger bleiben
|
||||
erhalten. Ein tatsächlich neu gestarteter Vorgänger-Full muss die ursprüngliche
|
||||
signierte Healthstrecke erneut bestehen. Sein abschließendes Updateergebnis ist
|
||||
`failed / AGENT_UPDATE_RETURNED_TO_PREDECESSOR`; der ursprüngliche aktive Record
|
||||
und Floor werden nicht neu publiziert. Verlorene Antworten, unklare Renames,
|
||||
automatischer Restart und nicht nachgewiesene Dienstzustände bleiben gesperrt.
|
||||
Andere Startup-/Healthfehlerpfade sind durch diese Quellenfortschreibung noch
|
||||
nicht als real ausgeführte Wiederherstellung qualifiziert.
|
||||
|
||||
Bei der Verbindung wurde ein konkreter Dienstbeobachtungsfehler korrigiert:
|
||||
der Systemd-Aufruf fragt sieben Eigenschaften ab, der bisherige Parser verlangte
|
||||
acht. Der Parser verlangt jetzt genau die tatsächlich angefragten sieben Namen
|
||||
und verweigert fehlende, zusätzliche und doppelte Eigenschaften.
|
||||
|
||||
Lokal tatsächlich ausgeführt: Helperbibliothek 42/42 bestanden, einschließlich
|
||||
des neuen typisierten Handoff-Acknowledgement-Gegenfalls. Der erste breite Lauf
|
||||
hatte sechs APT-Fixturefehler wegen des fehlenden privaten Verzeichnisses
|
||||
`/tmp/opencode`; mit diesem Fixtureverzeichnis bestanden alle 42. Ein erster
|
||||
Updater-Linux-Lauf bestand 5/7 und scheiterte bei zwei Dateifixtures am absichtlich
|
||||
schreibgeschützten Container-`/run`. Diese Fehlversuche sind kein nativer
|
||||
Zielnachweis. Der weitere Quellencheck und die getrennte reale Linux-first-
|
||||
Abnahme werden separat ergänzt. Keine Applycapability und kein erfolgreicher
|
||||
Cloud-Apply werden aus diesen lokalen Ergebnissen abgeleitet.
|
||||
|
||||
Mit privaten Container-Tmpfs für `/tmp`, `/run` und `/var/lib` bestand anschließend
|
||||
der vollständige betroffene Lauf: Helper 42, Updater-Linux 7, Worker 12, insgesamt
|
||||
61 bestanden, 0 Fehler, 0 ignoriert. Zuvor scheiterte zusätzlich ein Workerfixture am
|
||||
schreibgeschützten Container-`/var/lib`; auch diese Ursache wurde durch die
|
||||
korrekte eigene Fixtureumgebung beseitigt. Der abschließende all-targets-Clippy-
|
||||
Lauf für Helper und Worker mit `-D warnings` und `git diff --check` bestand.
|
||||
Diese Tests enthalten ausdrücklich Containerfixtures mit festen privaten
|
||||
Statepfaden; die vollständigen Testbinaries dürfen deshalb nicht gegen die
|
||||
bestehenden installierten Statepfade der Cloud-VM gestartet werden. Der reine
|
||||
Sieben-Eigenschaften-Parsertest benötigt keine Systemd-/Dateieffekte.
|
||||
|
||||
Die zusätzliche ursprüngliche Updater-Zeitgeneration und der tatsächlich
|
||||
angewandte Pre-Stop-Syncbeleg sind separat in
|
||||
[Originalzeitgeneration](updater-original-time-generation.md) beschrieben.
|
||||
Auch diese Quellverbindung ist noch keine reale Applyabnahme.
|
||||
|
||||
Am 16. November wurde die öffentliche deterministische Recordzusammensetzung
|
||||
in `rmm-domain::agent_update_provisioning::assemble_updated_record` gemeinsam
|
||||
genutzt. Sie liefert ausschließlich bereits öffentliche Recordmetadaten;
|
||||
die privaten nativen BuiltRecord-Konstruktoren behalten ihre unabhängigen
|
||||
Original-/Healthsignatur- und Guardprüfungen. Der Linux-Namespacevertrag
|
||||
bleibt unverändert. Tatsächliche isolierte Nachprüfung: Agent und Worker
|
||||
mit allen Targets/Clippy `-D warnings` bestanden; beide bestehenden
|
||||
Record-Namespaceprüfungen (Originalinode/Archive sowie Ablehnung fremder
|
||||
Dateiidentitäten) bestanden, 2/2, keine ignoriert. Dafür wurde ausschließlich
|
||||
der private Container-`/run`-Scratch verwendet, keine VM-Datei verändert.
|
||||
|
||||
@@ -0,0 +1,237 @@
|
||||
# Linux-Updater: erhaltender Bootstrap und erste reale Abnahme
|
||||
|
||||
Stand 16. November 2026. **Plan und tatsächliche lesende Vorprüfung; noch keine
|
||||
Installation, kein Dienstwechsel und kein Apply.** Der koordinierende
|
||||
Rootprozess führt Zieländerungen und WebUI-Abnahmen durch. Die neue Datei
|
||||
`deploy/linux_updater_bootstrap.py` besitzt ausschließlich `inspect` und lokale
|
||||
Paketvorbereitung `prepare`; sie implementiert keinen versteckten Applymodus.
|
||||
|
||||
## Tatsächlich gelesen
|
||||
|
||||
`python3 deploy/linux_updater_bootstrap.py inspect` las die bestehende
|
||||
Cloud-Linux-VM über den vorhandenen streng geparsten SSH-Zugang mit bestätigtem
|
||||
Hostschlüssel. Der private Originalbeleg liegt in
|
||||
`devstate/linux-updater-bootstrap/eb9ad00e-0229-4ebf-8ba4-09861bb246c5/read-only.json`.
|
||||
Boot: `45aba743-be1d-4ae5-ba00-139fb9363bfe`.
|
||||
|
||||
| Gegenstand | Tatsächlicher Zustand |
|
||||
|---|---|
|
||||
| Agent | aktiv/enabled, SHA256 `0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f` |
|
||||
| General/Full | beide aktiv, gemeinsame Binary `79442727c3ba31cda02a8bc0e67481f14db9f39fc07520a880a90b64f10f1eaf`; General enabled, Full disabled |
|
||||
| Updater | Unit, Binary, Konfigurations- und Stateverzeichnis fehlen |
|
||||
| APT/Legacy | inaktiv/disabled, keine beobachteten General-Rollbacktimer |
|
||||
| Agentjournal | 30 Aufträge, kein offener Auftrag, kein Fault, Integrität ok |
|
||||
| Agentverbrauch | 27 Verbräuche und 27 Startzeugen, kein offener Verbrauch |
|
||||
| Rootverbrauch | 19 Verbräuche und 19 Startzeugen, kein offener Verbrauch/Fault |
|
||||
|
||||
Die Root-Evidenzaggregate blieben lesend gebunden an
|
||||
`def53ce39f60ebe6815352df2ef1980d5170569519bbca0a9e132d3eecb470d1`,
|
||||
die Agent-Evidenz an
|
||||
`61e54815aecb8b5625ff7a8e5b09a5a509ba39d23f3682ad5c969bcb93ff7836`.
|
||||
Dies sind Hashes der auf dem Ziel gehashten Originalstart-/Outcomebytes mit
|
||||
Grantbezug, kein Export von Jobausgaben. Die Vorprüfung exportiert ausschließlich
|
||||
öffentliche Konfigurationsfelder, feste Unit-/Binärhashes und Dateimetadaten.
|
||||
Private Schlüssel und Agentumgebungsdatei wurden ausschließlich `stat`-geprüft.
|
||||
Die vorhandenen Datenbanken wurden read-only im tatsächlich vorhandenen
|
||||
DELETE-Journalmodus geöffnet; es entstanden keine WAL-/SHM-Sidecars.
|
||||
|
||||
Der erste lesende Versuch stoppte beim Stabilitätsvergleich einer öffentlichen
|
||||
Datei, weil der Vergleich auch die durch Lesen veränderliche atime einschloss.
|
||||
Die Korrektur vergleicht Identität, Größe, mtime und ctime; der nächste vollständige
|
||||
Read bestand. Der TLS-Selektor wird anhand seines tatsächlichen Felds `version`
|
||||
behandelt. Kein fehlgeschlagener Read wurde als Bootstraperfolg ausgegeben.
|
||||
|
||||
## Verbindliche Reihenfolge
|
||||
|
||||
Die bisherigen Images sind kein geeigneter Rückfall für den neuen Updater:
|
||||
ihnen fehlen Decoder-/Owner-/Healthteile. Deshalb zunächst **kompatible neue
|
||||
Baseline**, erst anschließend ein separat genehmigtes Update auf andere Bytes.
|
||||
„Release 0“ bezeichnet unten die Baselinegeneration mit positiver Sequenz 1;
|
||||
Sequenz 0 ist im Releasecodec ungültig.
|
||||
|
||||
1. Den gemeinsamen Quellsatz einfrieren. Agent, Helper und stabilen Updater für
|
||||
Linux x86-64 bauen, genaue Quellen-/Listen-/Hashbelege aufbewahren und die
|
||||
dafür vorgesehenen nicht destruktiven Vertragsprüfungen zuerst auf der
|
||||
tatsächlichen Cloud-Linux-VM ausführen. Containerfixtures, die feste vorhandene
|
||||
Agent-Statepfade voraussetzen, dort ausdrücklich nicht starten.
|
||||
2. Einen frischen Ziel-CAS und den zentral geschlossenen Devtestscope prüfen.
|
||||
Agent, General und Full in einem begrenzten administrativen Dienstwechsel
|
||||
stoppen; APT/Legacy bleiben geschlossen. Beide ursprünglichen Sperren halten.
|
||||
DB-Dateien, Identität, PKI und sämtliche Originalzeilen/Outcomebytes erhalten.
|
||||
Alte Binaries create-only als historische Bootstrapbelege aufbewahren.
|
||||
3. Die kompatiblen neuen Agent-/Helperbytes an den bisherigen festen Zielpfaden
|
||||
bereitstellen und den Full-Konfigurations-/Policy-/Binärpin auf genau diese
|
||||
Helperbytes binden. Generalpolicy und Generalpin bleiben erhalten. Keine
|
||||
APT-Rezept-/Proofanpassung und kein Paketjob. Eine geänderte gemeinsame
|
||||
Helperbinary ist **kein** neuer APT-Laufzeitqualifikationsnachweis.
|
||||
4. General, Full und Agent genau einmal starten, tatsächliche neue PID/Birth/
|
||||
Image-/Unitzeugen lesen, normale signierte Agent-/Helpersynchronisierung und
|
||||
passives Inventar nachweisen. Erst daraus den öffentlichen tatsächlichen
|
||||
Baselinequalifikationsbeleg bilden; er enthält keinen Hash einer noch zu
|
||||
erzeugenden Baseline/Registry/Policy, sodass keine Hashzirkularität entsteht.
|
||||
5. Auf dem Server getrennte Release-/Baselinesignier- und Healthschlüssel
|
||||
erzeugen. Keine privaten Schlüssel verlassen den Server. Der Releasekey
|
||||
bleibt Root vorbehalten; der separate Healthkey wird ausschließlich dem
|
||||
vorhandenen unprivilegierten Gateway-Dienst als geschützte PEM-Datei zugänglich
|
||||
gemacht. Der tatsächliche Handler `/agent/v1/update-health` läuft im Gateway.
|
||||
Job- und Zeitsignierer werden nicht wiederverwendet.
|
||||
6. Release-0-Manifest exakt für die kompatibel installierten Agent-/Helperbytes
|
||||
signieren, daraus den kanonischen Initialrecord mit Sequenz/Floor 1,
|
||||
tatsächlicher Aktivierungszeit, Bootstrapqualifikationshash und
|
||||
`rolled_back=false` bilden und separat signieren. Identität und bestehende
|
||||
Journale werden nicht durch diese Recorddatei ersetzt.
|
||||
7. Die neue feste Updaterunit installieren, reale Unit-Inodes/Kompositionen
|
||||
nachlesen und die vollständige 21-Unit-Registry plus tatsächliche etwaige
|
||||
Rollbacktimer erzeugen. Geschützte Registry enthält den Baselinebeleg und
|
||||
den unveränderten Readervertrag; dazu die tatsächlichen PID-/User-/Cgroup-
|
||||
Namespace-/Procidentitäten. Erst dann Registryhash und signierte Baseline
|
||||
in der lokalen Policy binden. Keine Unit-Pins aus einem Quelltext statt der
|
||||
tatsächlich installierten Dateien übernehmen.
|
||||
8. Den Updater einmal als eigenes Root-Systemd-Programm starten; sein eigener
|
||||
PID/Birth/Image/Unitbeleg muss passen. Danach den Full-Aufruf
|
||||
`update_observe_v1` als tatsächlicher UID-993-Agent prüfen. Nur daraus
|
||||
gültige Apply-/Checkcapabilities und CandidatePreview veröffentlichen.
|
||||
9. Release 1 als tatsächlich neue Codepaarbytes bauen, beispielsweise aus
|
||||
demselben eingefrorenen Runtimequellsatz mit sauberer Version 0.1.1 und
|
||||
eigener nachvollziehbarer Buildprovenienz. Der bereits gebundene stabile
|
||||
Updater bleibt unverändert. Full rendert den neuen Konfigurations-/Pinwechsel
|
||||
aus dem unabhängig geprüften Kandidaten. Veröffentlichung im bestehenden
|
||||
Tenantkatalog erzeugt noch keinen ausführbaren Job.
|
||||
10. MCP muss einen persistenten `pending_approval`-Plan für genau diese Bytes
|
||||
erstellen. Der tatsächliche sichtbar simulierte Devtest-WebUIprincipal
|
||||
genehmigt interaktiv. Vorher keine Jobwirkung oder Startgrants. Danach
|
||||
genau einen ursprünglichen Verbrauch, Staging, Stop/Lock/Census/Swap/Start,
|
||||
neuen unabhängigen signierten Sync-/Baseinventar-Healthbeleg und endgültigen
|
||||
Originalrecord-/Floor-/Outcomestand prüfen. Nach diesem Abnahmeschritt
|
||||
Dokumentation und Code nach Gitea pushen.
|
||||
|
||||
## Pfade und Berechtigungen
|
||||
|
||||
| Pfad | Geplante Bindung |
|
||||
|---|---|
|
||||
| `/usr/local/libexec/rmm-agent-updater` | qualifiziertes stabiles ELF, Root:Root, 0755; nie Teil des Job-Codepaars |
|
||||
| `/etc/systemd/system/rmm-agent-updater.service` | feste geprüfte Rootunit, 0644, kein automatischer Wiederanlauf eines unsicheren Handoffs |
|
||||
| `/etc/rmm-agent-updater` | Root:Root, 0755; keine Schreibrechte für Agent/Gruppe/Andere |
|
||||
| `binding.json` dort | vorhandenes öffentliches Binding, Root:Root 0600 |
|
||||
| `policy.json`, `keyring.json`, `health-key.json` dort | öffentliche geschützte Trustmetadaten, Root:Root 0644 |
|
||||
| `reader-registry.json`, `retained-files.json` dort | feste lokal provisionierte tatsächliche Belege; Root besitzt die Schreibautorität |
|
||||
| `/var/lib/rmm-agent-updater` | ursprünglicher privater Record-FS-Vertrag: Root:Root 0700 |
|
||||
| `installed-record.json`, Recordarchive/Handoffs | private Rootdateien/-verzeichnisse, 0600/0700; keine öffentliche Projektion |
|
||||
| Agentcache | fester vorhandener UID-993-Statebaum; neue Unterverzeichnisse 0700, Prefetchdateien 0600 |
|
||||
|
||||
Der Agent erhält die **öffentlichen Recordbytes** über dieselbe authentisierte
|
||||
Full-Antwort wie den aktuellen gemessenen Zustand. Hash, Binding und exakte
|
||||
Predecessor-/Floorwerte werden geprüft. Der bestehende private Recordport wird
|
||||
hierfür nicht auf öffentliche Dateirechte umgestellt. Full schreibt dabei nichts.
|
||||
|
||||
Die Retainedliste bindet mindestens die drei bestehenden DB-Dateien, zwei
|
||||
ursprünglichen Locks, öffentliche Binding-/Identitäts-/Jobkeydateien, die
|
||||
Original-PKI-Dateien sowie den tatsächlichen TLS-Selektor und die aktuell aktive
|
||||
TLS-Version. Für Schlüssel ausschließlich Dateimetadaten, nie Schlüsselbytes.
|
||||
Unit-/Binär-/Trustdateien erhalten ihre getrennten eigenen Hash-/FD-Pins.
|
||||
|
||||
## Bekannter kontrollierter Fehlerfall
|
||||
|
||||
Der vorbereitete Linuxrückweg qualifiziert zunächst einen tatsächlich gescheiterten
|
||||
neuen Fullstart nach bereits erfolgreichem Generalstart. Ein allgemeines
|
||||
`exit 1`-Helperfixture genügt dafür nicht: dieselbe Binary bedient beide Rollen
|
||||
und würde bereits General scheitern lassen. Ein separater privater, signierter
|
||||
Fixturequellsatz muss General normal bedienen und ausschließlich den neuen
|
||||
Fullstart vor Arbeitsaufnahme eindeutig beenden; kein Produktions-Failureflag
|
||||
oder versteckter ausführbarer Sonderkanal wird dafür eingeführt.
|
||||
|
||||
Die derzeitige Fullunit hat `Restart=on-failure` mit 5 Sekunden. Ein solcher
|
||||
weiter geplanter automatischer Wiederanlauf ist kein bekannter geschlossener
|
||||
Fehler. Für diesen Test muss bereits **vor Baseline/Registry** ein ausdrücklich
|
||||
geprüfter `Restart=no`-Full-Override zum qualifizierten kompatiblen Setup gehören,
|
||||
oder ein tatsächlich terminaler Startlimitfall unabhängig bewiesen sein.
|
||||
Eine nachträgliche ungepinnte Unitänderung während des Updatejobs ist verboten.
|
||||
Die tatsächlichen negativen Start-/Stopbelege, Rückführung beider Codeversionen,
|
||||
Originalfristen sowie frisch signierte Vorgänger-Health müssen anschließend
|
||||
nativ bestehen. Unklare Rename-/Socket-/Startantworten bleiben Unknown und
|
||||
werden weder wiederholt noch als bekannte Rückführung ausgegeben.
|
||||
|
||||
## Stand der Ausführung
|
||||
|
||||
Tatsächlich abgeschlossen sind der lesende Zielbeleg, lokale
|
||||
Python-Syntaxprüfung der Vorbereitung und das unten abgegrenzte lokale Buildpack.
|
||||
Quell- und Containerprüfungen der Runtime
|
||||
stehen separat in [Runtimequellen](agent-updater-runtime-source.md). Bootstrap,
|
||||
Schlüsselprovisionierung, neuer Dienststart, passiver qualifizierter Fullbeleg,
|
||||
WebUI-genehmigter Apply und native Rückführung sind **geplant, nicht ausgeführt**.
|
||||
|
||||
## Eingefrorenes Linux-Buildpack, tatsächlich lokal gebaut
|
||||
|
||||
`deploy/linux_updater_qualification.py build` erstellte den unveränderten Fall
|
||||
`devstate/linux-updater-qualification/21d20391-6102-4996-8a7a-efbd3e78bd7d`.
|
||||
615 öffentliche Eingabedateien wurden mit vorherigem/nachherigem Hashvergleich
|
||||
eingefroren; Zugangsdaten, Devstate und Schlüssel gehören nicht zum Paket.
|
||||
Source0 verwendet Workspaceversion 0.1.0. Source1 unterscheidet sich ausschließlich
|
||||
in `Cargo.toml` und den erbenden internen Paketversionen in `Cargo.lock` (0.1.1).
|
||||
Externe Abhängigkeiten bleiben exakt gleich. Windowsquellen wurden ausschließlich
|
||||
als Provenienz mitkopiert; dieser Linuxlauf qualifiziert sie nicht.
|
||||
|
||||
Beide Quellsätze bestanden `cargo clippy --locked --offline` mit `--all-targets
|
||||
-- -D warnings` für Agent, Agentcore, Domain, Helper, Linuxupdater, Worker,
|
||||
Handoff und Updatehistory. Source0 linkte Agent, Helper und stabilen Updater als
|
||||
Release; Source1 Agent und Helper. Beide neuen Paarbytes unterscheiden sich
|
||||
tatsächlich von Source0. Der stabile Updater wird ausschließlich aus Source0
|
||||
verwendet. Alle Befehle liefen ohne Netzwerk in Docker mit schreibgeschütztem
|
||||
Sourcebaum, eigenem Targetcache und gepinntem Builder
|
||||
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
||||
|
||||
| Artefakt unter `artifacts/` im Fall | SHA-256 |
|
||||
|---|---|
|
||||
| `source0/rmm-agent` | `61a073f44be95a9e2a9edf816104fa198452f9512bc099b59b4931000fc98b1e` |
|
||||
| `source0/rmm-privileged-helper` | `8fdc6ded02278eb18e64003d0bc7bf45d452cd48ded0450e6e900ca66e44d449` |
|
||||
| `source0/rmm-agent-updater` | `dec6336728eac8af1e0d84d4921c7c9ecbcc45bc4619d357d346b716336be90a` |
|
||||
| `source1/rmm-agent` | `c27319f312294f96583a2ecb14c9b1ed0b54e205c70dcd156ae511a1dc254e63` |
|
||||
| `source1/rmm-privileged-helper` | `89b28db3afe870c667297dff97ad7a042c550ccce1f712d69108e8de672ad450` |
|
||||
|
||||
Manifesthash: `9ed5f153fe76665150aaab298c4b21d74d7199b2312a28fa23aa9e30b13ddd08`.
|
||||
Source0-Archiv: `9b9e16c754f233c8675057aa44f89f86c2574ced0ba9d85d60157402363008de`;
|
||||
Source1-Archiv: `b2bdf4962a1beacf27903263952f4db025dbadfd7705fecc0b02dea3b32dde61`.
|
||||
Die vollständigen Einzeldateimanifeste und exakten Docker-/Cargoargumente samt
|
||||
Exitcodes und Loghashes liegen im Fall. Acht Unit-/Integrationsexecutables
|
||||
wurden gebaut und ihre tatsächlichen Testnamen aufgezeichnet. Nur die im
|
||||
Manifest explizit aufgeführten 18 Filter sind für den nächsten VM-Schritt
|
||||
vorgesehen: sieben zielgerichtete Parser-/Ack-/Sync-/SQLiteverträge und elf reine
|
||||
Handoffverträge. Diese 18 liefen im isolierten lokalen Container erfolgreich.
|
||||
Andere gelinkte Tests sind durch dieses Paket nicht zur Zielausführung vorgesehen.
|
||||
Noch keines dieser Programme wurde durch diesen Buildschritt auf der Cloud-VM
|
||||
ausgeführt; kein Produktdienst oder Zieljournal wurde geändert.
|
||||
|
||||
Diese Aussage beschreibt ausschließlich den damaligen Buildschritt. Der spätere
|
||||
koordinierte native Lauf aller 18 vorgesehenen Filter auf der Cloud-Linux-VM
|
||||
bestand; dessen Originalbelege und Abgrenzung stehen in
|
||||
[Compatible-Linux-Vertragsprüfungen](updater-compatible-linux-contracts.md).
|
||||
Er ersetzt weiterhin keinen tatsächlichen Updaterjob.
|
||||
|
||||
Der erste erhaltene Fall `7c030441-81e0-4235-9565-0b413b0cedae` scheiterte
|
||||
an `items_after_test_module` im Linuxunit-Testtarget. Das Parser-Testmodul wurde
|
||||
ohne Verhaltensänderung ans Dateiende verschoben; der erfolgreiche Fall entstand
|
||||
anschließend aus einem neuen Snapshot. Der fehlgeschlagene Originalbeleg bleibt
|
||||
erhalten.
|
||||
|
||||
## ARM64-Serverbuild, geplant und nicht ausgeführt
|
||||
|
||||
Der Source0-Quellsatz enthält auch den aktuellen Server-/Zeitbrokerquellcode.
|
||||
Für die später separat koordinierte Serverbereitstellung muss dieser exakte
|
||||
Archivhash auf dem ARM64-Server geprüft und jede reguläre Archivdatei gegen
|
||||
`source0-inputs.json` geprüft werden. Der vorhandene ARM64-Rustbuilder wird erst
|
||||
mit `docker image inspect` auf Architektur/OS/Image-ID geprüft und danach über
|
||||
seine tatsächliche Image-ID angesprochen. In einem neuen eigenen Targetcache
|
||||
und ohne Netzwerk sind dort geplant:
|
||||
|
||||
```text
|
||||
cargo clippy --locked --offline -p rmm-server -p rmm-time-broker-linux --all-targets -- -D warnings
|
||||
cargo build --locked --offline --release -p rmm-server -p rmm-time-broker-linux --bins
|
||||
```
|
||||
|
||||
Der Container erhält den verifizierten Quellsatz ausschließlich lesend sowie
|
||||
private temporäre Verzeichnisse. Artefakte müssen anschließend als tatsächliche
|
||||
AArch64-ELFs, mit Hash/Buildlog/Image-ID und unverändertem Eingabemanifest
|
||||
nachgewiesen werden. Keine Dockerfile-APT-Schritte, Netzwerkdownloads oder
|
||||
Abhängigkeitsänderungen sind Teil dieses Plans. Serverdienste, bestehende
|
||||
Ingress-/Broker-/Zeitpins und private Signierschlüssel werden durch einen
|
||||
Build nicht geändert. Der lokale x86-64-Lauf ist kein ARM64-Buildnachweis.
|
||||
@@ -0,0 +1,174 @@
|
||||
# Kompatibler Linux-Updater: konkrete administrative Controller
|
||||
|
||||
Stand 16. November 2026. Die nachstehenden Quellen sind vorbereitet und lokal
|
||||
geprüft. **Kein erhaltender Dienstwechsel, kein Signierschlüssel, kein neuer
|
||||
Updaterdienst und kein Updatejob wurden durch diese Vorbereitung auf einem Ziel
|
||||
ausgeführt.** Die Zielphasen koordiniert der Rootprozess; RMM-Aufträge brauchen
|
||||
weiterhin den tatsächlichen Weg MCP → `pending_approval` → WebUI → Originalgrant.
|
||||
|
||||
## Genau verwendbare Artefakte
|
||||
|
||||
Das unveränderte ursprüngliche Buildpack `21d20391-6102-4996-8a7a-efbd3e78bd7d`
|
||||
bleibt erhalten. Der neue Agent muss zusätzlich die beiden bereits bestehenden
|
||||
Domaincapabilities `agent.update.apply/1` und `agent.update.check/1` nach einem
|
||||
gültigen geschützten Fullobserver melden. Außerdem muss der bestehende
|
||||
60-Sekunden-Tick das fertige Observerergebnis vor seinem Capabilityvergleich
|
||||
abholen. Andernfalls wurde die alte Probe erst nach dem Vergleich geerntet und
|
||||
konnte beim nächsten Vergleich bereits älter als die erlaubten 90 Sekunden sein.
|
||||
Der Tickaufruf wurde verschoben, ohne Samplerate oder Gültigkeitsgrenze zu ändern.
|
||||
|
||||
Beide Änderungen sind in der eigenständigen Derivation
|
||||
`devstate/linux-updater-capability-build/9923a97f-4c8c-4e0a-bbad-4f1d88f0d43a`
|
||||
eingefroren. Manifest-SHA256:
|
||||
`a41ad700b4b7527bf911bf00f2745914188760c631af0c3255364c05f1ef4fbc`.
|
||||
Source0/Source1 verwenden unverändert 0.1.0/0.1.1.
|
||||
|
||||
| Artefakt | SHA256 |
|
||||
|---|---|
|
||||
| Source0 Agent | `7fef8d0f1e2bcf5cd6c373e567a0c17bfb08d8c780cd4d1925b6c1355e572547` |
|
||||
| Source1 Agent | `4d212066bef226af3fa679ffe95f69c43a9668cbef7e665d53328f4e41aa3799` |
|
||||
| Source0 Helper, unverändert aus 21D | `8fdc6ded02278eb18e64003d0bc7bf45d452cd48ded0450e6e900ca66e44d449` |
|
||||
| Source1 Helper, unverändert aus 21D | `89b28db3afe870c667297dff97ad7a042c550ccce1f712d69108e8de672ad450` |
|
||||
| Stabiler Updater, unverändert aus 21D | `dec6336728eac8af1e0d84d4921c7c9ecbcc45bc4619d357d346b716336be90a` |
|
||||
|
||||
Die Derivation verwendet einen eigenen kopierten Buildcache. Beide Agenten
|
||||
bestanden all-targets Clippy mit `-D warnings` und den Releasebuild im gepinnten
|
||||
Offlinebuilder. Alle 18 zuvor nativ geprüften Contractexecutables, Helper und
|
||||
Updater wurden nicht neu gebaut und ihre Originalhashes erneut verglichen.
|
||||
Der frühere reine Capabilitymarker-Fall `f89fbb79-…` bleibt historisch erhalten;
|
||||
er enthält die Tickkorrektur noch nicht und ist hier nicht die Baseline.
|
||||
|
||||
Der separate öffentliche Metadaten-SDK liegt im eingefrorenen Fall
|
||||
`devstate/linux-updater-bootstrap-sdk/d309c949-3a70-4448-88da-49c710093221`.
|
||||
Manifest-SHA256 `cf9464ff21b48b28903369692e3bb63148b2c488297ec709e8fd9c9881448528`,
|
||||
Binary-SHA256 `6fcc543d538fca30ceb499364880e4dc3689700d50597f18bd11bfe3559a0021`.
|
||||
Sein Worker-all-targets-Clippy und Releasebuild bestanden. Er schreibt keine
|
||||
Zieldateien und startet keine Dienste. Er rendert Full über die bestehenden
|
||||
Rusttypen, erzeugt kanonische öffentliche Manifest-/Record-/Policybytes und
|
||||
misst bei `qualify_pair`/`registry` ausschließlich die wirklichen Zielzeugen.
|
||||
Die Bundlecodecoperation kennzeichnet ausdrücklich nur die Formprüfung.
|
||||
|
||||
## Vorbereitete erhaltende Phasen
|
||||
|
||||
`deploy/linux_updater_compatible_apply.py` trennt folgende explizite Phasen;
|
||||
keine Fehlerantwort startet einen bereits begonnenen Schritt erneut:
|
||||
|
||||
1. `prepare`: Nur lesender Original-CAS auf der VM und lokale Paketvorbereitung.
|
||||
Diese Phase wurde tatsächlich ausgeführt. Der lokale Fall
|
||||
`devstate/linux-updater-compatible/ac6cf439-e0a6-4323-82e1-c55df96b2441`
|
||||
enthält `package.json`, den lesenden Vorbeleg und Manifest-SHA256
|
||||
`d3917236c03b93273b4f43f1df3b6773cc04873018262567d3d31510c993c082`.
|
||||
Es wurde noch kein Paket auf der VM bereitgestellt.
|
||||
2. `stage`: Ausschließlich create-only sieben feste geprüfte öffentliche
|
||||
Artefakte in einem neuen Root-700-Fallverzeichnis bereitstellen.
|
||||
3. `install`: Frischen geschlossenen zentralen Scope und null offene Jobs prüfen;
|
||||
echte Original-PIDs halten, Agent/General/Full stoppen, beide Originalflocks
|
||||
halten und alle ursprünglichen DB-Inodes/Start-/Outcomeaggregate bewahren.
|
||||
Vier feste Dateien mit create-only Vorgänger- und Kandidatennamen ersetzen.
|
||||
Alle drei Dienste bleiben danach gestoppt. Bei bestehendem Intent nur lesen.
|
||||
4. `units`: Den stabilen Updater und die feste Unit create-only installieren,
|
||||
Full-Override `Restart=no` vor der Registry bereitstellen, daemon-reload und
|
||||
tatsächlichen inaktiven Updater/Restartzustand prüfen. Keine Dienststarts.
|
||||
5. `start`: General, Full, Agent jeweils genau einmal starten. Das ist zunächst
|
||||
nur ein Dienststart, noch kein Baselinequalifikationsnachweis.
|
||||
6. `qualify`: Der SDK prüft echte PID/Birth/Image-/Unitzeugen und dieselbe frisch
|
||||
signierte normale Agent-/Helpersynchronisierung mit aktuellem NativeClock,
|
||||
unabhängig gepinnten öffentlichen Jobkeys und erhaltener History. Kein
|
||||
vergangener Clockwert und kein administrativer Ready-Ersatz. Die ausgegebene
|
||||
Qualifikation enthält `ready/helper_ready/unlock/job_authority=false`.
|
||||
7. `registry`: Die wirkliche feste 21-Unit-Schließung, etwaige Rollbacktimer,
|
||||
Host-/Namespaceidentitäten und tatsächliche Dateipins zweimal messen. Ein
|
||||
geladener APTdienst verlangt seinen vierten lokalen Servicepin, bleibt aber
|
||||
inaktiv/disabled und erhält keine neue APT-Laufzeitqualifikation.
|
||||
8. `trust`: Kanonische Form nativ mit dem SDK prüfen, Release- und separate
|
||||
Baselinesignatur über genau diese Bytes zusätzlich mit OpenSSL prüfen,
|
||||
aktuelle Artefakt-/Identitäts-/Registrybindungen vergleichen und die festen
|
||||
Trustdateien create-only anlegen. Private Originalkeys werden nur per
|
||||
Metadaten in die Retainedliste aufgenommen, niemals gelesen oder exportiert.
|
||||
9. `updater-start`: Nach vollständiger Trustinstallation den stabilen Dienst
|
||||
genau einmal starten und seinen echten gehaltenen PID/Imagezeugen prüfen.
|
||||
10. `passive-check`: Nur serverseitig lesen. Die wirkliche normale Agentmeldung
|
||||
muss weniger als 90 Sekunden alt sein, gültige Fullobserver-/Syncbezüge,
|
||||
den exakten Vorgänger/Updater/Policy/Keyring/Healthpin und die benötigten
|
||||
Runtimecapabilities enthalten. Es gibt keinen SQL-Schreibersatz für eine
|
||||
fehlende Capability. `readback` holt nach einem verlorenen Transport nur
|
||||
feste öffentliche Belege ab.
|
||||
|
||||
Der vorhandene Generalpin Schema 1 enthält ausdrücklich keinen Binarypin; der
|
||||
Produktcode verlangt hier `helper_binary_sha256=None`. Seine exakten Bytes und
|
||||
Policy bleiben erhalten. Das erlaubt keine Umdeutung des alten Pins zu einem
|
||||
Native-Abnahmenachweis für die neuen Helperbytes. Dafür ist Schritt 6 getrennt
|
||||
notwendig. Der alte APTproof bleibt unverändert und weiterhin geschlossen.
|
||||
|
||||
## Servertrust und Signieren
|
||||
|
||||
`deploy/updater_server_signing_bootstrap.py` ist ein separat aufzurufender
|
||||
Server-Rootbootstrap. Der reine Read `public-separation` wurde tatsächlich
|
||||
ausgeführt: Er las ausschließlich den bestehenden öffentlichen Timepin und
|
||||
verglich ihn mit dem unabhängig geschützten öffentlichen Jobkey. Timepin-Rawhash
|
||||
`c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2`;
|
||||
die beiden tatsächlichen Publickey-SHA256-Werte sind
|
||||
`1d9b8f83191a99d69b435dc69e8c9b52650680e8e02025f3e338e5083924def8` und
|
||||
`4338aabe7e7ba77428e969750a7a5323d7b7349aa52ef7e1a5f24c90be12ca7a`.
|
||||
Der Read erzeugte keine Schlüssel und änderte keinen Dienst. Der öffentliche
|
||||
Beleg und der noch nicht ausgeführte `signer-provision-input.json` liegen im
|
||||
lokalen kompatiblen Bootstrapfall `ac6cf439-…`.
|
||||
|
||||
`provision` erzeugt für Linux und Windows jeweils einen
|
||||
eigenen Release-/Baselineschlüssel. Der globale Healthschlüssel wird nur beim
|
||||
ersten Aufruf erzeugt und später ausschließlich nach unveränderter öffentlicher
|
||||
Provenienz und Schlüsselmetadaten wiederverwendet. Der Aufruf verlangt echte
|
||||
Job-/Zeit-Publickey-SHA256-Werte als Ausschlussliste; Rollenalias-IDs genügen
|
||||
nicht. Kein privater Schlüssel verlässt den Server oder erscheint im Output.
|
||||
|
||||
Releasekeys bleiben Root in 0700/0600. Der tatsächliche Server-Trustreader
|
||||
verlangt den bestehenden Jobkey-Dateiowner 10001 auch für Keyring/Healthdatei,
|
||||
Datei 0600/ein Link und geschützten Elternpfad. Deshalb erhält jede Plattform
|
||||
ein eigenes öffentliches Verzeichnis 10001/0700 mit `keyring.json` 0600.
|
||||
Dieses wird später read-only in API **und** Gateway gemountet; der separate
|
||||
Healthkey wird read-only ausschließlich in das Gateway gemountet. Der Container
|
||||
behält seine vorhandene UID und schreibgeschützte Root-FS. Private Releasekeys
|
||||
werden überhaupt nicht in Anwendungscontainer gemountet.
|
||||
|
||||
Neue statische Serverkonfiguration:
|
||||
|
||||
| Einstellung | Zweck |
|
||||
|---|---|
|
||||
| `RMM_AGENT_UPDATE_LINUX_KEYRING_FILE` | ausschließlich geschützter Linux-Keyring |
|
||||
| `RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE` | ausschließlich geschützter Windows-Keyring |
|
||||
| `RMM_AGENT_UPDATE_KEYRING_FILE` | unveränderter Legacyfallback, nur wenn der Plattformslot fehlt |
|
||||
| `RMM_AGENT_UPDATE_HEALTH_KEY_FILE` | separater Gateway-Healthsignierer |
|
||||
|
||||
Ein vom Netz empfangener Plattformenum wählt ausschließlich einen dieser zwei
|
||||
fest konfigurierten Pfade. Ein leerer/relativer expliziter Plattformslot wird
|
||||
verweigert. Danach gelten weiterhin sämtliche Signatur-, Plattform-, Revocation-,
|
||||
Generation- und Original-Rawhashprüfungen. Ein gemeinsamer Mehrplattformkeyring
|
||||
würde die bestehenden streng plattformgebundenen Clients nicht erfüllen;
|
||||
deshalb wird deren Trustvertrag nicht gelockert. Die beiden gezielten
|
||||
Serververträge bestanden mit echten lokalen Ed25519-Signaturen für beide
|
||||
Plattformen und negativen Kreuzkeyring-/Signatur-/Revocation-/Generation-/
|
||||
Rawhashfällen; Server-all-targets-Clippy bestand ebenfalls. Diese Quellen
|
||||
brauchen noch einen neuen, getrennt koordinierten ARM64-Imagebuild/Deploy.
|
||||
|
||||
`deploy/linux_updater_public_materials.py` verwendet den sealed SDK für
|
||||
`release-input`, `record-input`, `trust-package`. Es signiert nichts. Der Server
|
||||
signiert ausschließlich die zwei fest qualifizierten Linux-Codepaare und die
|
||||
Initialbaseline mit dem tatsächlichen Qualifikationshash. Ein Ausgabe-JSON ist
|
||||
keine lokale Vertrauensquelle. Die kanonischen Manifestcodec-Rundläufe für beide
|
||||
wirklichen Linux-Artefaktpaare und Python-Syntaxprüfung aller drei Controller
|
||||
bestanden lokal; dabei wurden weder Schlüssel noch Signaturen erzeugt.
|
||||
|
||||
Windows-GNU-Artefakte werden ausdrücklich nicht als kanonische Windows-MSVC-
|
||||
Releases signiert. Die tatsächliche MSVC-Qualifikation ist ein eigener offener
|
||||
Schritt. Das ändert weder das Linux-first-Gate noch einen Plattformvertrag.
|
||||
|
||||
## Danach noch tatsächlich abzunehmen
|
||||
|
||||
Die beschriebenen Zielphasen sind weiterhin auszuführen. Neue Servermounts,
|
||||
plattformbezogener Keyring, Gateway-Healthkey, enger Update-Denyscope und
|
||||
Tenantkatalog müssen anschließend konkret und mit erhaltenen Composepins
|
||||
bereitgestellt werden. Erst dann folgen der tatsächlich über MCP beantragte
|
||||
und in der WebUI genehmigte Linux-Updatejob, dessen Originalverbrauch,
|
||||
Codepaarwechsel, signierte Health und endgültiger Record/Floor sowie der
|
||||
bekannte geschlossene Fullstart-Fehlerfall mit erhaltender Rückführung. Lokale
|
||||
Codec-/Build-/Syntaxbelege ersetzen diese nativen Abnahmen nicht.
|
||||
Reference in New Issue
Block a user