Files
Deploymentcenter/scripts/build_installer.ps1
T
Deploymentcenter BotandClaude Opus 5 e01a608c08 feat(release): Veroeffentlichungsvorlage fuer fremde Projekte
Die Anleitung benutzte pack-and-deploy, als laege es im PATH - beziehbar war
es nirgends. Ein Projekt, das den UpdateService einbindet, konnte also nicht
veroeffentlichen, ohne dieses Repository auszuchecken und selbst zu
uebersetzen. Das Werkzeug existierte, nur kam niemand daran.

- build_installer.ps1 baut pack-and-deploy fuer dieselben Laufzeitkennungen
  mit und fuehrt es in installer.json unter "tools". Damit steht es neben dem
  Agenten unter /installer/ bereit.
- Neue Vorlage unter public/docs/release-template/: release.ps1, release.sh
  und release.config.example.json. Kopieren, Konfiguration ausfuellen, fertig -
  die Skripte selbst bleiben unveraendert und lassen sich bei einer neuen
  Fassung einfach ersetzen.
- Sie orchestrieren nur: je Laufzeitkennung einmal dotnet publish, dann
  pack-and-deploy. Pruefsummen, Dateimanifest, latest.json und die Anmeldung
  bleiben im Werkzeug - ein zweiter Ort fuer dieselbe Logik waere ein zweiter
  Ort fuer dieselben Fehler.
- Das Werkzeug wird beim ersten Lauf selbst geholt, gegen die .sha256 geprueft
  und unter .dc-tools/ abgelegt. Die Vorlage ist damit wirklich eine Datei.
- setup.json wird ins Publish-Verzeichnis kopiert, sonst faende der Installer
  sie nicht.
- Rueckgabewert 1 (Konfigurations- oder Versionsfehler) bricht sofort ab; die
  weiteren Plattformen wuerden genauso scheitern. Bei 2 laeuft es weiter und
  meldet am Ende, welche betroffen sind.

Anleitung: public/docs/release.md, oeffentlich unter /docs/release.md - dort,
wo auch das Bugtracker-Handbuch liegt. Das Entwickler-docs/ wird nicht
ausgeliefert; ein erster Anlauf legte die Vorlage dort ab und war deshalb
nicht abrufbar.

Beim Erproben in einem leeren Projekt aufgefallen und behoben:
- Die Vorlage verlangte jq. Das ist auf den wenigsten Systemen vorinstalliert;
  sie kommt jetzt auch mit Python aus.
- Windows legt unter WindowsApps einen python3-Platzhalter ab, der gefunden
  wird, beim Aufruf aber nur auf den Store verweist. Die Erkennung erprobt den
  Interpreter deshalb, statt nur seine Existenz zu pruefen.
- Der Ternary-Operator in release.ps1 gibt es erst ab PowerShell 7; die
  Vorlage laeuft jetzt auch mit dem mitgelieferten 5.1.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-14 13:23:38 +02:00

175 lines
6.5 KiB
PowerShell

