Implement guarded Linux updater runtime and compatible baseline tooling
Rust development slice / linux (push) Failing after 8s

This commit is contained in:
2026-11-16 15:25:46 +01:00
parent 6497c79a91
commit 96a2b6e5ae
44 changed files with 6986 additions and 1024 deletions
+90
View File
@@ -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.