Files
rust-discovery/docs/agent-updater-native-contracts.md
2026-11-14 16:27:22 +01:00

92 lines
5.5 KiB
Markdown

# Reinen Updater-Prüfkern zuerst auf Cloud-Linux qualifizieren
Stand 2026-11-14: Runner implementiert, lokal vorbereitet und anschließend vom
Eltern-Orchestrator **auf der Cloud-Linux-VM ausgeführt:9/9 bestanden**.
Dieser Schritt prüft ausschließlich die neun bereits lokal
bestandenen Verifierverträge. Er installiert weder Updater noch Agent/Helper,
öffnet keine Capability und führt keine Update-/Installer-/Skript-/RMM-Jobs aus.
`deploy/agent_updater_contract_acceptance.py` bindet den unabhängig geprüften
Kerncommit `cc5c93596d0864c526b69a4f7efca805599b6ea1`, bestehende lokale
Qualification, Sourcehashes und unveränderte Testexe. Änderungen an späterer
Dokumentation erzeugen keinen falschen Rebuildbedarf. NativeDriver und die
wiederverwendeten geprüften SSH-/Receipt-Helpers erhalten eigene Sourcehashes.
Ein neuer Driverstand macht alte vorbereitete Manifeste absichtlich ungültig.
Tatsächlich lokal ausgeführt:
```text
python3 deploy/agent_updater_contract_acceptance.py --help
python3 deploy/agent_updater_contract_acceptance.py prepare-local --qualification /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater/local-qualification.json
```
Das bestehende Testimage wurde **nicht neu gebaut oder erneut ausgeführt**.
Originalbytes wurden create-only in den neuen geschützten Vorbereitungsordner
kopiert. Nur `readelf` lief im gepinnten Offline-Dockerimage. ELF-x64, maximale
GLIBC2.34 und benötigte dynamische Bibliotheken wurden ermittelt; native
Lader-/Ausführungsfähigkeit bleibt bis zum VM-Lauf offen.
Lokales Manifest:
`devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json`,
SHA256 `a7f0903cea77c36c4d40df5ad486161c10e55bb9a9135629a555ffafd411d521`.
Testexe unverändert1544584Bytes, SHA256
`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`.
Python-/erzeugte Remotequellsyntax sowie sechs Ergebnis-Verweigerungsfälle,
Readback-ohne-Upload/-Run und fehlendes Native-Opt-in wurden lokal mit
Transport-Mocks geprüft; keine SSH-Verbindung und kein erneuter Unitlauf.
**Anschließend tatsächlich durch den Eltern-Orchestrator ausgeführt:**
```text
python3 deploy/agent_updater_contract_acceptance.py linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests
```
Der Runner liest erst bei diesem expliziten Aufruf die bereits vorhandene streng
geparste Linuxzugangskonfiguration aus dem Maincheckout. Ausschließlich der feste
Cloudclient als root auf der festgelegten Linux-Test-VM, vorhandener SSH-Key und bestätigter Hostkey sind
zulässig. Keine Zugangsdaten im Argument-/Ergebnispayload oder Chat.
Remote wird ein neuer rootprivater Fall unter
`/var/lib/rmm-agent-updater-contracts/<UUID>` einmal angelegt. Die exakt gehashte
Testexe muss vor Start alle neun erwarteten Testnamen melden. Sie läuft mit
geleerter Umgebung, eigener Scratchdirectory, Netzwerknamespace und CPU-/RAM-/
Outputlimits. Vor dem einzigen Lauf steht der dauerhafte Create-once-Startmarker.
Bei verlorenem Reply niemals `linux` erneut ausführen oder neu hochladen.
Die ursprüngliche UUID steht im lokalen
`devstate/agent-updater-native/<UUID>/intent.json`; anschließend ausschließlich:
```text
python3 deploy/agent_updater_contract_acceptance.py readback-linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case <ursprüngliche-UUID>
```
Readback liest Ergebnis oder tatsächlichen Teilstatus desselben Falls. Es darf
weder Upload noch Unitstart fortsetzen. Fehlender/unklarer Abschluss bleibt
`verified=false`, `retry_allowed=false`. Erst vollständig geprüfte Original-
Ergebnisse9/9 ohne Skip schreiben `linux-passed.json`. Dieser Nachweis ist auch
dann **nur native Kernqualifikation**, keine erfolgreiche Agentaktualisierung,
WebUI-Abnahme, Windowsqualifikation oder Produktdienst-/Capabilityfreigabe.
## Tatsächlicher Cloud-Linux-Nachweis
Rootfall `420d53da-6e34-4e04-b871-0b571d8d3fc4` auf dem festgelegten Cloudclient
der Linux-Test-VM: Der Runner prüfte zuerst die vollständige tatsächliche Liste
der neun erwarteten Tests und führte danach exakt diese neun ohne Skip aus.
Exitcode0, kein Timeout und keine Fehlerausgabe. Geleerte Umgebung,
Netzwerknamespace und unveränderte gehashte Originaltestexe sind im Ergebnis
gebunden. Keine Produktzustandsänderung und kein RMM-Job durch diese Units.
Der geschützte lokale Beleg `linux-passed.json` neben dem oben genannten
Manifest wurde zurückgelesen und unabhängig gegen erwarteten Fall,
Manifest-/Artefakthashes und alle neun Testnamen geprüft. Proof-SHA256:
`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`.
Die tatsächliche VM-Ausführung erfolgte durch Root; der Verifier-Subagent
führte weiterhin keine eigene SSH-/VM-Aktion aus.
Damit ist der **reine Linux-Prüfkern nativ qualifiziert**. Der danach getrennt
ausgeführte Windows-GNU-Schritt bestand ebenfalls9/9; tatsächlicher Beleg und
Grenzen stehen in [Windows-Kernqualifikation](agent-updater-windows-contracts.md).
Selbstupdateinstallation,
Releasekatalog/Streamingtransport, feste Plan-/Grant-/WebUI-Bindung,
Updaterprozess und Code-/Pin-Aktivierung/Health/Rollback bleiben unverändert
offen. Dieser Erfolg bescheinigt keinen vollständigen Agent-Autoupdater.