Ansible-Rolle: Zammad

:warning: Dieses Projekt ist archiviert! :warning:

Diese Rolle wurde in unsere hifis.toolkit Sammlung migriert:

• https://github.com/hifis-net/ansible-collection-toolkit
• https://galaxy.ansible.com/ui/repo/published/hifis/toolkit/

Eine Ansible-Rolle, die die webbasierte Open-Source-Lösung zur Benutzerunterstützung/Ticketverwaltung Zammad installiert und konfiguriert.

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

Anforderungen

Die folgenden Anforderungen sind auf dem Zielhost nötig:

• cryptography >= 1.6.0

Variablen der Rolle

zammad_version: "6.2.0"

Zammad-Version, die installiert werden soll.

zammad_release_channel: "stable"

Wählen Sie einen anderen Release-Kanal für die Zammad-Pakete. Weitere Informationen finden Sie unter https://packager.io/gh/zammad/zammad.

zammad_domain_name: "{{ ansible_fqdn }}"

Der vollqualifizierte 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 privaten SSL/TLS-Schlüssel, der für HTTPS verwendet wird.

zammad_ssl_cert:

Inhalt des SSL/TLS-Zertifikats (erforderlich).

zammad_ssl_key:

Inhalt des privaten SSL/TLS-Schlüssels (erforderlich).
Bitte beachten: Wenn Sie zuvor ein SSL-Schlüsselpaar auf dem Host erstellt haben, z. B. über Let's Encrypt, müssen Sie die Variablen zammad_ssl_cert und zammad_ssl_key nicht konfigurieren. In jedem Fall wird die Rolle jedoch überprüfen, ob das SSL-Schlüsselpaar unter den Pfaden zammad_ssl_key_path und zammad_ssl_cert_path gültig ist.

zammad_nginx_server_tokens: "off"

Aktivieren oder deaktivieren Sie die Ausgabe von Nginx-Version-Informationen in Fehlerseiten oder im Server-Antwort-Headerfeld. Weitere Informationen finden Sie in der Nginx Dokumentation.

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 Serveranweisungen in der Nginx-Konfiguration. Dies ermöglicht spezifische Anpassungen, z.B. das Konfigurieren mehrerer Domains oder die Umleitung veralteter Domains zur neuesten.

elasticsearch_url: "http://localhost:9200"

Adresse des Elasticsearch-Servers.

Abhängigkeiten

Zammad benötigt Elasticsearch und einen 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

Autoreninformationen

Diese Rolle wurde 2020 von HIFIS Software Services erstellt.