# Entwickeln, bauen und ausliefern ## Änderungen in Gitea sichern Nach jeder abgeschlossenen Änderung die geprüften Dateien committen und den Commit auf den zugehörigen Gitea-Branch pushen. Das gilt für Code, Konfiguration und Dokumentation. Bei einem neuen Arbeitsbranch `git push -u origin HEAD` verwenden. Danach prüfen, dass der Commit auf dem Zielbranch in Gitea liegt. ## Quellen bauen 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 --ref REVISION` | `rmm-agent`, `rmm-privileged-helper`, `rmm-agent-updater` | | Linux-Client ARM64 | `python3 tools/build.py linux-arm64 --ssh --ref REVISION` | `rmm-agent`, `rmm-privileged-helper`, `rmm-agent-updater` für AArch64 | | 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/` | `--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//artifacts///`, beim SSH-Build unter `~/rmm-dev-build//artifacts/` auf dem Server. Die Buildquittung `manifest.json` bindet Ziel, Git-Revision, Builder und Binärhashes. ## Entwicklungsserver und WebUI aktualisieren Für eine Serveränderung zuerst das ARM64-Ziel mit `--ssh` bauen. Der folgende Befehl aktiviert dieselbe Git-Revision vom Entwicklungs-PC aus. ```sh python3 tools/dev_deploy_server.py --ref REVISION ``` 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) 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 linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper" ``` `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//` 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) ## Signierte Agentversion veröffentlichen 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. 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. ```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 ``` 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. Linux x86-64 und ARM64 haben ebenfalls getrennte Signierschlüssel, Starter und Updater-Pins. Private Signierschlüssel verbleiben auf dem Signierhost. 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) ```sh python3 tools/dev_customer_starters.py --tenant "$TENANT_ID" \ --platform x86_64-pc-windows-gnu --official-windows --release "$RELEASE_ID" ``` Für ARM64 beim Starter `--platform aarch64-unknown-linux-gnu` verwenden und `--official-windows` weglassen. Die beiden Release-Overlays für den Server und die öffentliche API binden den ARM64-Schlüsselring und den Bootstrap-Pin ein. 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) ## Linux-Gerät per HTTPS aufnehmen Unter **Verwaltung → Geräteaufnahme** den Kunden wählen und einen Einmalcode erstellen. Den gemeinsamen Linux-Befehl auf dem Zielgerät ausführen. `linux.sh` erkennt `x86_64` und `aarch64` und wählt den passenden signierten Agenten, Helper und Updater. ```sh curl --fail --show-error --silent 'https://discovery.ease-technologies.de:8443/install/linux.sh' -o linux.sh && sudo sh linux.sh 'https://discovery.ease-technologies.de:8443' --enable-admin-scripts ``` Den Einmalcode auf Nachfrage eingeben. Bei direkter Root-Anmeldung entfällt `sudo`. `--enable-admin-scripts` aktiviert den lokalen Skript-Helper. Zusätzliche zentrale Geräterechte und die WebUI-Genehmigung gelten pro Auftrag. ## Ergebnis prüfen Die folgenden Rust-Tests laufen lokal mit Testidentitäten. Die Transporttests starten einen TLS-Server auf Loopback. | 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) | 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)