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 |
|---|---|
| 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. |
| 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.
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.