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>
This commit is contained in:
Deploymentcenter Bot
2026-08-14 13:23:38 +02:00
co-authored by Claude Opus 5
parent 56b1d2631a
commit e01a608c08
7 changed files with 843 additions and 0 deletions
+53
View File
@@ -24,6 +24,7 @@ $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)) {
@@ -83,12 +84,64 @@ try {
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