Zum Inhalt

Lokale Installation DETECT

Es wird davon ausgegangen, dass alle Vorrausetzungen erfüllt wurden und alle benötigten Tools vorhanden sind.

Bei dieser Anleitung wird vorausgesetzt, dass Sie Erfahrungen mit Linux-System docker und docker-compose haben. Andernfalls nutzen Sie bitte die detailierte Beispielinstallation

Installationsdaten herunterladen

DETECT wird als ein tar-Archiv ausgeliefert, welches ansible-spezifische Dateien für die Installation der Software enthält. Die jeweilige, versionsspezfische Deploymentdatei können Sie in der Package-Registry herunterladen. Als Grundlage benutzt die Installation die Tools ansible und docker welche auf dem Zielsystem bereits installiert sein müssen. Die benötigten Docker-Images können über die Container-Registry des Gitlab-Repositorys geladen werden.

Der Support für docker-compose v1 wurde von Docker im Juli 2023 eingestellt. Unsere Dokumentation bezieht sich nur noch auf docker-compose v2.

Nach dem Entpacken des Ordners kann folgende Struktur vorgefunden werden:

playbook.yml
readme.md
roles/
sample-extra-variables.yml
sample-variables.yml

Umgebungsvariablen konfigurieren

Wechseln Sie in das Installationsverzeichnis. Kopieren Sie die Datei sample-variables.yml nach variables.yml und passen Sie sie entsprechend Ihrer Umgebung an. Bitte beachten Sie dazu auch die Informationen in der Datei Readme.md.

Installation per ansible

Wie in der readme.md Datei beschrieben, nutzen Sie nun ansible, um DETECT in das in der Datei variables.yml angegebene Verzeichnis zu installieren.

ansible-playbook playbook.yml -i localhost, --connection=local -e "@variables.yml" -v

Dabei werden die benötigten Container heruntergeladen, die Konfigurationsscripte erstellt und im letzten Schritt die Container per docker compose gestartet.

Soll nicht auf den aktuell genutzten Rechner, sondern auf eine entfernte Maschine installiert werden, kann man das Kommando entsprechend anpassen (Ziel Host ist bswp. 192.168.1.2) und so die mächtigen und vielfältigen Optionen von ansible nutzen.

ansible-playbook playbook.yml -i 192.168.1.2, -e "@variables.yml" -v

Installation validieren

Wenn ansible keinen Fehler gemeldet hat, wurde DETECT bereits gestartet und Sie können über die Befehle docker und docker compose die gestarteten Container verwalten, Logs einsehen, usw.. Die generierte docker-compose.yml Datei finden Sie im definierten DETECT-Ordner.