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

5.5 KiB

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:

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:

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:

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. 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.