<#
Baut den Update-Agent als eigenstaendige Installer-Binaries und legt sie
samt Pruefsummen, Manifest und Bootstrap-Skripten zum Upload bereit.
pwsh scripts/build_installer.ps1
python scripts/upload_installer.py .\artifacts\installer
Selbstenthaltend und als Einzeldatei: Auf einem frisch aufgesetzten
Zielsystem ist keine .NET-Laufzeit vorhanden, und ein Installer, der erst
eine Laufzeit nachinstalliert, hat sein Versprechen schon gebrochen.
Bewusst OHNE NativeAOT und ohne Trimming: Spectre.Console loest seine
Eingabeaufforderungen ueber Reflexion auf. Getrimmt baut das zwar, bricht
aber erst beim Anwender - ein groesseres Binary ist der bessere Handel.
#>
param(
[string] $Version = '2.3.0',
[string] $OutputDir = (Join-Path $PSScriptRoot '..\artifacts\installer'),
[string[]] $Runtimes = @('win-x64', 'linux-x64', 'linux-arm64')
)
$ErrorActionPreference = 'Stop'
$repoRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
$project = Join-Path $repoRoot 'client-dotnet\Deploymentcenter.UpdateAgent\Deploymentcenter.UpdateAgent.csproj'
$packager = Join-Path $repoRoot 'client-dotnet\Deploymentcenter.Packager\Deploymentcenter.Packager.csproj'
$staging = Join-Path ([System.IO.Path]::GetTempPath()) ("dc-installer-build-" + [guid]::NewGuid().ToString('N'))
if (-not (Test-Path $project)) {
throw "Projekt nicht gefunden: $project"
}
New-Item -ItemType Directory -Force -Path $OutputDir | Out-Null
Get-ChildItem $OutputDir -File | Remove-Item -Force
$gitCommit = 'UNKNOWN'
try { $gitCommit = (git -C $repoRoot rev-parse --short HEAD).Trim() } catch { }
$binaries = @()
try {
foreach ($rid in $Runtimes) {
Write-Host "Baue $rid ..." -ForegroundColor Cyan
$ridOut = Join-Path $staging $rid
dotnet publish $project `
-c Release -r $rid `
--self-contained true `
-p:PublishSingleFile=true `
-p:EnableCompressionInSingleFile=true `
-p:DebugType=None `
-o $ridOut `
-v q --nologo
if ($LASTEXITCODE -ne 0) {
throw "dotnet publish fuer $rid ist fehlgeschlagen."
}
$isWindows = $rid.StartsWith('win')
$sourceName = if ($isWindows) { 'update-agent.exe' } else { 'update-agent' }
$targetName = if ($isWindows) { "update-agent-$rid.exe" } else { "update-agent-$rid" }
$source = Join-Path $ridOut $sourceName
$target = Join-Path $OutputDir $targetName
Copy-Item $source $target -Force
$hash = (Get-FileHash $target -Algorithm SHA256).Hash.ToLower()
$size = (Get-Item $target).Length
# Die Pruefsumme liegt als eigene Datei daneben, damit install.sh sie
# ohne JSON-Parser lesen kann.
[System.IO.File]::WriteAllText("$target.sha256", $hash)
$binaries += [ordered]@{
platform = $rid
file = $targetName
sha256 = $hash
sizeBytes = $size
}
Write-Host (" {0,-22} {1,6:N1} MB {2}" -f $targetName, ($size / 1MB), $hash.Substring(0, 16))
}
# ------------------------------------------------------------------
# pack-and-deploy
# ------------------------------------------------------------------
# Das Veroeffentlichungswerkzeug wurde in der Anleitung benutzt, als laege
# es im PATH - beziehbar war es nirgends. Fremde Projekte konnten also
# nicht veroeffentlichen, ohne dieses Repository auszuchecken und selbst zu
# uebersetzen.
$tools = @()
if (Test-Path $packager) {
foreach ($rid in $Runtimes) {
Write-Host "Baue pack-and-deploy fuer $rid ..." -ForegroundColor Cyan
$ridOut = Join-Path $staging "packager-$rid"
dotnet publish $packager `
-c Release -r $rid `
--self-contained true `
-p:PublishSingleFile=true `
-p:EnableCompressionInSingleFile=true `
-p:DebugType=None `
-o $ridOut `
-v q --nologo
if ($LASTEXITCODE -ne 0) {
throw "dotnet publish (pack-and-deploy) fuer $rid ist fehlgeschlagen."
}
$isWindows = $rid.StartsWith('win')
$sourceName = if ($isWindows) { 'pack-and-deploy.exe' } else { 'pack-and-deploy' }
$targetName = if ($isWindows) { "pack-and-deploy-$rid.exe" } else { "pack-and-deploy-$rid" }
$target = Join-Path $OutputDir $targetName
Copy-Item (Join-Path $ridOut $sourceName) $target -Force
$hash = (Get-FileHash $target -Algorithm SHA256).Hash.ToLower()
[System.IO.File]::WriteAllText("$target.sha256", $hash)
$tools += [ordered]@{
platform = $rid
file = $targetName
sha256 = $hash
sizeBytes = (Get-Item $target).Length
}
Write-Host (" {0,-26} {1,6:N1} MB {2}" -f $targetName, ((Get-Item $target).Length / 1MB), $hash.Substring(0, 16))
}
} else {
Write-Warning "Packager-Projekt nicht gefunden - pack-and-deploy wird nicht mit ausgeliefert."
}
$manifest = [ordered]@{
tool = 'update-agent'
version = $Version
gitCommit = $gitCommit
buildDateUtc = (Get-Date).ToUniversalTime().ToString('o')
binaries = $binaries
tools = $tools
}
# Bewusst ueber WriteAllText mit einer BOM-freien Kodierung: Out-File
# -Encoding utf8 stellt unter Windows PowerShell 5.1 ein BOM voran, und
# PHPs json_decode() scheitert daran. Die Downloadseite haette dann
# dauerhaft "noch nichts hinterlegt" gemeldet.
$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
[System.IO.File]::WriteAllText(
(Join-Path $OutputDir 'installer.json'),
($manifest | ConvertTo-Json -Depth 5),
$utf8NoBom)
# Die Bootstrap-Skripte liegen versioniert im Repository und werden hier
# nur mitgenommen.
foreach ($script in @('install.sh', 'install.ps1')) {
$path = Join-Path $repoRoot "scripts\installer\$script"
if (Test-Path $path) {
Copy-Item $path (Join-Path $OutputDir $script) -Force
} else {
Write-Warning "$script nicht gefunden unter scripts\installer\ - wird nicht mit ausgeliefert."
}
}
Write-Host ''
Write-Host "Fertig. Ergebnis in $OutputDir" -ForegroundColor Green
Write-Host "Hochladen mit: python scripts/upload_installer.py `"$OutputDir`""
}
finally {
Remove-Item -Recurse -Force $staging -ErrorAction SilentlyContinue
}