ansible-role-zammad

Diese Rolle installiert und/oder konfiguriert Zammad, bekannt von https://zammad.org.

Anforderungen

Um Zammad auszuführen, müssen Sie die Anforderungen unter https://docs.zammad.org/en/latest/prerequisites-software.html erfüllen.

Bitte beachten Sie, dass es stark empfohlen wird, den Datenbankserver nicht auf der gleichen Maschine wie Zammad selbst auszuführen.

Sie müssen vorher Ruby, Bundler, Rake und Rails installieren. Verwenden Sie zum Beispiel geerlingguy.ruby, wählen Sie jedoch die Option, Ruby aus dem Quellcode zu kompilieren, da Pakete des Paketmanagers veraltet sein können.

Rollenvariablen

# Installieren Sie die Voraussetzungen über apt (deaktivieren Sie dies und installieren Sie manuell, um einen anderen Paketmanager zu verwenden)
zammad_install_prerequisites: true

# Installieren Sie Zammad selbst (aus dem Quellcode)
zammad_install: true

# Konfigurieren Sie eine bestehende Zammad-Installation (die Einrichtung kann durch Setzen von ```zammad_install``` auf true erfolgen)
zammad_configure: false

# Installieren Sie Nginx als Reverse-Proxy vor Zammad
zammad_install_nginx: true

# Konfigurieren Sie bestehendes Nginx als Reverse-Proxy für die Zammad-Installation
zammad_configure_nginx: false

# Entfernen Sie den Standard-vhost von Nginx, um nur Zammad zu aktivieren
zammad_remove_nginx_default_vhost: false

# Auf true setzen, um die Datenbank zu erstellen
zammad_db_create: false

# Auf true setzen, um Datenbankmigrationen durchzuführen (dies MUSS erfolgen, wenn zammad_db_create auf true gesetzt ist)
zammad_db_migrate: false

# Auf true setzen, um die Datenbank mit Anfangswerten zu befüllen (DIES NICHT AN EINER BESTEHENDEN DATENBANK DURCHFÜHREN!)
zammad_db_seed: false

# Auf true setzen, um mit MySQL als Datenbanktreiber zu installieren
zammad_db_mysql: true

# Auf true setzen, um mit PostgreSQL als Datenbanktreiber zu installieren
zammad_db_postgresql: false

Setzen Sie nicht beide zammad_db_mysql und zammad_db_postgresql auf true!

# Datenbankparameter sollten selbsterklärend sein    
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad

# Der Benutzername, unter dem Zammad installiert werden soll
zammad_user: zammad

# Die Gruppe, unter der Zammad installiert werden soll
zammad_group: zammad

# Auf true setzen, um Benutzer und Gruppe automatisch zu erstellen, wenn sie noch nicht existieren
zammad_user_group_create: true

# Installation von Systemd-Diensten aktivieren oder deaktivieren
zammad_install_systemd_service: true

# Auf true setzen, um statische Assets vorzubereiten (Datenbank muss eingerichtet und funktionsfähig sein)
zammad_precompile_assets: false

Vorschlag zur Nutzung in der Cloud

Wenn Sie zum Beispiel eine AMI bereitstellen möchten, die nur Zammad ausführt, sollten Sie es einrichten, aber nicht konfigurieren:

zammad_install_prerequisites: true
zammad_install: true
zammad_configure: false
zammad_install_nginx: true
zammad_configure_nginx: false
zammad_remove_nginx_default_vhost: false
zammad_db_create: false
zammad_db_migrate: false
zammad_db_seed: false
zammad_db_mysql: true oder false
zammad_db_postgresql: false oder true
zammad_user: zammad
zammad_group: zammad
zammad_user_group_create: true
zammad_install_systemd_service: true
zammad_precompile_assets: false

In Ihrer Bereitstellungskonfiguration sollten Sie es dann konfigurieren:

zammad_install_prerequisites: false
zammad_install: false
zammad_configure: true
zammad_install_nginx: false
zammad_configure_nginx: true
zammad_remove_nginx_default_vhost: true
zammad_db_create: false
zammad_db_migrate: true
zammad_db_seed: false
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad
zammad_user: zammad
zammad_group: zammad
zammad_user_group_create: false
zammad_install_systemd_service: false
zammad_precompile_assets: true

Ein spezieller Fall ist der allererste Durchlauf, wenn Sie noch keine Datenbank haben. Sie haben zwei Optionen: Entweder die Datenbank manuell erstellen und einmal Ansible mit zammad_db_seed auf true ausführen, oder einmal Ansible mit zammad_db_create auf true und zammad_db_seed auf true ausführen. (Aber dann müssen Sie einen Benutzer bereitstellen, der berechtigt ist, eine Datenbank zu erstellen!)

Abhängigkeiten

Bisher keine.

Beispiel-Playbook

- hosts: servers
  roles:
     - { role: solutiondrive.ansible-role-zammad }

Lizenz

MIT

Autoreninformation

Erstellt von der solutionDrive GmbH. https://solutionDrive.de/