Installationsanleitung

Beschreibung

Das Repository its-theinspection-swarm enthält Docker-Swarm-Konfigurationsdateien für das Projekt The Inspection.

Anforderungen

  1. Betriebssystem: Windows, Linux
  2. Docker mit initialisiertem Swarm-Modus
  3. Bash-Shell verfügbar

CLI-Skripts

  1. Laden Sie die neueste Version des CLI-Skripts über den Link herunter https://gitlab.com/theinspection/theinspection-cli/-/archive/v1.0.17/theinspection-cli-v1.0.17.zip
  2. Entpacken Sie das Archiv in einen Arbeitsordner.
  3. Initialisieren eines privaten Repositorys ./stack login

Erste Bereitstellung des Stacks

  1. Führen Sie ./stack init <stack> zur Initialisierung der Stack-Konfiguration und Passwörter aus.
  2. Aktualisieren Sie die Passwörter in ./stacks/<stack>.config.secret.yaml.
  3. Aktualisieren Sie die Konfiguration in ./stacks/<stack>.config.yaml.
  4. Führen Sie ./stack configure aus, um die Konfiguration zu überprüfen.
  5. Führen Sie ./stack deploy aus, um die Dienste zu starten.
  6. Führen Sie ./stack status aus, um den Status der Dienste zu prüfen.
  7. Führen Sie ./stack init_nc aus, um Tenants und Ordnerstruktur in Nextcloud zu erstellen.

  8. Führen Sie ./stack init_files aus, um Vorlagen für Berichte und Nachrichten in Nextcloud hochzuladen.

    Details zur Ordnerstruktur und dem Dateiimportprozess finden Sie in den Handbüchern zu Nextcloud und Dagster.

Stack aktualisieren

  1. Fügen Sie neue Konfigurationen hinzu oder aktualisieren Sie bestehende.
  2. Führen Sie ./stack deploy aus.
  3. Führen Sie ./stack status aus, um den Zustand der Dienste zu prüfen.
  4. (Optional) Führen Sie ./stack cleanup aus, um überflüssige Passwörter/Konfigurationen zu entfernen.

  5. (Optional) Führen Sie ./stack configure aus, um Änderungen zu prüfen, ohne neu zu deployen.

    Wichtig! Einige Konfigurationen können nicht nachträglich aktualisiert werden, da sie nur beim ersten Deployment verwendet werden (z. B. Datenbankpasswörter).

Stack entfernen

Zwei Befehle stehen zur Verfügung, um den aktuellen Stack zu löschen (definiert in .stack):

  • ./stack rm – löscht alle Volumes außer den Daten
  • ./stack rm-all – löscht alles, einschließlich Daten-Volumes