Automatisierung von Zitadel-Updates mit Autoupdate

Date: Tue, Mar 7, 2023

Tag(s): Automatisierung Zitadel Updates Autoupdate

Zitadel ist eine Open-Source-Identitätsmanagementplattform, die Funktionen wie Authentifizierung, Autorisierung, Multi-Tenancy und Audit-Trail bietet.

Chapati Systems Autoupdate ist ein Tool, das automatisch nach der neuesten Version von Zitadel (und anderen Softwarepaketen) auf GitHub sucht, diese herunterlädt und auf Ihrem Server installiert. Dafür wird eine Konfigurationsdatei (im INI-Format) benötigt, die Parameter für das Aktualisieren von Zitadel angibt, wie zum Beispiel:

update: ob automatische Updates aktiviert oder deaktiviert werden sollen
apiUrl: die URL der GitHub-API, um Informationen zur neuesten Version abzurufen
system: das Betriebssystem und die Architektur Ihres Servers
file: der Pfad zur Zitadel-Binärdatei auf Ihrem Server
serviceName: der Name des Dienstes, der Zitadel ausführt
config: der Pfad zur Zitadel-Konfigurationsdatei auf Ihrem Server
masterkey: der Master-Key zur Verschlüsselung und Entschlüsselung von Geheimnissen in Zitadel
tlsMode: ob interne oder externe TLS-Zertifikate für Zitadel verwendet werden sollen
preUpdateHook: (optional) ein Befehl, der vor dem Aktualisieren von Zitadel ausgeführt wird
postUpdateHook: (optional) ein Befehl, der nach dem Aktualisieren von Zitadel ausgeführt wird

Um Chapati Systems Autoupdate zu verwenden, müssen Sie es als Root-Benutzer auf Ihrem Server ausführen, mit einem Befehl wie dem folgenden:

root@server:/opt/config# ./autoupdate --config=/opt/config/server.ini

Dies liest die Konfigurationsdatei aus /opt/config/server.ini und führt die folgenden Schritte aus:

Abrufen der neuesten Versionsinformationen von https://api.github.com/repos/zitadel/zitadel/releases/latest
Vergleichen der aktuellen Version von Zitadel auf Ihrem Server mit der neuesten Version auf GitHub
Wenn es eine neuere Version gibt, diese von GitHub herunterladen und speichern
Wenn angegeben, wird preUpdateHook vor dem Aktualisieren von Zitadel ausgeführt
Stoppen des Dienstes, der Zitadel ausführt
Ersetzen der alten Binärdatei durch die neue
Ausführen der Migrationen mit dem von Zitadel bereitgestellten setup-Befehl
Starten des Dienstes, der Zitadel mit der Konfigurationsdatei ausführt
Wenn angegeben, wird postUpdateHook nach dem Aktualisieren von Zitadel ausgeführt

Das war’s! Sie haben Zitadel erfolgreich mit Chapati Systems Autoupdate aktualisiert.

Ich hoffe, dieser Blogbeitrag hilft Ihnen zu erklären, wie Chapati Systems Autoupdate funktioniert und wie es Benutzern helfen kann, ihre Identitätsmanagementplattform auf dem neuesten Stand zu halten.

See also