Ansible-Rolle: Zammad

Eine Ansible-Rolle, die die webbasierte Open-Source-Lösung für Benutzer- und Ticketunterstützung Zammad installiert und konfiguriert.

Hinweis: Diese Rolle installiert nicht den Elasticsearch- und PostgreSQL-Server. Siehe Abhängigkeiten.

Anforderungen

Die folgenden Anforderungen müssen auf dem Zielhost erfüllt sein:

• cryptography >= 1.6.0

Rollenvariablen

zammad_version: "6.2.0"

Die Zammad-Version, die installiert werden soll.

zammad_release_channel: "stable"

Wählen Sie einen anderen Veröffentlichungs-Kanal für die Zammad-Pakete. Bitte beachten Sie https://packager.io/gh/zammad/zammad für eine vollständige Liste.

zammad_domain_name: "{{ ansible_fqdn }}"

Der vollständig qualifizierte Domainname von Zammad.

zammad_nginx_config_path: "/etc/nginx/sites-available/zammad.conf"

Dateipfad zur Nginx-Konfiguration von Zammad.

zammad_ssl_cert_path: "/etc/ssl/certs/zammad_cert.pem"

Dateipfad zum SSL/TLS-Zertifikat, das für HTTPS verwendet wird.

zammad_ssl_key_path: "/etc/ssl/private/zammad_key.pem"

Dateipfad zum SSL/TLS-Privatschlüssel, der für HTTPS verwendet wird.

zammad_ssl_cert:

Inhalt des SSL/TLS-Zertifikats (erforderlich).

zammad_ssl_key:

Inhalt des SSL/TLS-Privatschlüssels (erforderlich).
Bitte beachten: Falls Sie zuvor ein SSL-Zertifikat-Paar auf dem Host eingerichtet haben, z.B. über Let's Encrypt, müssen Sie die Variablen zammad_ssl_cert und zammad_ssl_key nicht konfigurieren. Die Rolle wird dennoch überprüfen, ob das SSL-Zertifikat-Paar unter den Pfaden zammad_ssl_key_path und zammad_ssl_cert_path gültig ist.

zammad_nginx_server_tokens: "off"

Aktivieren oder Deaktivieren der Ausgabe von Nginx-Version Informationen in Fehlerseiten oder im Server Antwort-Header-Feld. Bitte lesen Sie die Nginx Dokumentation für weitere Informationen.

zammad_nginx_additional_server_configs:
  - |
      server {
        listen 80;
        server_name zammad.example.com zammad-old.example.com;
        return 301 https://zammad.example.com$request_uri;
      }
  - |
      server {
        listen 443 ssl;

        # ... SSL-Konfiguration

        server_name zammad-old.example.com;
        return 301 https://zammad.example.com$request_uri;
      }

Konfigurieren Sie zusätzliche Server-Direktiven in der Nginx-Konfiguration. Damit können spezifische Anpassungen vorgenommen werden, z.B. die Konfiguration mehrerer Domains oder die Weiterleitung von alten Domains zur neuesten.

elasticsearch_url: "http://localhost:9200"

Adresse des Elasticsearch-Servers.

Abhängigkeiten

Zammad benötigt einen Elasticsearch- und PostgreSQL-Datenbankserver. Diese Rolle wurde erfolgreich zusammen mit den folgenden Rollen getestet:

• Elasticsearch - geerlingguy.elasticsearch
• PostgreSQL - geerlingguy.postgresql

Beispiel-Playbook

    - hosts: servers
      roles:
         - role: hifis.zammad
           become: yes

Lizenz

MIT

Autoreninformation

Diese Rolle wurde 2020 von HIFIS Software Services erstellt.