Publish independently verified bootstrap workers and record native Windows update recovery

This commit is contained in:
2026-11-17 16:47:31 +01:00
parent ee1ae24d0c
commit beb3485838
7 changed files with 228 additions and 32 deletions
@@ -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
+6
View File
@@ -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 <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.
## 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)
@@ -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
}
}
+2 -2
View File
@@ -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
+20 -5
View File
@@ -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']
+24 -12
View File
@@ -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)
+30 -13
View File
@@ -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)