Rola Ansible: Zammad

Rola Ansible, która instaluje i konfiguruje webowe rozwiązanie open source do wsparcia użytkowników/zarządzania zgłoszeniami Zammad.

Uwaga: Ta rola nie instaluje serwera Elasticsearch i PostgreSQL. Zobacz Zależności.

Wymagania

Poniższe wymagania są potrzebne na docelowym hoście:

• cryptography >= 1.6.0

Zmienne roli

zammad_version: "6.2.0"

Wersja Zammad, która ma być zainstalowana.

zammad_release_channel: "stable"

Wybierz inną wersję kanału dla pakietów Zammad. Proszę zapoznać się z https://packager.io/gh/zammad/zammad w celu uzyskania pełnej listy.

zammad_domain_name: "{{ ansible_fqdn }}"

Fully qualified domain name Zammad.

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

Ścieżka do pliku konfiguracyjnego Nginx dla Zammad.

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

Ścieżka do certyfikatu SSL/TLS używanego dla HTTPS.

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

Ścieżka do prywatnego klucza SSL/TLS używanego dla HTTPS.

zammad_ssl_cert:

Zawartość certyfikatu SSL/TLS (wymagana).

zammad_ssl_key:

Zawartość prywatnego klucza SSL/TLS (wymagana).
Uwaga: W przypadku, gdy wcześniej wprowadziłeś parę kluczy SSL na hoście, np. poprzez Let's Encrypt, nie musisz konfigurować zmiennych zammad_ssl_cert i zammad_ssl_key. Lecz w każdym przypadku rola zweryfikuje, czy para kluczy SSL pod ścieżkach zammad_ssl_key_path i zammad_ssl_cert_path jest ważna.

zammad_nginx_server_tokens: "off"

Włącz lub wyłącz wyświetlanie informacji o wersji Nginx na stronach błędów lub w nagłówku odpowiedzi Server. Proszę zapoznać się z dokumentacją Nginx tutaj w celu uzyskania dalszych informacji.

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;

        # ... konfiguracja SSL

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

Skonfiguruj dodatkowe dyrektywy serwera w konfiguracji Nginx. To pozwala na wprowadzenie bardziej specyficznych dostosowań, np. skonfigurowanie wielu domen lub przekierowanie przestarzałych domen na najbardziej aktualną.

elasticsearch_url: "http://localhost:9200"

Adres serwera Elasticsearch.

Zależności

Zammad wymagają serwera Elasticsearch i bazy danych PostgreSQL. Ta rola została pomyślnie przetestowana razem z następującymi rolami:

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

Przykład Playbooka

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

Licencja

MIT

Informacje o autorze

Ta rola została stworzona w 2020 roku przez HIFIS Software Services.