238 lines
15 KiB
Markdown
238 lines
15 KiB
Markdown
# 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.
|