feat(setup): Erstinstallation ueber den Update-Agent, Installationskonto, Downloads
Bisher gab es nur den Update-Weg: eine Anwendung musste bereits installiert und eingerichtet sein, damit sich etwas aktualisieren liess. Die Erstinstallation auf einem neuen System war Handarbeit - Paket kopieren, Konfiguration abtippen, Token besorgen. Setup-API (neu) - POST /api/setup/v1/login tauscht Benutzername und Passwort gegen ein Token mit 30 Minuten Gueltigkeit und ausschliesslich setup:install. Es wird nicht mitgeschrieben und lebt im Installer nur im Speicher. - GET /api/setup/v1/catalog zeigt nur, was zur Laufzeitkennung des anfragenden Systems passt. Ein Projekt mit ausschliesslich Windows-Paket taucht auf einem Linux-Rechner gar nicht erst auf. - POST /api/setup/v1/token stellt das Dauertoken der Anwendung aus. Welche Rechte vergeben werden, entscheidet der Server; die Anfrage kann nur einschraenken. Sonst waere der Umweg ueber ein kurzlebiges Token wirkungslos. Rollentrennung (Migration 012) - dc_users bekommt role, disabled und last_login_at. Die Rolle "installer" darf sich ueber den Setup-Weg anmelden und nicht am WebUI. Die Zugangsdaten werden auf jedem Zielsystem eingetippt; mit einem Administratorkonto verteilte man damit den Zugang zu Tokens, Lizenzen und Monitoren auf jeden Rechner, auf dem je etwas installiert wurde. - Auth::verifyCredentials() prueft sessionfrei, damit Setup- und WebUI-Login nicht zwei verschiedene Haertungsgrade haben (Drosselung, Timing-Angleichung, Rehash gelten fuer beide). - Konten mit hinterlegtem TOTP-Geheimnis werden am Setup-Weg mit 501 abgewiesen. Eine TOTP-Pruefung gibt es im Deploymentcenter noch nicht; sie stillschweigend zu uebergehen waere ein Rueckschritt. - Benutzerverwaltung im WebUI - es gab bisher gar keine, nur den einen von install_db.php angelegten Admin. Das letzte aktive Administratorkonto laesst sich weder deaktivieren noch loeschen. Installer - update-agent --action install fuehrt durch Anmeldung, Auswahl, Zielverzeichnis, Installation und Einrichtung. Die Dateien kommen ueber denselben Pfad wie ein Update - mit Pruefsumme, Signatur, Staging und Rollback. Ein zweiter Download-Weg waere ein zweiter Ort fuer dieselben Fehler. - --action configure holt die Einrichtung nachtraeglich. - setup.json im Paket beschreibt die benoetigten Werte. Bewusst im Paket und nicht zentral: so ist sie mit der Anwendung versioniert. - Gefragt wird nur, was uebrig bleibt: bereits gesetzt -> detect:... -> provision -> fragen. Platzhalter wie changeme oder <dein-wert> gelten dabei nicht als eingerichtet, sonst liefe die Anwendung mit der Vorlage los. - SetupWriter erhaelt vorhandene Inhalte. Eine appsettings.json fuehrt neben den abgefragten Werten meist Logging und anderes; sie neu zu erzeugen waere bequemer und verloere das - bei einer Neuinstallation ohne Backup. int und bool landen als JSON-Typ, nicht als Zeichenkette. Downloads - scripts/build_installer.ps1 baut selbstenthaltende Einzeldateien fuer win-x64, linux-x64 und linux-arm64 (rund 34 MB, .NET-Laufzeit inbegriffen). Ohne NativeAOT und ohne Trimming: Spectre.Console loest ueber Reflexion auf und braeche sonst erst beim Anwender. - scripts/upload_installer.py laedt sie nach /installer/. Getrennt von deploy.py, das client-dotnet bewusst ausklammert. - Bereich "Installer" auf der UpdateService-Seite mit Groessen, Pruefsummen und den wget-Befehlen; die Angaben stammen aus installer.json statt aus fest eingetragenem Text. - install.sh und install.ps1 laden, pruefen die Pruefsumme und legen ab - sie richten bewusst nichts selbst ein. Das Manifest wird BOM-frei geschrieben, sonst scheitert json_decode() daran. Enthaelt ausserdem die bislang nicht committete Arbeit an den RocketChat-Benachrichtigungen (Migrationen 010 und 011) sowie die Loesch- und Editierfunktion des UpdateService; die betroffenen Dateien liessen sich nicht getrennt stagen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
co-authored by
Claude Opus 5
Claude Opus 5
parent
2388b5abe1
commit
c8f3e78635
@@ -0,0 +1,121 @@
|
||||
<#
|
||||
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'
|
||||
$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))
|
||||
}
|
||||
|
||||
$manifest = [ordered]@{
|
||||
tool = 'update-agent'
|
||||
version = $Version
|
||||
gitCommit = $gitCommit
|
||||
buildDateUtc = (Get-Date).ToUniversalTime().ToString('o')
|
||||
binaries = $binaries
|
||||
}
|
||||
|
||||
# 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
|
||||
}
|
||||
Reference in New Issue
Block a user