Release – Den Release zentral durchführen

Owned by Philipp Frick
Last updated: Sept. 24, 2024
2 min read

Releases werden auf Basis der Apps veröffentlicht. Apps bestehen aus einem Namen und einer Repository-URL, in der Regel ein Git-Repository, aus dem die App heruntergeladen werden kann. Apps können manuell gepflegt werden oder per Schnittstelle aus einem Gitlab-Repository ausgelesen werden.

Apps aus einer Gitlab-Instanz synchronisieren

  • Öffnen Sie das SaaS-Dashboard.

  • Öffnen Sie die SaaS-Konfiguration in der entsprechenden Kachel.

  • Pflegen Sie die folgenden Felder und speichern Sie.

Feld

Beschreibung

Feld

Beschreibung

ID der GitLab-Obergruppe der brandbox-Produkte

Die Gruppen-ID aus GitLab, mit der die Apps aus den Untergruppen dieser Gruppe in die Tabelle "Apps" synchronisiert werden.

ID der GitLab-Untergruppe mit core-Apps

Die Gruppen-ID der Untergruppe, die lizenzpflichtige Core-Apps enthält. Diese werden bei der Synchronisation entsprechend markiert.

  • Öffnen Sie nun die GitLab API Config in der Kachel "GitLab".

  • Hinterlegen Sie die API-URL Ihrer GitLab-Installation mit einem Zugangstoken, der Leserechte für die oben definierten Gruppen und Projekte hat.

  • Öffnen Sie nun die Apps-Tabelle in der Kachel "Release".

  • Klicken Sie in der Toolbar auf  "Apps synchronisieren" und bestätigen Sie.

  • Der Prozess lädt den Tab nach erfolgreicher Synchronisation neu und zeigt neue/geänderte Apps direkt an.

Ein Gitlab-Token kann nur ein Jahr gültig sein. Daher muss der Token jedes Jahr neu angelegt werden. Hierzu in Gitlab den User devops@konmedia.com impersonaten und in dessen Einstellungen einen Access-Token mit den Rechten api und read_repository anlegen.

Apps indizieren

Diese Funktion erstellt eine Abhängigkeitskette der Apps untereinander auf Basis des Composer-Baums. Der Baum wird über Eltern-Kind-Beziehungen von App zu App erstellt. Diese Information wird für die Lizensierung von Apps und Produkten benötigt.
Da der Baum aus Metadaten der verwendeten Release-Technologie (Satis) basiert, kann die Indizierung erst nach einem initialen Release ausgelöst werden.

  • Öffnen Sie die Apps-Tabelle in der Kachel "Release".

  • Klicken Sie in der Toolbar auf  "Apps indizieren" und bestätigen Sie.

  • Der Prozess lädt den Tab nach erfolgreicher Synchronisation neu.

Tipp: Stellen Sie in den Ansichtseinstellungen auf die Baum-Ansicht um, um die App-Beziehungen zu visualisieren.

Release starten

Der Release-Prozess erstellt ein statisches Composer-Repository mit Satis. Die geschieht durch das Deployment eines Satis-Docker-Containers in Kubernetes. Für den Release wird eine Kubernetes-Anbindung benötigt, in dem das Release-Host-System selbst auch laufen muss.

  • Öffnen Sie im Administrations-Dashboard die Lokale Kubernetes Konfiguration in der Kachel "Kubernetes".

  • Hinterlegen Sie API-Endpunkt für die Kubernetes-API, einen API-Token sowie den Namespace, in dem Satis deployed werden soll.

  • Öffnen Sie die Apps-Tabelle in der Kachel "Release".

  • Klicken Sie in der Toolbar auf  "Release starten" und bestätigen Sie.

  • Es erscheint eine Erfolgsmeldung, der Button "Release starten" wird ausgeblendet.

  • Der Prozess läuft asynchron und ist abgeschlossen, sobald der Button "Release starten" wieder erscheint. Hierzu die Ansicht in gewünschten Zeitabständen aktualisieren.

Hinweis: die Dauer des Releases hängt von der Anzahl Apps und deren getaggten Versionen ab.