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
co-authored by
Claude Opus 5
Claude Opus 5
parent
5f9b0c5596
commit
2388b5abe1
@@ -3,7 +3,18 @@ using System;
|
||||
namespace Deploymentcenter.Client.Models
|
||||
{
|
||||
/// <summary>
|
||||
/// Runtime accessibility for build metadata embedded at compile-time.
|
||||
/// Zur Laufzeit setzbare Build-Daten des SDK selbst.
|
||||
///
|
||||
/// NICHT die Klasse, die Deploymentcenter.BuildInfo.targets erzeugt: die
|
||||
/// entsteht im Namensraum des einbindenden Projekts und traegt dessen
|
||||
/// Version. Diese hier ist nur ein Ablageort fuer Anwendungen, die ihre
|
||||
/// Version zur Laufzeit von Hand setzen wollen.
|
||||
///
|
||||
/// Der Zielnamensraum des Targets laesst sich ueber
|
||||
/// DeploymentcenterBuildInfoNamespace umstellen - er darf nur nicht auf
|
||||
/// diesen hier zeigen: partial verbindet Teilklassen nur innerhalb
|
||||
/// derselben Assembly, ueber Assemblygrenzen hinweg entstuenden zwei Typen
|
||||
/// mit demselben vollen Namen (CS0433).
|
||||
/// </summary>
|
||||
public static class BuildInfo
|
||||
{
|
||||
|
||||
@@ -0,0 +1,58 @@
|
||||
using System;
|
||||
using System.Text.Json;
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace Deploymentcenter.Client.Models
|
||||
{
|
||||
/// <summary>
|
||||
/// Liest Wahrheitswerte, die nicht als JSON-Boolean ankommen.
|
||||
///
|
||||
/// Die Deploymentcenter-API reicht Release-Zeilen unveraendert aus MySQL
|
||||
/// durch. <c>is_critical</c> ist dort TINYINT(1) und erscheint je nach
|
||||
/// PDO-Einstellung als 1, "1" oder true. Der Standardkonverter von
|
||||
/// System.Text.Json wirft bei allem ausser true/false - und der Fehler
|
||||
/// haette den gesamten Release-Datensatz unbrauchbar gemacht.
|
||||
/// </summary>
|
||||
public class FlexibleBoolConverter : JsonConverter<bool>
|
||||
{
|
||||
public override bool Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
|
||||
{
|
||||
switch (reader.TokenType)
|
||||
{
|
||||
case JsonTokenType.True:
|
||||
return true;
|
||||
|
||||
case JsonTokenType.False:
|
||||
case JsonTokenType.Null:
|
||||
return false;
|
||||
|
||||
case JsonTokenType.Number:
|
||||
return reader.TryGetInt64(out long number) ? number != 0 : reader.GetDouble() != 0d;
|
||||
|
||||
case JsonTokenType.String:
|
||||
string? value = reader.GetString();
|
||||
if (string.IsNullOrWhiteSpace(value))
|
||||
return false;
|
||||
|
||||
value = value!.Trim();
|
||||
|
||||
if (bool.TryParse(value, out bool parsed))
|
||||
return parsed;
|
||||
|
||||
if (long.TryParse(value, out long numeric))
|
||||
return numeric != 0;
|
||||
|
||||
return value.Equals("yes", StringComparison.OrdinalIgnoreCase)
|
||||
|| value.Equals("on", StringComparison.OrdinalIgnoreCase);
|
||||
|
||||
default:
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
public override void Write(Utf8JsonWriter writer, bool value, JsonSerializerOptions options)
|
||||
{
|
||||
writer.WriteBooleanValue(value);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -19,6 +19,14 @@ namespace Deploymentcenter.Client.Models
|
||||
[JsonPropertyName("channel")]
|
||||
public string Channel { get; set; } = "prod";
|
||||
|
||||
/// <summary>
|
||||
/// Laufzeitkennung des Pakets ("win-x64", "linux-x64", ...) oder
|
||||
/// "any". Fehlt das Feld, stammt das Manifest aus der Zeit vor der
|
||||
/// Plattform-Dimension und gilt als plattformunabhaengig.
|
||||
/// </summary>
|
||||
[JsonPropertyName("platform")]
|
||||
public string Platform { get; set; } = PlatformId.Any;
|
||||
|
||||
[JsonPropertyName("buildDate")]
|
||||
public string BuildDate { get; set; } = string.Empty;
|
||||
|
||||
@@ -31,6 +39,20 @@ namespace Deploymentcenter.Client.Models
|
||||
[JsonPropertyName("changelog")]
|
||||
public string Changelog { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Muster fuer Dateien, die zwar im Paket liegen, eine vorhandene
|
||||
/// Datei am Ziel aber nicht ersetzen duerfen - typischerweise
|
||||
/// Konfigurationsvorlagen wie appsettings.json.
|
||||
///
|
||||
/// Ausschluss beim Packen und Schutz beim Anwenden sind zwei
|
||||
/// verschiedene Dinge. Wer eine Konfigurationsvorlage ausliefern will,
|
||||
/// kann sie nicht einfach vom Paket ausnehmen; sie darf nur beim
|
||||
/// Update nicht ueber die eingerichtete Fassung des Zielsystems
|
||||
/// geschrieben werden.
|
||||
/// </summary>
|
||||
[JsonPropertyName("preserve")]
|
||||
public List<string> Preserve { get; set; } = new List<string>();
|
||||
|
||||
[JsonPropertyName("files")]
|
||||
public List<PackageFileEntry> Files { get; set; } = new List<PackageFileEntry>();
|
||||
}
|
||||
|
||||
@@ -15,6 +15,13 @@ namespace Deploymentcenter.Client.Models
|
||||
[JsonPropertyName("channel")]
|
||||
public string Channel { get; set; } = "prod";
|
||||
|
||||
/// <summary>
|
||||
/// Laufzeitkennung des Kanals. Fehlt sie, stammt die Datei aus der
|
||||
/// Zeit vor der Plattform-Dimension und gilt als "any".
|
||||
/// </summary>
|
||||
[JsonPropertyName("platform")]
|
||||
public string Platform { get; set; } = PlatformId.Any;
|
||||
|
||||
[JsonPropertyName("latest")]
|
||||
public VersionInfo? Latest { get; set; }
|
||||
|
||||
@@ -22,6 +29,80 @@ namespace Deploymentcenter.Client.Models
|
||||
public List<VersionInfo> Versions { get; set; } = new List<VersionInfo>();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Release-Daten so, wie sie <c>/api/updateservice/v1/check</c> unter
|
||||
/// <c>latest_release</c> liefert: die Zeile aus <c>updateservice_releases</c>
|
||||
/// mit ihren Spaltennamen.
|
||||
///
|
||||
/// Bewusst ein eigenes Modell. Zuvor wurde die API-Antwort in
|
||||
/// <see cref="VersionInfo"/> deserialisiert, das die camelCase-Namen der
|
||||
/// statischen latest.json traegt. Von beiden Formaten stimmt nur "version"
|
||||
/// ueberein - ueber die API kamen also weder Download-Adresse noch Pruefsumme,
|
||||
/// Changelog oder Kritikalitaet an. Der API-Zweig ist genau der Rueckfall,
|
||||
/// wenn die latest.json fehlt; er degradierte damit still.
|
||||
/// </summary>
|
||||
public class ApiReleaseInfo
|
||||
{
|
||||
[JsonPropertyName("version")]
|
||||
public string Version { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("channel")]
|
||||
public string Channel { get; set; } = "prod";
|
||||
|
||||
[JsonPropertyName("platform")]
|
||||
public string Platform { get; set; } = PlatformId.Any;
|
||||
|
||||
[JsonPropertyName("download_url")]
|
||||
public string DownloadUrl { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// RSA-SHA256 ueber die kanonische Release-Zeile, base64. Der Server
|
||||
/// bildet sie beim Veroeffentlichen; leer, wenn dort kein
|
||||
/// Signierschluessel hinterlegt ist.
|
||||
/// </summary>
|
||||
[JsonPropertyName("manifest_signature")]
|
||||
public string ManifestSignature { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("sha256_hash")]
|
||||
public string Sha256Hash { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("release_notes")]
|
||||
public string ReleaseNotes { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("git_commit")]
|
||||
public string GitCommit { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("size_bytes")]
|
||||
public long SizeBytes { get; set; }
|
||||
|
||||
[JsonPropertyName("created_at")]
|
||||
public string CreatedAt { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// MySQL liefert TINYINT(1) als 0/1, PHP je nach Treiber auch als
|
||||
/// Zeichenkette. <see cref="FlexibleBoolConverter"/> nimmt beides.
|
||||
/// </summary>
|
||||
[JsonPropertyName("is_critical")]
|
||||
[JsonConverter(typeof(FlexibleBoolConverter))]
|
||||
public bool IsCritical { get; set; }
|
||||
|
||||
/// <summary>Uebersetzt in das Modell, das Aufrufer bereits kennen.</summary>
|
||||
public VersionInfo ToVersionInfo() => new VersionInfo
|
||||
{
|
||||
Version = Version,
|
||||
BuildDate = CreatedAt,
|
||||
GitCommit = GitCommit,
|
||||
GitCommitShort = GitCommit.Length >= 7 ? GitCommit.Substring(0, 7) : GitCommit,
|
||||
PackageUrl = DownloadUrl,
|
||||
Sha256 = Sha256Hash,
|
||||
SizeBytes = SizeBytes,
|
||||
Changelog = ReleaseNotes,
|
||||
IsCritical = IsCritical,
|
||||
Platform = Platform,
|
||||
Signature = ManifestSignature
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Individual release version details.
|
||||
/// </summary>
|
||||
@@ -53,5 +134,21 @@ namespace Deploymentcenter.Client.Models
|
||||
|
||||
[JsonPropertyName("isCritical")]
|
||||
public bool IsCritical { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Laufzeitkennung des Pakets. Aeltere latest.json-Dateien kennen das
|
||||
/// Feld nicht; sie gelten dann als plattformunabhaengig.
|
||||
/// </summary>
|
||||
[JsonPropertyName("platform")]
|
||||
public string Platform { get; set; } = PlatformId.Any;
|
||||
|
||||
/// <summary>
|
||||
/// Signatur des Servers, sofern der Agent das Release ueber die API
|
||||
/// bezogen hat. Die statische latest.json fuehrt sie nicht: sie wird
|
||||
/// vom Packager geschrieben, und der besitzt den Signierschluessel
|
||||
/// bewusst nicht.
|
||||
/// </summary>
|
||||
[JsonPropertyName("signature")]
|
||||
public string Signature { get; set; } = string.Empty;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user