Features des Teamscale-Dogus
Kern-Features
Automatisierte Provisionierung
Bei der erstmaligen Installation des Teamscale-Dogus findet eine vollständige Provisionierung statt. Bestenfalls liegt nach der Installation eine direkt lauffähige Teamscale-Instanz vor. Die automatisierte Provisionierung hat ihre Grenzen in der Anwendung eines separat zu erwerbenden Teamscale-Lizenzschlüssels. Ein gültiger Lizenzschlüssel in dem Dogu-Config-Key teamscale_license ist hierbei die Voraussetzung.
Wichtig: Ohne gültigen Teamscale-Lizenzschlüssel lässt sich das Teamscale-Dogu zwar installieren. Allerdings fehlen wichtige Features im Teamscale. Insbesondere einige Teamscale-API-Calls funktionieren nicht ohne eine gültige Lizenz. Das betrifft u.A. die Synchronisierung der Benutzer/Gruppen und das Erstellen eines Backups. Aus diesem Grund ist eine gültige Lizenz auch zwingend erforderlich, um ein Upgrade des Teamscale-Dogus auszuführen, da dabei ein Backup erstellt und wieder eingespielt wird.
TIP: "cat teamscale.license | etcdctl set /config/teamscale/teamscale_license" Die Schlüsseldatei wird vom teamscale vor dem Start im Ordner /opt/teamscale/config/ erwartet. Danach muss das Dogu einmal manuell neu gestartet werden.
Weitere, Dogu-übliche Kern-Features
- Single Sign-On und Single Log-out über CAS
- Unterstützung von CES-Backup/-Restore
- Unterstützung bei Umbenennung relevanter Benutzergruppen
- Unterstützung bei Änderung der CES-Instanz-FQDN
Automatischer Import von Analyse-Profilen
Bei jedem Start des Teamscale-Dogus wird im Docker-Volume /var/lib/ces/teamscale/volumes/analysis_profiles nach Teamscale-Analyse-Profilen gesucht.
Die bereitgestellten Profile müssen auf .tsanalysisprofile enden und wurden bestenfalls direkt aus Teamscale exportiert.
Die Profil-Exporte werden nach einem erfolgreichen Import aus dem Verzeichnis gelöscht.
Treten bei dem Import Fehler auf, so wird eine Fehlermeldung ausgegeben aber der Gesamtprozess nicht abgebrochen.
Bereitstellung einer Barrierefreiheitserklärung
Über das Docker-Volume /var/lib/ces/teamscale/volumes/custom_config kann eine eigene Barrierefreiheitserklärung
bereitgestellt werden. Die Datei muss exakt declaration_of_accessibility.md heißen.
Befindet sich im Volume keine solche Datei, wird eine bereits bestehende Datei bei dem nächsten Start aus dem Dogu gelöscht.
Bereitstellung von eigenen Styles
Über das Docker-Volume /var/lib/ces/teamscale/volumes/custom_config können eigene Styles zur Anpassung von Teamscale
bereitgestellt werden. Die Datei muss exakt custom.css heißen.
Befindet sich im Volume keine solche Datei, wird eine bereits bestehende Datei bei dem nächsten Start aus dem Dogu gelöscht.
Bereitstellung von benutzerdefinierten Finding-Beschreibungen
Über das Docker-Volume /var/lib/ces/teamscale/volumes/custom_config können eigene Beschreibungen für Findings im Dogu hinterlegt werden.
Alle Dateien und Unterverzeichnisse werden bei dem Start des Dogus aus einem Verzeichnis finding-descriptions ausgelesen
und der Anwendungb bereitgestellt.
Liegen keine Beschreibungen vor, werden bereits ausgerollte Beschreibungen bei dem nächsten Start wieder entfernt.
Bereitstellung von Standard-Daten über den Import von Teamscale-Backup-Archiven
Über das Docker-Volume /var/lib/ces/teamscale/volumes/default_data_archives können Archive importiert werden.
Um die Archive zu importieren, müssen diese dort abgelegt werden. Anschließend muss das Dogu neu gestartet werden.
Nach dem Import der Archive werden diese automatisch aus dem Volume gelöscht.
Das Volume wird vom Backup nicht berücksichtigt.
Feature-Steuerung per Dogu-Konfigurationsschlüssel
Die folgenden Werte können per cesapp edit-config konfiguriert werden:
Lizenzkey
teamscale_license
Gravatar
Über den Schlüssel disable_gravatar kann gravatar deaktiviert werden.
Gültige Werte: TRUE | FALSE
Standardwert: TRUE
Ist der key nicht explizit auf FALSE gesetzt, so ist gravatar immer deaktiviert.
SCM Manager
Über den Schlüssel wait_for_scm_manager kann definiert werden, ob bei einem Upgrade so lange gewartet werden soll,
bis das SCM Manager Dogu erreichbar ist.
Gültige Werte: TRUE | FALSE
Standardwert: TRUE
Container-Ressourcen
Container Speicherlimit konfigurieren
container_config/memory_limit
Auslagerungsdatei konfigurieren
container_config/swap_limit
Java-Max-RAM-Wert konfigurieren
container_config/java_max_ram