8.6 KiB
Entwickeln, bauen und ausliefern
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
| 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/<Ziel>/artifacts/<Commit>/<Manifesthash>/, beim SSH-Build unter ~/rmm-dev-build/<Ziel>/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.
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 · Deploymentrunner
Vorhandene Entwicklungsartefakte lassen sich per SSH direkt bereitstellen. Dieses Beispiel überträgt das gebaute Agent-/Helperpaar auf den Gast linux.
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/<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 · Betriebszugänge
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.
- Das gewünschte Clientziel bauen. Den konkreten Buildordner mit seiner
manifest.jsonverwenden. - Das folgende Beispiel für den offiziellen Windows-GNU-Kanal mit den tatsächlichen Werten aufrufen.
NEXT_SEQUENCEist eine höhere Sequenz für diesen Kanal. Der Runner überträgt die Artefakte, prüft die Buildquittung und signiert auf dem Signierhost.--prepare-onlybereitet den Release ohne Veröffentlichung im Kundenkatalog vor. - Zum Veröffentlichen mit denselben Werten erneut aufrufen und
--prepare-onlyweglassen. Der Entwicklungsrunner veröffentlicht über den internen Entwicklungszugang des berechtigten Kunden. Für andere berechtigte Kunden unterstütztpython3 tools/agent_release.py publish --helpden regulären API-Import mit lokalem Benutzer und TOTP. - 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.
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
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 · Windows-Updater austauschen
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.
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 |
| Wiederanmeldung des Agents, Journal- und Helperabgleich | cargo test --locked -p rmm-agent-core --test reconcile --test helper_reconcile |
Agentenabgleich |
| HTTPS-Gerätekanal und Erneuerung des Clientzertifikats | cargo test --locked -p rmm-agent --test https_channel --test certificate_rotation |
Transport |
Der MVP-Stand 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