Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
+41
-90
@@ -1,118 +1,69 @@
|
||||
# Bauen und Bereitstellen in der Entwicklungsumgebung
|
||||
# Entwickeln, bauen und ausliefern
|
||||
|
||||
Der [Lieferplan](mvp-completion-plan.md) nennt den nächsten Schritt. Für eine Entwicklungskorrektur reicht der direkte Weg zum betroffenen Dienst. Der Agent-Updater ist selbst ein Produktfeature und wird über den Releasekanal geprüft, wenn genau diese Funktion zur Abnahme steht.
|
||||
|
||||
## Buildziel wählen
|
||||
|
||||
Die Befehle werden im Repository ausgeführt. Der [Buildrunner](../tools/build.py) verwendet den gewählten Git-Commit, die gepinnte Rust-Toolchain und die vorhandenen Docker-Builder. `--plan` zeigt Revision, Zielbinaries und Kommando an. `--ref` akzeptiert einen Commit oder Branch und verwendet standardmäßig `HEAD`. Bei absichtlich geänderten Quellen einen eigenen abgegrenzten Git-Stand wählen, damit fremder WIP im Arbeitsbaum bleiben kann. Der Cargo-Cache wird je Ziel wiederverwendet. Fehlen dem gepinnten Builder Pakete aus dem gewählten Lockfile, lädt der Runner sie einmalig mit `cargo fetch --locked` in den zielbezogenen Cache. Kompilierung und Buildskripte laufen weiterhin ohne Netzwerk.
|
||||
Der Buildrunner verpackt die Quellen eines eingecheckten Git-Stands und baut mit den gepinnten Docker-Buildern. Die folgenden Befehle laufen vom Wurzelverzeichnis des Repositorys. `REVISION` durch den zu liefernden Commit ersetzen. Vor dem ersten Frontendbuild `npm --prefix web ci` ausführen. Für den Rust-Build werden Python 3, Git, Docker, tar, rsync und die zum Ziel passenden lokalen Builder-Images benötigt. [Buildrunner](../tools/build.py)
|
||||
|
||||
| Ziel | Befehl | Ergebnis |
|
||||
| --- | --- | --- |
|
||||
| Linux-Client x86-64 | `python3 tools/build.py linux-x64` | Agent, privilegierter Helper und stabiler Updater |
|
||||
| Offizieller Windows-Client x86-64 | `python3 tools/build.py windows-gnu-x64` | Windows-GNU-Agent, SYSTEM-Helper und stabiler Windows-Updater. |
|
||||
| Server ARM64 vom Notebook | `python3 tools/build.py server-arm64 --ssh` | Überträgt den Runner und ausgewählte Quellen des Git-Commits per geprüftem SSH. Baut Server und Zeitbroker im separaten Bereich `~/rmm-dev-build/server-arm64/` auf dem nativen ARM64-Host. Ausgabe enthält Remote-Pfad und Hashes. |
|
||||
| Server ARM64 direkt auf einem passenden Linux-Buildhost | `python3 tools/build.py server-arm64` | Serverbinary für API/Gateway und Zeitbroker. Der lokale Modus erwartet Git-Checkout, gepinnten ARM64-Builder, Docker, Python 3, git, tar und rsync. |
|
||||
| WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Vite-Bundle in `web/dist/`. Im frischen Checkout zuerst `npm --prefix web ci` ausführen. |
|
||||
| Windows-Binaries nativ mit MSVC | Vorhandenen [MSVC-Runner und Voraussetzungen](../deploy/windows/msvc/README.md) verwenden. | Geplant, nicht ausgeführt. Eigener Preflight und Build auf passendem Windows-Builder. Optionales zusätzliches Buildziel. |
|
||||
| Linux-Client x86-64 | `python3 tools/build.py linux-x64 --ref REVISION` | `rmm-agent`, `rmm-privileged-helper`, `rmm-agent-updater` |
|
||||
| Offizieller Windows-Client x64 | `python3 tools/build.py windows-gnu-x64 --ref REVISION` | `rmm-agent-windows.exe`, `rmm-helper-windows.exe`, `rmm-updater-windows.exe` für GNU |
|
||||
| Server auf dem dedizierten ARM64-Host | `python3 tools/build.py server-arm64 --ssh --ref REVISION` | Server und Linux-Zeitbroker im Remote-Buildbereich |
|
||||
| WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Bundle in `web/dist/` |
|
||||
|
||||
Der lokale Runner gibt den **konkreten Artefaktordner** aus. Unter `devstate/build/<Ziel>/artifacts/<Commit>/<Manifesthash>/` liegen die Binaries und `manifest.json` mit Quellrevision, Zielarchitektur, Builder und SHA-256. Ausgelieferte Binärdateien immer am Hash identifizieren: Zwei Builds aus demselben Commit können unterschiedliche Bytes haben. Ein Build erstellt noch keinen signierten Produktrelease.
|
||||
`--plan` zeigt den Rust-Build einschließlich Quellenrevision und Ziel an. Der Runner verwendet je Ziel einen gemeinsamen Cargo-Cache, lädt bei Bedarf die gesperrten Abhängigkeiten und kompiliert offline. Er meldet den konkreten Ausgabeordner. Lokal liegt er unter `devstate/build/<Ziel>/artifacts/<Commit>/<Manifesthash>/`, beim SSH-Build unter `~/rmm-dev-build/server-arm64/artifacts/` auf dem Server. Die Buildquittung `manifest.json` bindet Ziel, Git-Revision, Builder und Binärhashes.
|
||||
|
||||
## Server und WebUI aus einem geprüften Git-Stand aktivieren
|
||||
## Entwicklungsserver und WebUI aktualisieren
|
||||
|
||||
`python3 tools/build.py server-arm64 --ssh --ref REVISION` erzeugt die Binärdatei auf dem Server. Anschließend baut `python3 tools/dev_deploy_server.py --ref REVISION` die passende WebUI, übernimmt die vorhandene Compose-Konfiguration und aktiviert API und Gateway. Der Runner vergleicht die tatsächlich angewendeten SQLx-Prüfsummen mit Git und liest die laufenden Binärhashes und die über TLS ausgelieferte Startseite zurück. Mit `--overlay server.releases.compose.yaml` überträgt und aktiviert der Runner die entsprechende Datei aus derselben Git-Revision. [Deploymentrunner](../tools/dev_deploy_server.py)
|
||||
Für eine Serveränderung zuerst das ARM64-Ziel mit `--ssh` bauen. Der folgende Befehl aktiviert dieselbe Git-Revision vom Entwicklungs-PC aus.
|
||||
|
||||
Bei einer reinen WebUI-Änderung genügt `python3 tools/dev_deploy_server.py --web-only --ref REVISION`. Für ein schon gebautes Bundle aus dem Arbeitsbaum genügt `python3 tools/dev_deploy_server.py --web-only --web-dist web/dist`. Beide Wege stellen zuerst die Assets und zuletzt die Startseite per SSH bereit. Der Runner vergleicht die per TLS ausgelieferte Startseite mit den übergebenen Bytes. Die Ausgabe enthält den SHA-256 der Startseite und die ID des laufenden API-Containers.
|
||||
```sh
|
||||
python3 tools/dev_deploy_server.py --ref REVISION
|
||||
```
|
||||
|
||||
## Vorhandene Dateien direkt bereitstellen
|
||||
Für eine reine WebUI-Änderung genügt `python3 tools/dev_deploy_server.py --web-only --ref REVISION`. Ein bereits gebautes Bundle lässt sich mit `python3 tools/dev_deploy_server.py --web-only --web-dist web/dist` übertragen. Der Deploymentrunner liefert die neuen Assets vor dem Index aus und liest den Index über TLS zurück. [Serveraufbau](server-deployment.md) · [Deploymentrunner](../tools/dev_deploy_server.py)
|
||||
|
||||
[dev_stage.py](../tools/dev_stage.py) verwendet die vorhandenen gepinnten SSH-Zugänge für `server`, `linux` und `windows`. Der Befehl nimmt beliebig viele benannte Entwicklungsartefakte entgegen, darunter fertige Binaries oder bereits gebaute Webassets. Unter `rmm-dev-stage/<SHA-256>/<Dateiname>` im Profil des SSH-Benutzers verifiziert er die Datei und verwendet vorhandene identische Bytes wieder. Für das Prüfen der Zielpfade genügt `--plan`. [Zugangsprofile und Hostpins](operations-access.md)
|
||||
|
||||
Beispiel für ein bereits gebautes Linux-Paar, **geplant, nicht ausgeführt**. `ARTIFACT_DIR` auf den vom Build ausgegebenen Ordner setzen:
|
||||
Vorhandene Entwicklungsartefakte lassen sich per SSH direkt bereitstellen. Dieses Beispiel überträgt das gebaute Agent-/Helperpaar auf den Gast `linux`.
|
||||
|
||||
```sh
|
||||
python3 tools/dev_stage.py --plan linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper"
|
||||
python3 tools/dev_stage.py linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper"
|
||||
```
|
||||
|
||||
## Aktivierung der bereitgestellten Entwicklungsversion
|
||||
`ARTIFACT_DIR` ist der gemeldete Buildordner. Als Ziel stehen `server`, `linux` und `windows` zur Auswahl. Der Runner überprüft den Hash und legt die Datei unter `rmm-dev-stage/<SHA-256>/<Dateiname>` im Zielkonto ab. Die Aktivierung ist ein eigener Schritt. Bei einer direkten Aktivierung die installierte Geräteidentität, Zertifikate, Journale und Dateirechte erhalten. Gehören Agent und Helper zu einem signierten Paket, ihre Bindungen zusammen berücksichtigen. Nach dem Wechsel Version, frischen authentisierten Kontakt und bei geänderter Ausführung einen genehmigten Testauftrag prüfen. Für eine Installer- oder Updaterabnahme den regulären Produktweg verwenden. [Stagingwerkzeug](../tools/dev_stage.py) · [Betriebszugänge](operations-access.md)
|
||||
|
||||
Nach dem Transfer die laufende Version und ihre Rückmeldung prüfen. Für den Server übernimmt das der Deploymentrunner. Die beiden Entwicklungsgeräte haben eigene Verfahren für den Wechsel einer laufenden Binärdatei.
|
||||
## Signierte Agentversion veröffentlichen
|
||||
|
||||
- **Server.** Den oben angegebenen Deploymentrunner verwenden. Er übernimmt die aktive Compose-Dateikette aus den Containerlabels, bestehende Volumes und Policy-Mounts. [Deploymentaufbau](server-deployment.md)
|
||||
- **Linux.** Beim Austausch der betroffenen Dienste ihre tatsächlich installierten Artefakte und Rechte feststellen, Ersatz vollständig bereitstellen und Konfiguration, Identität und Journal erhalten. Den Prozesshash, einen neuen Heartbeat und bei geänderter Jobruntime einen regulären Sync zurücklesen. Die früheren [Linux-Wechsel](../deploy/cloud_shared_core_upgrade_v2.py) enthalten wiederverwendbare Prüfungen und setzen konkrete Altfälle voraus.
|
||||
- **Windows.** Agent und Helper bei einem Paarwechsel koordiniert stoppen, Binärdateien und die an sie gebundenen Metadaten aus derselben Version einsetzen, ACLs und Geräteidentität erhalten und geordnet starten. Prozesshashes und Gerätepräsenz getrennt abfragen. [Vorhandener Paarwechsel](../deploy/windows/Install-DevelopmentPairSuccessor.ps1) · [Zugang und lesende Diensteprüfung](operations-access.md)
|
||||
Der signierte Release enthält die Plattform, Release-ID, fortlaufende Sequenz, Version, Kompatibilitäts- und Gültigkeitsdaten sowie Hash und Länge des Agent-/Helperpaars. Dieser Datensatz wird aus geprüften Buildartefakten erzeugt. Der Server liefert die signierten Daten und die passenden Binärdateien aus dem Katalog des Kunden. Die automatische Prüfung und Aktivierung erfolgt auf dem Gerät. Der stabile Updater selbst wird bei der Aufnahme über einen eigenen hinterlegten Hash gebunden.
|
||||
|
||||
Der alte `deploy/dev.py up` richtet eine lokale Compose-Umgebung ein. Der Produktserver liegt auf dem dedizierten Internetserver. Fallbezogene Builder wie `server_build_221.py` sind über ihre damaligen Belege auffindbar.
|
||||
1. Das gewünschte Clientziel bauen. Den konkreten Buildordner mit seiner `manifest.json` verwenden.
|
||||
2. Das folgende Beispiel für den offiziellen Windows-GNU-Kanal mit den tatsächlichen Werten aufrufen. `NEXT_SEQUENCE` ist eine höhere Sequenz für diesen Kanal. Der Runner überträgt die Artefakte, prüft die Buildquittung und signiert auf dem Signierhost. `--prepare-only` bereitet den Release ohne Veröffentlichung im Kundenkatalog vor.
|
||||
3. Zum Veröffentlichen mit denselben Werten erneut aufrufen und `--prepare-only` weglassen. Der Entwicklungsrunner veröffentlicht über den internen Entwicklungszugang des berechtigten Kunden. Für andere berechtigte Kunden unterstützt `python3 tools/agent_release.py publish --help` den regulären API-Import mit lokalem Benutzer und TOTP.
|
||||
4. Den Eintrag im Katalog des Zielkunden prüfen. Für die Abnahme des Selbstupdates einen regulären Abruf des Geräts, die Aktivierung und eine neue Meldung derselben Geräteidentität mit der neuen Version beobachten.
|
||||
|
||||
## Tatsächlich geprüft am 17. November 2026
|
||||
|
||||
- `linux-x64` und `windows-gnu-x64` auf dem Entwicklungs-PC aus `a576c10` gebaut, fünf Binaries und beide Manifeste per SHA-256 geprüft. Wiederholte Cargo-Builds aus dem Cache lagen jeweils unter einer Sekunde. Auf dem Windows-Gast liefen bei der Inventur die Hashes seines früheren Installationsbuilds aus demselben Commit.
|
||||
- `python3 tools/build.py server-arm64 --ssh` auf dem konfigurierten ARM64-Server tatsächlich ausgeführt. Server und Zeitbroker als ELF64/AArch64 nachgelesen, Manifest und Hashes bestätigt. Cargo benötigte beim ersten Lauf 7 min 6 s, beim zweiten 0,52 s. Beide Läufe lieferten identische Bytes. API, Gateway und Datenbank liefen währenddessen weiter.
|
||||
- WebUI mit den lokal vorhandenen Abhängigkeiten typgeprüft und in ein isoliertes Ausgabeverzeichnis gebaut. Ergebnis: `index.html`, CSS- und JavaScript-Bundle.
|
||||
- Auf Server, Cloud-Linux und Windows jeweils `python3 tools/dev_stage.py ZIEL rust-toolchain.toml` zweimal ausgeführt. Der erste Aufruf übertrug die Datei und prüfte den Zielhash, der zweite bestätigte die vorhandenen Bytes. Der Test veränderte nur den Stagingbereich. Es wurde kein Dienst aktiviert, Gerät neu aufgenommen oder Produktrelease veröffentlicht. [Build- und Betriebsbelege](evidence/product-audit-20261117.json)
|
||||
|
||||
Die früheren Entwicklungsprotokolle einschließlich der alten Notebook-/Reverse-Tunnel-Topologie sind im Git-Stand `a576c10:docs/development.md` erhalten.
|
||||
|
||||
## Entwicklungspakete im isolierten Entwicklungsprofil veröffentlichen
|
||||
|
||||
Der Buildordner enthält das in der Buildquittung gebundene Agent-/Helperpaar und den stabilen Bootstrap-Updater. Ein Linux-Build benötigt `rmm-agent`, `rmm-privileged-helper` und `rmm-agent-updater`. Auf Windows heißen die Dateien `rmm-agent-windows.exe`, `rmm-helper-windows.exe` und `rmm-updater-windows.exe`. Der GNU-Build enthält den stabilen Updater. Der Katalog führt Linux GNU, Windows MSVC und Windows GNU als getrennte Ziele. Für offizielle Windows-Pakete den eigenen Signierschlüssel verwenden.
|
||||
|
||||
```bash
|
||||
python3 tools/dev_agent_release.py \
|
||||
--artifacts "$buildordner" --build-receipt "$buildordner/manifest.json" \
|
||||
--sequence 1 --version 0.1.0-mvp.1
|
||||
```sh
|
||||
python3 tools/dev_agent_release.py --official-windows \
|
||||
--artifacts "$ARTIFACT_DIR" --build-receipt "$ARTIFACT_DIR/manifest.json" \
|
||||
--tenant "$TENANT_ID" --sequence "$NEXT_SEQUENCE" --version "$VERSION" \
|
||||
--minimum-updater-version 2 --prepare-only
|
||||
```
|
||||
|
||||
Der Befehl prüft die Buildquittung und überträgt die drei Binärdateien über den gepinnten SSH-Zugang. Auf dem Server signiert ein separater Ed25519-Schlüssel je Plattform das exakte Agent-/Helperpaar. Der Aufruf lädt die Dateien über die authentisierte Management-API und veröffentlicht zuletzt den Envelope. Ein erneuter Aufruf mit derselben Sequenz und denselben Bytes verwendet die gespeicherte Signatur. Für eine geänderte Version die Sequenz erhöhen. Native MSVC-Builds verwenden ihre `result.json` als `--build-receipt`.
|
||||
Für Linux gilt derselbe Ablauf mit dem Linux-Buildordner und ohne `--official-windows`. Die Mindestversion entsprechend der vom Paket benötigten Updaterfähigkeit setzen. Der offizielle Windows-Kanal nutzt einen eigenen Signierschlüssel. Private Signierschlüssel verbleiben auf dem Signierhost.
|
||||
|
||||
Beim ersten Serveraufbau den Befehl zunächst mit `--prepare-only` ausführen. Damit entstehen die Schlüssel, die öffentliche Konfiguration und der Objektspeicher unter `/opt/rust-discovery/devstate/mvp-releases`. Das Compose-Overlay `deploy/server.releases.compose.yaml` bindet nur Konfiguration und Objekte an die Rollen. Der private Schlüssel bleibt auf dem Server. Anschließend API und Gateway mit diesem Overlay aktivieren und den Veröffentlichungsbefehl ohne `--prepare-only` erneut ausführen. Der bei der Einrichtung gespeicherte SHA-256 ist der Ausgangswert für die unten beschriebene kontrollierte Rotation.
|
||||
Für die Erstaufnahme in neuen Kundenkatalogen kann der Betreiber einen veröffentlichten Release als Starter auswählen. Die Quelle wird anhand ihrer Kunden-, Plattform- und Release-ID geprüft. Bereits befüllte Kataloge werden je Kunde gepflegt. [Starter veröffentlichen](../tools/dev_customer_starters.py)
|
||||
|
||||
## Neue Geräte und Selbstupdate
|
||||
```sh
|
||||
python3 tools/dev_customer_starters.py --tenant "$TENANT_ID" \
|
||||
--platform x86_64-pc-windows-gnu --official-windows --release "$RELEASE_ID"
|
||||
```
|
||||
|
||||
Im Releasekatalog der WebUI unter **Neues Gerät aufnehmen** einen Einmalcode erzeugen. Die WebUI zeigt die Installationsaufrufe für die veröffentlichten Plattformen. Den Code auf dem neuen Gerät im Prompt eingeben. Nach 15 Minuten oder beim erfolgreichen Enrollment verliert er seine Gültigkeit. Der öffentliche Bootstrap-Origin wird mit `RMM_BOOTSTRAP_ORIGIN` festgelegt. Die Geräteadresse stammt aus der geschützten plattformspezifischen Bootstrapkonfiguration.
|
||||
Ein neuer stabiler Updater benötigt eine eigene Rotation des Bootstrap-Hashes. `--rotate-worker-only --rotate-bootstrap-from SHA256` bindet die Umstellung im Zielkunden an den bisherigen Hash. Für den gezielten lokalen Austausch des stabilen Windows-Updaters im Entwicklungsbetrieb prüft der PowerShell-Operator beide Hashes, die Geräteidentität und die installierten Releasepaare. [Releasewerkzeuge](../tools/agent_release.py) · [Windows-Updater austauschen](../deploy/windows/Replace-DevelopmentReleaseUpdater.ps1)
|
||||
|
||||
Im aktuellen Windows-Entwicklungsmandanten den angebotenen Aufruf mit `-Platform x86_64-pc-windows-gnu` aus der WebUI übernehmen. Windows verwendet den LocalService-Agenten und den separaten Dienst `RmmDiscoveryReleasePull` für die periodische Prüfung.
|
||||
## Ergebnis prüfen
|
||||
|
||||
Auf Linux startet `rmm-discovery-agent.service` als Systemkonto `rmm-discovery` mit eigenem Zustand in `/var/lib/rmm-discovery`. `rmm-discovery-update.timer` prüft nach dem Booten und anschließend alle fünf Minuten den Releasebestand. Die aktive Generation und ein bei fehlgeschlagener Aktivierung gespeicherter Fehler liegen unter `/opt/rust-discovery-client`. Der Lauf berücksichtigt belegte Jobs, verifiziert den signierten Inhalt, schaltet die Generation um und prüft die neue Geräteverbindung. Das Systemjournal von `rmm-discovery-update.service` enthält die Fehlermeldung. Der Linux-Produktinstaller startet den unprivilegierten Agenten. Für Root-Skripte aktiviert ein lokaler Administrator einmalig den an dieses Gerät gebundenen Helferdienst. Dazu den aus der WebUI geladenen Installer mit `sudo sh linux.sh https://discovery.ease-technologies.de:8443 --enable-admin-scripts` ausführen. Bei einem abweichenden Bootstrap-Origin die von der WebUI angezeigte HTTPS-Adresse einsetzen. Der Schalter funktioniert auch nach der Aufnahme mit der vorhandenen Geräteidentität. Ohne diesen Schalter bleibt ein bisheriges Dienstkonto-Gerät beim Dienstkonto. Die WebUI-Genehmigung des konkreten Skripts und die Berechtigungen auf dem Server gelten bei jedem Auftrag.
|
||||
Die folgenden Rust-Tests laufen lokal mit Testidentitäten. Die Transporttests starten einen TLS-Server auf Loopback.
|
||||
|
||||
Der Helferdienst `rmm-discovery-managed-script-helper.service` verwendet den Helper aus demselben signierten Release wie der Agent. Der Installer übernimmt einen bereits ausdrücklich eingerichteten, dauerhaft aktivierten Skripthelfer nur mit übereinstimmender Gerätebindung und Skriptrichtlinie. Für diese Migration den aktuellen HTTPS-Installer auf dem eingeschriebenen Gerät erneut ausführen. Die nächste periodische Aktualisierung schaltet Agent, Helper und die zugehörigen Prüfdaten gemeinsam um. Bei fehlgeschlagener Aktivierung prüft der Updater die Rückkehr des vorherigen Paares. Eine bestehende lokale Deaktivierung, Maskierung oder abweichende Richtlinie bleibt wirksam.
|
||||
| Was geprüft wird | Lokaler Befehl | Testbeschreibung |
|
||||
| --- | --- | --- |
|
||||
| Bindung eines Startrechts an Gerät, Skript und Versuch, Schutz vor doppelter Ausführung | `cargo test --locked -p rmm-agent-core --test contracts` | [Skriptaufträge](../tests/agent_jobs/README.md) |
|
||||
| Wiederanmeldung des Agents, Journal- und Helperabgleich | `cargo test --locked -p rmm-agent-core --test reconcile --test helper_reconcile` | [Agentenabgleich](../tests/agent_sync/README.md) |
|
||||
| HTTPS-Gerätekanal und Erneuerung des Clientzertifikats | `cargo test --locked -p rmm-agent --test https_channel --test certificate_rotation` | [Transport](../tests/agent_transport/README.md) |
|
||||
|
||||
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.
|
||||
|
||||
## Historischer manueller Linux-Helperwechsel
|
||||
|
||||
Für Systeme vor der Migration auf den aktuellen HTTPS-Installer gilt das frühere Verfahren. Auf der Entwicklungs-VM verwies 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.
|
||||
|
||||
Dieser Weg wurde am 17. November für den Worker `de75510b…` ausgeführt. Der anschließende reguläre Abruf aktivierte Windows `0.1.3` auf derselben Geräteidentität. [Nativer Beleg](evidence/windows-https-release-20261117.json)
|
||||
|
||||
Für die separate Veröffentlichung eines korrigierten stabilen Workers ohne neues Agentpaket verwendet der Entwicklungsrunner `--rotate-worker-only --rotate-bootstrap-from SHA256` zusammen mit `--artifacts` und `--build-receipt`. Die Quittung muss die passende Plattform und den übertragenen Worker binden. Der Aufruf prüft den gespeicherten Worker und rotiert nur den Bootstrap-Pin des gewählten Mandanten. [Veröffentlichungs- und Rotationsnachweis](evidence/agent-release-worker-rotation-20261117.json)
|
||||
|
||||
## Windows-Skripte als Administrator einrichten
|
||||
|
||||
Der HTTPS-Installer nimmt das Gerät mit dem Dienstkonto LocalService auf. Für die örtliche Einrichtung des SYSTEM-Helpers in einer administrativen PowerShell den Installer mit `-EnableAdministratorScripts` aufrufen. Bei einem bereits aufgenommenen Gerät genügen der bisherige HTTPS-Ursprung und dieser Schalter. Ein kompatibler stabiler Updater, die aktuelle Gerätebindung und das exakt signierte Agent-/Helperpaar sind erforderlich. Die WebUI bietet beim Aufnehmen die passenden Befehle an.
|
||||
|
||||
Für den zentralen Betreiber ist `RMM_MANAGED_SCRIPT_POLICY_FILE` die geschützte Konfiguration. Eine Gerätefreigabe bindet Kunde, Asset, Agent, Enrollmentgeneration, Zuordnung, Ausführungskonto, berechtigte Personen sowie die Hashes von Helper und lokaler Richtlinie. Auf Windows kann `allowed_script_sha256` den Umfang auf genaue UTF-8-Skriptinhalte mit leerer Argumentliste begrenzen. Eine leere Liste sperrt alle Skripte für diesen Eintrag. Jede tatsächliche Ausführung benötigt weiterhin den in der WebUI genehmigten, unveränderlichen Plan.
|
||||
|
||||
Bei einer für künftige Releases vorgesehenen Bindung kann der Betreiber im selben Dokument unter `release_anchors` die `agent_id`, `release_id`, `agent_sha256`, `helper_sha256` und die kanonischen, bereits zugelassenen öffentlichen Richtlinienbytes als `policy_json` hinterlegen. Deren SHA-256 muss dem unabhängig am Gerät geprüften und in der zentralen Gerätefreigabe eingetragenen Richtlinienhash entsprechen. Der Server prüft beim Versionswechsel das signierte Paar und berechnet den erwarteten neuen Richtlinienhash. Nur Releaseverzeichnis und zugehörige Binärhashes werden für diesen Vergleich ersetzt. Die WebUI unterscheidet einen nicht gemeldeten Helper, eine nicht bestätigte Releasebindung und eine fehlende zentrale Berechtigung.
|
||||
|
||||
Der frühere [Entwicklungsablauf für das befristete Windows-Updatefenster](windows-update-dev-window.md) dokumentiert die vorherige Installationsgeneration. Bestehende Fenster werden vor einer Umstellung regulär geschlossen.
|
||||
|
||||
## Öffentliche Verwaltung
|
||||
|
||||
`tools/dev_public_access.py` provisioniert den lokalen Passwort-/TOTP-Zugang, startet die zusätzliche API intern und aktiviert den vorhandenen öffentlichen TLS-Ingress. Die tatsächlichen Befehle und die privaten Dateipfade stehen im [Betriebsablauf](public-access.md). Der normale Deploymentrunner aktualisiert anschließend auch den öffentlichen API-Dienst.
|
||||
|
||||
|
||||
## Offizielle Windows-Veröffentlichung
|
||||
|
||||
1. `python3 tools/build.py windows-gnu-x64 --ref REVISION` erzeugt das Agent-/Helperpaar, den stabilen Updater und die Buildquittung.
|
||||
2. `python3 tools/dev_agent_release.py --official-windows --artifacts ORDNER --build-receipt ORDNER/manifest.json --sequence NUMMER --version VERSION --minimum-updater-version 2 --prepare-only` bindet die Binärhashes an den separaten Schlüssel auf dem Signierhost. Die Sequenz muss größer als die letzte im Zielkatalog sein. Schlüssel und Konfiguration liegen in den getrennten Slots `windows-gnu-official`. Nur die öffentlichen Prüfmaterialien werden in die Serverprozesse eingebunden.
|
||||
3. Auf dem Entwicklungsserver denselben Aufruf ohne `--prepare-only` für Development A verwenden. Für weitere Kunden die signierten Artefakte über die reguläre Katalog-API mit der Berechtigung des Zielkunden veröffentlichen. `tools/agent_release.py publish --help` beschreibt den Login mit lokalem Konto und TOTP. Bei einer Workerrotation den bisherigen Hash angeben.
|
||||
4. `python3 tools/dev_customer_starters.py --official-windows --tenant UUID --platform x86_64-pc-windows-gnu --release RELEASE_UUID` veröffentlicht den gewählten Starter für neue Kunden. Befüllte Kataloge benötigen ihren eigenen Import. Bestehende Entwicklungsinstallationen besitzen einen anderen lokalen Schlüsselring. Die erstmalige Umstellung erfolgt über eine geprüfte Neuaufnahme oder eine separat autorisierte lokale Vertrauensmigration.
|
||||
Der [MVP-Stand](mvp-completion-plan.md) enthält die überprüften Ergebnisse der Testgeräte. Lokale Frontendtests, Binärbuild, übertragene Datei, gestarteter Dienst und erfolgreicher Auftrag sind verschiedene Beobachtungen. Bei einem Neustart die Boot-ID vor und nach dem Auftrag, den authentisierten Kontakt und den erfolgreichen Folgeauftrag derselben Installation festhalten. [Frontendtests](../web/README.md)
|
||||
|
||||
Reference in New Issue
Block a user