Updates & Versionswechsel

Admin

Ziel

Eine bestehende Installation auf eine neue Version heben – je nach Betriebsart unterschiedlich.

Web / Docker

Das Web-Deployment ist ein einzelnes Container-Image (API + Blazor-WASM zusammen). Images werden tag-getriggert in der CI gebaut und als :latest und :<tag> (z. B. :v0.29.0) in die Registry geschoben.

Versionsstand erhöhen, Commit taggen, Tag pushen → CI baut und pusht das Image.
Im Deployment (Helm im separaten evanto-deployment-Repo, Branch production) das Image-Tag auf die neue Version setzen und ausrollen.
Beim Start prüfen: /alive und /ready (siehe Monitoring & Health-Checks).

Externe Dienste (Qdrant, Presidio) werden separat betrieben und unabhängig aktualisiert.

Desktop (macOS)

Die Desktop-App wird manuell aktualisiert (kein Auto-Update): neues Installer-Paket installieren. Der Build erfolgt über macos/build-macos.sh (dotnet publish, self-contained; Hilfe-Inhalte werden ins App-Bundle gelegt).

Neues App-Bundle/Paket beziehen und installieren.
App starten – DbInitializer bringt das Schema auf Stand und spielt aktualisierte Hilfe-Vaults ein.

Vor einem Desktop-Versionswechsel eine Sicherung anlegen.

Hilfe-Inhalte (help-de / help-en)

Die In-App-Hilfe ist versioniert über eine .help-version-Datei je Vault. Beim Start gilt: Frischinstallation → kopieren; gleiche Version → nichts; neuere gebündelte Version → überschreiben. Zum Ausliefern neuer Hilfe also .help-version erhöhen und mit dem Image/Bundle ausliefern.

Worauf achten

Schema-Änderungen brauchen zwei Stellen: EF-Migration und ein passender EnsureColumnExistsAsync-Eintrag im DbInitializer. Beim Start läuft nur DbInitializer.InitializeAsync, nicht MigrateAsync.
Modellkatalog: Vor Releases den gebündelten Snapshot aktualisieren (docs/catalog-snapshot.md).
index.html geändert? Im Aspire-Betrieb muss der Host neu gestartet werden – ein reiner Build reicht nicht.
Versionssprung + Restore: Sicherung immer in eine gleich neue oder neuere App-Version einspielen (siehe BW-01).

Verifikation

/health grün (Web), Anmeldung möglich, Wissenssuche liefert Treffer.
Hilfe zeigt die neuen Inhalte; Admin-Tabs laden fehlerfrei.