Roll existing Linux helper pins forward with the verified release pair

This commit is contained in:
2026-11-18 10:23:43 +01:00
parent 6d4f53dcae
commit 17f2e6dc91
3 changed files with 416 additions and 0 deletions
+8
View File
@@ -77,6 +77,14 @@ Auf Linux startet `rmm-discovery-agent.service` als Systemkonto `rmm-discovery`
Ein geänderter stabiler Bootstrap-Updater wird ausdrücklich je Mandant rotiert. Dazu beim Veröffentlichen des geprüften neuen Builds `--rotate-bootstrap-from <bisheriger SHA-256>` ergänzen. Für den Windows-GNU-Worker mit Skript-/Updatesperre verlangt der signierte Release zusätzlich `--minimum-updater-version 2`. Der Befehl lädt den neuen Worker zunächst über die Katalog-API hoch, vergleicht das gespeicherte Objekt und den bisherigen Mandantenpin und schaltet anschließend auf den neuen Hash um. Bereits ausgestellte Installer können den vorher erhaltenen Hash noch 15 Minuten lang abrufen. Weitere Releases desselben Workerstands verwenden nur `--minimum-updater-version 2`. Bestehende Geräte mit älterer stabiler Prüferdatei verwerfen ein Release, dessen signierte Mindestversion ihre eigene Prüferfähigkeit übersteigt.
## Bestehenden verwalteten Linux-Helper auf eine neue Releaseversion umstellen
Auf der Entwicklungs-VM verweist die Unit `rmm-discovery-managed-script-helper.service` auf den absoluten Pfad der bisherigen signierten Releaseversion. Für den gemeinsamen Versionswechsel vor der Katalogveröffentlichung den aktiven Release aus `/opt/rust-discovery-client/current` erfassen, `rmm-discovery-update.timer` mit systemd stoppen und den Abschluss eines laufenden Update-Dienstes abwarten. Das neue Paar veröffentlichen, den regulären `rmm-discovery-update.service` einmal starten und seine erfolgreich aktivierte Release-ID prüfen.
Vom Entwicklungsrechner den [Helperwechsel](../tools/dev_linux_helper_rollover.py) zuerst mit `check` und dann mit `switch` aufrufen. Beide Aufrufe erwarten `--tenant UUID --asset UUID --agent UUID --previous ALTE_RELEASE_UUID --current NEUE_RELEASE_UUID`. Der Befehl prüft beide signierten Paare, den vorhandenen Systemdienst, die lokale Gerätebindung und genau einen passenden bestehenden Serverscope. Unter der lokalen Auftrags- und Releasesperre aktualisiert er Helperprofil, Agentpin und Unit-Ziel. Ein neuer authentisierter Kontakt muss beide erwarteten Helperhashes und einen bereiten Abgleich melden. Erst dann ersetzt der Operator im vorhandenen Serverscope die beiden Hashwerte. Principals, erlaubte Aktionen, übrige Geräte und Kunden bleiben erhalten.
Nach erfolgreichem Rücklesen den Update-Timer wieder starten. Ein unterbrochener `switch` ist mit denselben Kennungen fortsetzbar. `rollback` stellt unter denselben Prüfungen den vorherigen Helper und dessen Pins wieder her und belässt den Agenten in der angegebenen aktuellen Releaseversion. Bei ausstehendem Abgleich bleibt der bestehende Serverscope wirksam. Der stabile Verifier unter `/opt/rust-discovery-client/updater` wird separat anhand seines Bootstrap-Pins ausgetauscht.
## Stabilen Windows-Updater im Entwicklungsbetrieb ersetzen
Für den gezielten Austausch des stabilen Workers zuerst die fertige Datei mit `tools/dev_stage.py windows DATEI` übertragen. [Replace-DevelopmentReleaseUpdater.ps1](../deploy/windows/Replace-DevelopmentReleaseUpdater.ps1) erwartet `-Candidate`, die beiden exakten Hashes über `-ExpectedPreviousSha256` und `-ExpectedCandidateSha256`, `-AgentId` und die zu prüfenden `-VerifyReleaseIds`. In einer administrativen Windows-PowerShell ausführen. Der Befehl verlangt einen laufenden Agenten und gestoppten Updater, prüft die signierten Releasepaare nativ, ersetzt den Worker atomar mit Sicherung und startet den Updatedienst mit SCM-Wiederanlauf. Bei standardmäßig Restricted geltender Skriptrichtlinie für die Entwicklungs-PowerShell `Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned` verwenden.