vendoo/docs/PRODUCTION_UPDATER_2_1.md

Vendoo Production Updater 2.1

Ziel

Production Updater 2.1 ersetzt den direkten, nicht ausreichend überwachten Worker-Start aus 2.0. Die Oberfläche besitzt jetzt bereits vor dem Worker-Start einen festen Laufzeitordner, einen bekannten Protokollpfad und einen initialen Status.

Worker-Host

Die Oberfläche startet ausschließlich Vendoo.Updater.Host.ps1. Dieser kleine Bootstrap-Host:

• prüft alle Übergabepfade,
• schreibt vor dem Laden des Update-Kerns einen Status,
• fängt Lade-, Parser- und Initialisierungsfehler des Worker-Kerns ab,
• schreibt die vollständige PowerShell-Ausnahme inklusive Datei und Zeile,
• garantiert einen terminalen Status,
• verliert weder Standardausgabe noch Standardfehler.

Der eigentliche Update-Kern läuft weiter in Vendoo.Updater.Worker.ps1, beendet aber nicht mehr eigenmächtig den PowerShell-Host. Erfolg, Abbruch und Fehler werden ausschließlich über den atomar geschriebenen Statusvertrag gemeldet.

Diagnose

Jeder Lauf besitzt einen eigenen Ordner unter:

%LOCALAPPDATA%\Vendoo\Updater\runtime\<Zeitstempel>

Darin liegen mindestens:

• status.json
• events.ndjson
• updater.log
• bei einem Host-Absturz zusätzlich worker.stdout.log und worker.stderr.log

Die Oberfläche zeigt den Protokollnamen sofort an. Mit Diagnoseordner kann der vollständige Laufzeitordner geöffnet werden. Der Protokollpfad kann nicht mehr leer sein.

Sicherheitsgrenzen

Die Änderungen betreffen ausschließlich den Updater-Unterbau. Vendoo 1.43.0, /app/data, Datenbanken, Uploads, Secrets und Coolify-Konfiguration werden dadurch nicht zurückgesetzt oder gelöscht.