From beb3485838174d1d93c1f7f63ff6f78b4260e568 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Tue, 17 Nov 2026 16:47:31 +0100 Subject: [PATCH] Publish independently verified bootstrap workers and record native Windows update recovery --- .../Replace-DevelopmentReleaseUpdater.ps1 | 55 +++++++++++ docs/development.md | 6 ++ .../windows-https-release-20261117.json | 91 +++++++++++++++++++ docs/mvp-completion-plan.md | 4 +- tests/release_bootstrap_gateway.py | 25 ++++- tools/agent_release.py | 36 +++++--- tools/dev_agent_release.py | 43 ++++++--- 7 files changed, 228 insertions(+), 32 deletions(-) create mode 100644 deploy/windows/Replace-DevelopmentReleaseUpdater.ps1 diff --git a/deploy/windows/Replace-DevelopmentReleaseUpdater.ps1 b/deploy/windows/Replace-DevelopmentReleaseUpdater.ps1 new file mode 100644 index 0000000..4ee2ccc --- /dev/null +++ b/deploy/windows/Replace-DevelopmentReleaseUpdater.ps1 @@ -0,0 +1,55 @@ +#requires -Version 5.1 +#requires -RunAsAdministrator +[CmdletBinding()] +param( + [Parameter(Mandatory)][string]$Candidate, + [Parameter(Mandatory)][ValidatePattern('^[0-9a-f]{64}$')][string]$ExpectedPreviousSha256, + [Parameter(Mandatory)][ValidatePattern('^[0-9a-f]{64}$')][string]$ExpectedCandidateSha256, + [Parameter(Mandatory)][Guid]$AgentId, + [Parameter(Mandatory)][Guid[]]$VerifyReleaseIds +) +$ErrorActionPreference = 'Stop' +Set-StrictMode -Version Latest +$app = Join-Path $env:ProgramFiles 'RustDiscovery' +$data = Join-Path $env:ProgramData 'RustDiscovery' +$installed = Join-Path $app 'rmm-updater-windows.exe' +function Hash([string]$Path) { + return (Get-FileHash -LiteralPath $Path -Algorithm SHA256).Hash.ToLowerInvariant() +} +if ((Hash $Candidate) -cne $ExpectedCandidateSha256 -or + (Hash $installed) -cne $ExpectedPreviousSha256) { throw 'Updater hash mismatch.' } +$svc = Get-CimInstance Win32_Service -Filter "Name='RmmDiscoveryReleasePull'" +if ($svc.PathName -cne ('"' + $installed + '" --release-service') -or + $svc.StartName -cne 'LocalSystem' -or $svc.State -ne 'Stopped') { throw 'Unexpected updater service.' } +$identity = Get-Content (Join-Path $data 'state\identity.json') -Raw | ConvertFrom-Json +$agent = Get-CimInstance Win32_Service -Filter "Name='RmmDiscoveryWindows'" +if ($identity.agent_id -cne $AgentId.ToString() -or $agent.State -ne 'Running') { throw 'Unexpected running agent.' } +foreach ($id in $VerifyReleaseIds) { + $generation = Join-Path (Join-Path $app 'releases') $id.ToString() + $result = & $Candidate --verify-bootstrap (Join-Path $data 'release-keyring.json') (Join-Path $generation 'envelope.json') (Join-Path $generation 'rmm-agent-windows.exe') (Join-Path $generation 'rmm-helper-windows.exe') + if ($LASTEXITCODE -ne 0) { throw 'Release signature verification failed.' } + if (($result | ConvertFrom-Json).release_id -cne $id.ToString()) { throw 'Release identity mismatch.' } +} +$backup = Join-Path $app ('updater-before-' + $ExpectedPreviousSha256 + '.exe') +$tmp = Join-Path $app ('.stable-' + [Guid]::NewGuid().ToString('N') + '.exe') +if (Test-Path $backup) { throw 'Updater backup already exists.' } +try { + [IO.File]::Copy($Candidate, $tmp, $false) + if ((Hash $tmp) -cne $ExpectedCandidateSha256) { throw 'Staged updater hash mismatch.' } + [IO.File]::Replace($tmp, $installed, $backup) +} finally { if (Test-Path $tmp) { Remove-Item $tmp -Force } } +if ((Hash $installed) -cne $ExpectedCandidateSha256 -or + (Hash $backup) -cne $ExpectedPreviousSha256) { throw 'Updater replacement failed.' } +& sc.exe failure RmmDiscoveryReleasePull reset= 86400 actions= restart/15000/restart/60000/restart/300000 | Out-Null +if ($LASTEXITCODE -ne 0) { throw 'SCM recovery setup failed.' } +& sc.exe failureflag RmmDiscoveryReleasePull 1 | Out-Null +if ($LASTEXITCODE -ne 0) { throw 'SCM recovery flag failed.' } +Start-Service RmmDiscoveryReleasePull +[pscustomobject]@{ + utc = [DateTime]::UtcNow.ToString('o') + agent_id = $identity.agent_id + previous_sha256 = $ExpectedPreviousSha256 + updater_sha256 = Hash $installed + updater = [string](Get-Service RmmDiscoveryReleasePull).Status + backup = $backup +} | ConvertTo-Json -Compress diff --git a/docs/development.md b/docs/development.md index 84845bd..7fb16f8 100644 --- a/docs/development.md +++ b/docs/development.md @@ -76,3 +76,9 @@ Im aktuellen Windows-Entwicklungsmandanten den angebotenen Aufruf mit `-Platform 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. Die Freigabe und gerätespezifische Provisionierung des privilegierten Wartungshelpers bleibt eine eigene Verwaltungshandlung. Ein geänderter stabiler Bootstrap-Updater wird ausdrücklich je Mandant rotiert. Dazu beim Veröffentlichen des geprüften neuen Builds `--rotate-bootstrap-from ` 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. + +## 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) diff --git a/docs/evidence/windows-https-release-20261117.json b/docs/evidence/windows-https-release-20261117.json index b279e50..07247b7 100644 --- a/docs/evidence/windows-https-release-20261117.json +++ b/docs/evidence/windows-https-release-20261117.json @@ -163,5 +163,96 @@ "terminal_state": "succeeded", "outcome_revision": 2 } + }, + "corrected_stable_deployment": { + "utc": "2026-11-17T15:45:08.6506553Z", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "previous_sha256": "333cf84c1594ac0d44951aa4141635afdd9b3f1bdb5f2d8b701d384c0abc93e3", + "updater_sha256": "de75510b9b2971658dcadd197364c4135b629448bd6f47bf187033c189e349f7", + "updater": "Running", + "backup": "C:\\Program Files\\RustDiscovery\\updater-before-333cf84c1594ac0d44951aa4141635afdd9b3f1bdb5f2d8b701d384c0abc93e3.exe", + "method": "Development SSH with Replace-DevelopmentReleaseUpdater.ps1, exact previous and new SHA, native C/D signature checks, updater service start" + }, + "after_powershell_automatic_update": { + "native": { + "utc": "2026-11-17T15:45:34.1065080Z", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "sequence": 4, + "running_version": "0.1.3", + "hash": "537360094b3ae4d01e7ce050b18d27ec5d850c54d8a014f785124b1ecca025de", + "service": "Running", + "account": "NT AUTHORITY\\LocalService", + "job_mode": true, + "trusted_clock": true, + "utc_clock": true, + "clock_failure": "", + "ready": true, + "helper_ready": false, + "generation": 3, + "needs_sync": false, + "counts": { + "accepted": 0, + "requesting": 0, + "running": 0, + "verifying": 0, + "unknown": 0, + "awaiting_reboot": 0, + "events": 0, + "legacy_events": 0 + }, + "diagnostics": [ + { + "file": "session-last-error.json", + "code": "", + "date": "2026-11-17T15:44:45.837535100Z" + } + ], + "updater": "Running", + "updater_result": "ok", + "updater_detail": null, + "updater_checked": "2026-11-17T15:45:22.056983300Z", + "intent": false + }, + "mcp": { + "asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "presence": "online", + "source_id": "windows.base", + "observed_at": "2026-11-17T15:45:18.640Z", + "last_contact_at": "2026-11-17T15:45:18.811875Z", + "quality": "valid", + "agent_version": "0.1.3", + "powershell": true, + "sync": true, + "gnu": true + } + }, + "fresh_job_webui": { + "revision": "2210624c-35d1-41c8-88ee-1860713bbce4", + "plan": "2c0d9d73-764d-466a-b3a2-799db9de6717", + "plan_hash": "c8f59f7d74d2aed0e2c57b9118ebd6bef78bb646efc6f223d9e2cf8cb633d566", + "job": "99ff0463-87f1-4a3f-9b35-ca2615b09320", + "attempt": "7b45ce5d-7e46-4a5c-a60b-873cdd4a58b3", + "job_payload_hash": "a27d8f8a69eca2811c65ecf89bc9fe204f4df0d97c2280c09540880253247805", + "agent": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "asset": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "operation": "be169d03-23ca-4857-a8c2-e56d06aa1d8e", + "preapproval_job_count": 0, + "approval": "dev_test_browser_simulation", + "approved_at": "2026-11-17T15:23:53.553Z", + "ui_result": true, + "stdout": "PowerShell 5.1.26100.9818\\u000d\n", + "observed_at": "2026-11-17T15:24:02.257Z" + }, + "fresh_job_mcp": { + "state": "succeeded", + "operation": "be169d03-23ca-4857-a8c2-e56d06aa1d8e", + "job": "99ff0463-87f1-4a3f-9b35-ca2615b09320", + "attempt": "7b45ce5d-7e46-4a5c-a60b-873cdd4a58b3", + "job_count": 1, + "exit_code": 0, + "stdout": "PowerShell 5.1.26100.9818", + "output_truncated": false } } diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index eb67439..819385f 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -1,6 +1,6 @@ # Lieferplan für Skriptverwaltung, Installation und Agentupdates -**Pausiert am 17. November 2026, 16:36 Uhr MEZ.** Der Windows-Client hat seinen Skriptauftrag abgeschlossen. Der korrigierte stabile Updater wurde auf dem Gast gegen beide signierten Pakete geprüft und wartet auf die Übernahme. Nächster Schritt ist der native Wechsel von `0.1.2` auf `0.1.3` gemäß [Übergabe](handover.md). Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) +**Stand 17. November 2026, 16:46 Uhr MEZ.** Beide per HTTPS aufgenommenen Clients haben ihren Bibliotheksauftrag abgeschlossen und eine neue Agentversion automatisch übernommen. Als nächster Schritt folgt die lesende Prüfung der gerätespezifischen Windows-Wartungseinrichtung. Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) ## Produkt und Betriebsstand @@ -44,7 +44,7 @@ Die [Linux-](https://discovery.ease-technologies.de:8443/install/linux.sh) und [ Das über den Installer neu aufgenommene Linux-Gerät `dda2c891…` führte die freigegebene Bibliotheksrevision mit Exitcode 0 aus. Der systemd-Timer aktivierte am 17.11. um 15:06 UTC den Release `0.1.0-mvp.2`. Der SHA-256 des über `/proc` geprüften laufenden Agenten und der Helperdatei stimmen mit dem signierten Manifest überein. Enrollmentgeneration und Geräteidentität blieben gleich. [Vollständiger Beleg](evidence/linux-public-installer-update-20261117.json) -Windows-A meldete sich mit neuer Identität `1626b5a3…`, Version `0.1.0` und gültigem `windows.base`. Der reguläre Updaterdienst aktivierte um 15:10 UTC Version `0.1.1` mit derselben Identität. Die Manipulationskontrolle wies eine um ein Byte veränderte Helperkopie ab. Das neu aufgenommene Windows-GNU-Gerät `858a27db…` mit Prüfer v2 führte unter `0.1.2` die PowerShell-Bibliotheksrevision erfolgreich aus. WebUI und MCP bestätigen denselben Versuch und Exitcode 0. Beim ersten nachfolgenden Abruf lagen die geprüften Dateien bereits auf dem Gast. Eine Windows-Dateisperre im gemeinsam benutzten Verzeichnis verhinderte das atomare Umschalten. Der Agent blieb unter `0.1.2` online. [Nativer Windows-Beleg](evidence/windows-https-release-20261117.json) +Windows-A meldete sich mit neuer Identität `1626b5a3…`, Version `0.1.0` und gültigem `windows.base`. Der reguläre Updaterdienst aktivierte um 15:10 UTC Version `0.1.1` mit derselben Identität. Die Manipulationskontrolle wies eine um ein Byte veränderte Helperkopie ab. Das neu aufgenommene Windows-GNU-Gerät `858a27db…` mit Prüfer v2 führte unter `0.1.2` die PowerShell-Bibliotheksrevision erfolgreich aus. WebUI und MCP bestätigen denselben Versuch und Exitcode 0. Beim ersten nachfolgenden Abruf lagen die geprüften Dateien bereits auf dem Gast. Eine Windows-Dateisperre verhinderte zunächst das atomare Umschalten. Der stabile Updater wurde über den direkten Entwicklungsweg korrigiert und mit dem wiederverwendbaren Repo-Befehl übernommen. Anschließend aktivierte er um 15:45:22 UTC selbstständig `0.1.3`. Der Prozesshash stimmt mit dem signierten D-Paket überein, beide Dienste laufen und die Geräteidentität ist gleich. [Nativer Windows-Beleg](evidence/windows-https-release-20261117.json) ### 7 · Lieferung von einem frischen Checkout nachvollziehen — geprüft diff --git a/tests/release_bootstrap_gateway.py b/tests/release_bootstrap_gateway.py index 868a6a6..e652e6b 100644 --- a/tests/release_bootstrap_gateway.py +++ b/tests/release_bootstrap_gateway.py @@ -177,15 +177,30 @@ def test(binary, directory, stack): except FileNotFoundError: pass assert updater()==original_worker - upload(new,replacement_worker) + worker_build = directory/'worker-only' + worker_build.mkdir() + worker_name = release.FILES[release.LINUX][2] + (worker_build/worker_name).write_bytes(replacement_worker) + worker_receipt = worker_build/'manifest.json' + worker_receipt.write_text(json.dumps({'target':release.LINUX,'sha256':{worker_name:new['sha256']}})) + login_file = directory/'catalog-login.json' + with open(login_file, 'x', opener=lambda path, flags: os.open(path, flags, 0o600)) as login: + json.dump({'username':env['RMM_DEV_USERNAME'],'password':env['RMM_DEV_PASSWORD']},login) + def rotate(predecessor): + release.publish(SimpleNamespace(artifacts=worker_build,build_receipt=worker_receipt,rotate_worker_only=True, + envelope=None,bootstrap_worker=None,rotate_bootstrap_from=predecessor,bootstrap_state=state,origin=origin, + ca=tls/'ca.pem',dev_login_file=login_file,tenant=TENANT)) + published_before = ask('GET',path+'/agent-releases',headers=auth)[1]['items'] + assert [item['release_envelope'] for item in published_before] == [a] try: - release.rotate_pin(state,'linux',TENANT,'0'*64,pin) + rotate('0'*64) raise AssertionError('unexpected predecessor accepted') except ValueError: pass assert updater()==original_worker - release.rotate_pin(state,'linux',TENANT,original['sha256'],pin) - release.rotate_pin(state,'linux',TENANT,original['sha256'],pin) + rotate(original['sha256']) + rotate(original['sha256']) + assert ask('GET',path+'/agent-releases',headers=auth)[1]['items'] == published_before assert updater()==replacement_worker and updater(original['sha256'])==original_worker assert ask('GET',bootstrap,headers=credential)[1]['updater']==pin updater('0'*64,404) @@ -201,7 +216,7 @@ def test(binary, directory, stack): b_auth={'Authorization':'Enrollment '+token_b} assert ask('GET','/agent/v1/bootstrap/updater?platform='+release.LINUX,headers=b_auth)[1]==original_worker ask('GET','/agent/v1/bootstrap/updater?platform='+release.LINUX+'&sha256='+new['sha256'],headers=b_auth,status=404) - print('tenant worker rotation rejects missing object and stale predecessor; default and in-flight downloads survive') + print('worker-only publication preserves the signed release, tenant isolation and in-flight downloads; stale predecessor rejected') install={'token':token['token'],'csr_pem':(tls/'device.csr').read_text()} _,enrolled=ask('POST','/agent/v1/enroll',install) assert enrolled['certificate_pem'] diff --git a/tools/agent_release.py b/tools/agent_release.py index bb3253f..6410f6a 100755 --- a/tools/agent_release.py +++ b/tools/agent_release.py @@ -67,7 +67,7 @@ def verify_native_image(path, target, size): 'Windows x86-64 PE32+ image required: ' + path.name) -def binaries(folder, receipt): +def binaries(folder, receipt, worker_only=False): record = json.loads(receipt.read_text(encoding='utf-8-sig')) if 'target' in record and 'sha256' in record: target, hashes = record['target'], record['sha256'] @@ -75,11 +75,12 @@ def binaries(folder, receipt): check(record.get('completed') is True and record['stage'] == 'built_not_deployed', 'completed MSVC receipt required') target = WINDOWS entries = record['artifacts'] - check(all(entries[name[:-4]]['build_target'] == target for name in FILES[target]), 'incorrect build target') - hashes = {name: entries[name[:-4]]['sha256'] for name in FILES[target]} + names = FILES[target][2:] if worker_only else FILES[target] + check(all(entries[name[:-4]]['build_target'] == target for name in names), 'incorrect build target') + hashes = {name: entries[name[:-4]]['sha256'] for name in names} check(target in FILES, 'unknown release target') result = [] - for name in FILES[target]: + for name in FILES[target][2:] if worker_only else FILES[target]: path = folder / name digest, size = fingerprint(path) verify_native_image(path, target, size) @@ -274,11 +275,16 @@ def rotate_pin(state, label, tenant, expected, new_pin): def publish(args): - platform, blobs = binaries(args.artifacts, args.build_receipt) - env = json.loads(args.envelope.read_bytes()) - manifest = json.loads(base64.urlsafe_b64decode(env['payload_bytes'] + '===')) - check(manifest['platform'] == platform and manifest['artifacts'] == [dict(role=role, **blob) - for role, blob in zip(('agent', 'helper'), blobs[:2])], 'input files differ from release envelope') + worker_only = args.rotate_worker_only + platform, blobs = binaries(args.artifacts, args.build_receipt, worker_only) + if worker_only: + check(args.envelope is None and args.rotate_bootstrap_from, 'worker rotation requires a predecessor and no release envelope') + else: + check(args.envelope is not None, 'a release envelope is required') + env = json.loads(args.envelope.read_bytes()) + manifest = json.loads(base64.urlsafe_b64decode(env['payload_bytes'] + '===')) + check(manifest['platform'] == platform and manifest['artifacts'] == [dict(role=role, **blob) + for role, blob in zip(('agent', 'helper'), blobs[:2])], 'input files differ from release envelope') check(bool(args.rotate_bootstrap_from) == bool(args.bootstrap_state), 'rotation needs previous SHA and local signing state') check(not (args.rotate_bootstrap_from and args.bootstrap_worker), 'a rotation uses the new receipt-bound stable worker') client = Publisher(args.origin, args.ca) @@ -296,7 +302,8 @@ def publish(args): tenant = str(uuid.UUID(args.tenant)) check(session['tenant_id'] == tenant and 'catalog:write' in session['permissions'], 'tenant catalog write permission required') path = '/api/v1/tenants/' + tenant - paths = [args.artifacts / name for name in FILES[platform]] + names = FILES[platform][2:] if worker_only else FILES[platform] + paths = [args.artifacts / name for name in names] if args.bootstrap_worker: paths[2] = args.bootstrap_worker sha, size = fingerprint(paths[2]) @@ -311,10 +318,14 @@ def publish(args): {'Content-Type': 'application/octet-stream', 'Content-Length': str(blob['bytes'])}) check(result['sha256'] == blob['sha256'] and result['size_bytes'] == blob['bytes'], 'artifact receipt differs') if args.rotate_bootstrap_from: - stable = blobs[2] + stable = blobs[-1] label = {LINUX:'linux', WINDOWS:'windows', WINDOWS_GNU:'windows-gnu'}[platform] rotate_pin(args.bootstrap_state,label,tenant,args.rotate_bootstrap_from, {'sha256':stable['sha256'],'bytes':stable['bytes']}) + if worker_only: + print(json.dumps({'tenant_id':tenant,'platform':platform,'updater_sha256':stable['sha256'], + 'updater_bytes':stable['bytes']})) + return result = client.request('POST', path + '/agent-releases', encoded(env), {'Content-Type': 'application/json'}) check(result['release_envelope'] == env, 'published envelope changed') print(json.dumps({'release_id': result['release_id'], 'version': manifest['version'], 'platform': platform, @@ -346,7 +357,8 @@ def main(): cmd.add_argument('--bootstrap-worker', type=Path, help='Pinned initial stable updater when publishing subsequent code pairs') cmd.add_argument('--ca', type=Path) cmd.add_argument('--tenant', required=True) - cmd.add_argument('--envelope', type=Path, required=True) + cmd.add_argument('--envelope', type=Path, help='Prepared agent and helper release') + cmd.add_argument('--rotate-worker-only', action='store_true', help='Rotate the stable worker independently of a code-pair release') auth = cmd.add_mutually_exclusive_group(required=True) auth.add_argument('--dev-username') auth.add_argument('--dev-login-file', type=Path) diff --git a/tools/dev_agent_release.py b/tools/dev_agent_release.py index 6712920..44c9b5d 100755 --- a/tools/dev_agent_release.py +++ b/tools/dev_agent_release.py @@ -29,7 +29,10 @@ def on_server(options): tool = stage / options['tool'] / 'agent_release.py' if hashlib.sha256(tool.read_bytes()).hexdigest() != options['tool']: raise ValueError('staged release tool differs') - build = state / 'builds' / options['label'] / str(options['sequence']) + if options['worker_only']: + build = state / 'worker-builds' / options['label'] / options['worker_sha'] + else: + build = state / 'builds' / options['label'] / str(options['sequence']) build.mkdir(parents=True, exist_ok=True) for name, digest in options['files'].items(): source = stage / digest / name @@ -47,11 +50,12 @@ def on_server(options): finally: os.unlink(tmp.name) if hashlib.sha256(dest.read_bytes()).hexdigest() != digest: - raise ValueError('sequence already contains different build: ' + name) + raise ValueError('staged slot already contains different build: ' + name) inputs = ['--artifacts', str(build), '--build-receipt', str(build / options['receipt'])] - subprocess.run(['python3', '-I', str(tool), 'prepare', *inputs, '--state', str(state), '--gateway', options['gateway'], - '--service-uid','10001','--minimum-updater-version',str(options['minimum']),'--sequence',str(options['sequence']),'--version',options['version']],check=True) - if options['label'].startswith('windows'): + if not options['worker_only']: + subprocess.run(['python3', '-I', str(tool), 'prepare', *inputs, '--state', str(state), '--gateway', options['gateway'], + '--service-uid','10001','--minimum-updater-version',str(options['minimum']),'--sequence',str(options['sequence']),'--version',options['version']],check=True) + if not options['worker_only'] and options['label'].startswith('windows'): import re import uuid public = Path('/etc/rmm-time-source/time-public-key.json') @@ -98,12 +102,17 @@ def on_server(options): if options['rotate']: selection=['--rotate-bootstrap-from',options['rotate'],'--bootstrap-state',str(state)] elif pin.is_file(): - sha=json.loads(pin.read_bytes())['current']['sha256'] - selection=['--bootstrap-worker',str(state/'objects'/tenant/sha)] + current=json.loads(pin.read_bytes())['current'] + sha=current['sha256'] + active_worker=state/'objects'/tenant/sha + if active_worker.stat().st_size != current['bytes'] or hashlib.sha256(active_worker.read_bytes()).hexdigest() != sha: + raise ValueError('current tenant bootstrap worker differs from protected pin') + selection=['--bootstrap-worker',str(active_worker)] else: selection=['--bootstrap-worker',str(state/'bootstrap-workers'/label)] - subprocess.run(['python3','-I',str(tool),'publish',*inputs,'--tenant',options['tenant'], - '--envelope',str(state/'prepared'/options['label']/str(options['sequence'])/'envelope.json'), + operation = ['--rotate-worker-only'] if options['worker_only'] else [ + '--envelope',str(state/'prepared'/options['label']/str(options['sequence'])/'envelope.json')] + subprocess.run(['python3','-I',str(tool),'publish',*inputs,'--tenant',options['tenant'],*operation, '--origin','https://localhost:18443','--ca','/opt/rust-discovery/devstate/api-pki/ca.pem', '--dev-login-file',auth.name,*selection],check=True) @@ -112,21 +121,29 @@ def main(): parser=argparse.ArgumentParser(description=__doc__) parser.add_argument('--artifacts',type=Path,required=True) parser.add_argument('--build-receipt',type=Path,required=True) - parser.add_argument('--sequence',type=int,required=True) - parser.add_argument('--version',required=True) + parser.add_argument('--sequence',type=int) + parser.add_argument('--version') parser.add_argument('--minimum-updater-version',type=int,default=1) parser.add_argument('--rotate-bootstrap-from',help='Rotate only this tenant from the given previous worker SHA-256') + parser.add_argument('--rotate-worker-only',action='store_true',help='Publish just the stable worker from its build receipt and rotate its tenant pin') parser.add_argument('--gateway',default='https://discovery.ease-technologies.de') parser.add_argument('--tenant',default='11111111-1111-4111-8111-111111111111') parser.add_argument('--prepare-only',action='store_true') args=parser.parse_args() - platform, _ = agent_release.binaries(args.artifacts,args.build_receipt) - files=[*(args.artifacts/name for name in agent_release.FILES[platform]),args.build_receipt] + if args.rotate_worker_only: + if not args.rotate_bootstrap_from or args.prepare_only or args.sequence is not None or args.version is not None: + parser.error('worker-only requires --rotate-bootstrap-from and accepts no prepare, sequence, or version') + elif args.sequence is None or args.version is None: + parser.error('a release requires --sequence and --version') + platform, descriptors = agent_release.binaries(args.artifacts,args.build_receipt,args.rotate_worker_only) + names = agent_release.FILES[platform][2:] if args.rotate_worker_only else agent_release.FILES[platform] + files=[*(args.artifacts/name for name in names),args.build_receipt] tool=Path(agent_release.__file__).resolve() if args.build_receipt.name in agent_release.FILES[platform]: raise ValueError('build receipt and binary names must differ') params={'files':{f.name:hashlib.sha256(f.read_bytes()).hexdigest() for f in files},'tool':hashlib.sha256(tool.read_bytes()).hexdigest(), 'receipt':args.build_receipt.name,'sequence':args.sequence,'version':args.version,'tenant':args.tenant, + 'worker_only':args.rotate_worker_only,'worker_sha':descriptors[-1]['sha256'], 'minimum':args.minimum_updater_version,'rotate':args.rotate_bootstrap_from,'gateway':args.gateway,'prepare_only':args.prepare_only,'label':{agent_release.LINUX:'linux', agent_release.WINDOWS:'windows',agent_release.WINDOWS_GNU:'windows-gnu'}[platform]} subprocess.run([sys.executable,str(ROOT/'tools/dev_stage.py'),'server',*map(str,files),str(tool)],check=True)