feat(updateservice): Plattform-Dimension, signierte Releases, Update mit Rollback

Behebt eine Reihe zusammenhaengender Fehler im Update-Weg, die zusammen
verhindert haben, fuer mehr als eine Plattform auszuliefern - und die im
Fehlerfall halb aktualisierte Installationen hinterliessen.

Server
- Migration 009: Spalte platform samt neuem Unique-Key. Zuvor verdraengte das
  zuletzt veroeffentlichte Paket alle anderen Plattformen derselben Version,
  weil ON DUPLICATE KEY auf (slug, version, channel) griff. Ein Linux-System
  zog sich damit das Windows-Paket.
- Aufloesungsregel: je Version das plattformgenaue Paket, sonst das
  plattformunabhaengige. Ein Client ohne Plattformangabe sieht ausschliesslich
  'any' - lieber kein Update als das falsche.
- manifest_json wird endlich befuellt; die Spalte blieb bisher immer leer,
  wodurch die API nie der Rueckfall sein konnte, als der sie gedacht war.
- Releases werden serverseitig mit RSA-SHA256 signiert, neuer Endpunkt
  /api/updateservice/v1/pubkey. Bewusst kein HMAC: der Pruefende laeuft auf
  fremden Systemen und darf den Signierschluessel nicht besitzen.

Packager
- Bricht ab, statt die Versionshistorie zu verlieren. Schlug das Lesen der
  bestehenden latest.json fehl, ersetzte ein leeres catch die komplette
  Historie durch einen einzigen Eintrag - ohne jede Meldung.
- Echte Glob-Muster. Zuvor trafen "logs/**" und "scratch/**" aus der
  mitgelieferten Beispielkonfiguration nie zu.
- preservePatterns: Konfigurationsvorlagen werden ausgeliefert, ersetzen am
  Ziel aber keine vorhandene Datei. Eine settings.json mit Zugangsdaten
  ueberschrieb bisher beim Update die Konfiguration jedes Zielsystems.
- Warnt vor Dateien, die nach Zugangsdaten aussehen und auf keiner Liste stehen.
- Prueft --version gegen die Hauptassembly. Eine Abweichung fuehrte zu einer
  Endlosschleife: Clients aktualisieren, melden weiter die alte Version,
  halten das Release erneut fuer neu.
- --platform mit Ableitung aus dem Publish-Pfad.

Agent
- Anwenden mit Plan, Backup und vollstaendigem Rollback. Die Stelle war als
  "Atomic Replace with Backup" kommentiert und war eine Kopierschleife.
- Verwaiste Dateien werden entfernt, aber nur solche aus dem Manifest der
  Vorversion. Was nicht aus einem Release stammt, bleibt liegen.
- Das laufende Agent-Binary wird zur Seite gelegt statt ueberschrieben.
- API-Rueckfall in FetchManifestAsync; bisher nur im SDK vorhanden, weshalb
  die Anwendung "Update verfuegbar" und der Agent "kein Release" sagen konnte.
- Installierte Version aus --current-version oder manifest.json statt des
  Textes "Unbekannt", der als 0 gelesen wurde und jede Version neuer erscheinen
  liess. Reparatur funktioniert damit auch ohne manifest.json.
- Setzt das Ausfuehrungsbit fuer Linux-Pakete, die unter Windows gebaut wurden.

SDK
- ResolveAgentPath() liefert den plattformrichtigen Namen; ein fest verdrahtetes
  "update-agent.exe" wird unter Linux nie gefunden.
- LaunchUpdateAgent uebergibt jetzt --restart (wurde nie uebergeben, die
  Anwendung blieb nach dem Update zu), --wait-for-pid (kein Wettlauf mehr mit
  dem Herunterfahren) und --platform.

Enthaelt ausserdem die bislang nicht committete Arbeit an Watchdog, Lizenz-
Client und cli/tick.php samt Migration 008; die betroffenen Dateien liessen
sich nicht getrennt stagen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
2026-08-09 19:56:35 +02:00
co-authored by Claude Opus 5
parent 5f9b0c5596
commit 2388b5abe1
37 changed files with 5498 additions and 491 deletions
+13 -1
View File
@@ -94,6 +94,8 @@ CREATE TABLE IF NOT EXISTS watchdog_monitors (
is_muted TINYINT(1) NOT NULL DEFAULT 0,
expect_running TINYINT(1) NOT NULL DEFAULT 1,
os VARCHAR(50) NULL,
-- Version der laufenden Anwendung, vom Heartbeat mitgeliefert (optional).
app_version VARCHAR(64) NULL,
first_contact_deadline_utc DATETIME NULL,
ack_until_utc DATETIME NULL,
acknowledged_by VARCHAR(100) NULL,
@@ -168,15 +170,25 @@ CREATE TABLE IF NOT EXISTS updateservice_releases (
product_slug VARCHAR(64) NOT NULL,
version VARCHAR(32) NOT NULL,
channel VARCHAR(32) NOT NULL DEFAULT 'prod',
-- Laufzeitkennung (win-x64, linux-x64, ...) oder 'any' fuer
-- plattformunabhaengige Releases. Ohne diese Spalte ueberschrieben sich
-- Pakete verschiedener Plattformen derselben Version gegenseitig.
platform VARCHAR(32) NOT NULL DEFAULT 'any',
release_notes TEXT NULL,
download_url VARCHAR(255) NOT NULL,
sha256_hash VARCHAR(64) NULL,
git_commit VARCHAR(64) NULL,
size_bytes BIGINT NOT NULL DEFAULT 0,
manifest_json JSON NULL,
-- RSA-SHA256 ueber die kanonische Release-Zeile, base64-kodiert. Signiert
-- mit security.release_private_key, geprueft vom Agenten gegen den
-- oeffentlichen Schluessel. Kein HMAC - der Pruefende laeuft auf fremden
-- Systemen und darf den Signierschluessel nicht besitzen.
manifest_signature TEXT NULL,
is_critical TINYINT(1) NOT NULL DEFAULT 0,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
UNIQUE KEY uq_prod_ver_chan (product_slug, version, channel)
UNIQUE KEY uq_prod_ver_chan_plat (product_slug, version, channel, platform),
KEY ix_us_lookup (product_slug, channel, platform)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 5. Core Token Hierarchy & Bugtracker Tables