Rôle Ansible : Zammad

:warning: Ce projet est archivé ! :warning:

Ce rôle a été migré vers notre collection hifis.toolkit :

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

Un rôle Ansible qui installe et configure la solution de support utilisateur/ticketing open source basée sur le web Zammad.

Note : Ce rôle n'installe pas le serveur Elasticsearch et PostgreSQL. Voir Dépendances.

Exigences

Les exigences ci-dessous sont nécessaires sur l'hôte cible :

• cryptography >= 1.6.0

Variables du rôle

zammad_version: "6.2.0"

Version de Zammad à installer.

zammad_release_channel: "stable"

Choisissez un autre canal de publication pour les paquets Zammad. Veuillez vous référer à https://packager.io/gh/zammad/zammad pour une liste complète.

zammad_domain_name: "{{ ansible_fqdn }}"

Nom de domaine complètement qualifié de Zammad.

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

Chemin du fichier de configuration Nginx de Zammad.

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

Chemin du fichier du certificat SSL/TLS utilisé pour HTTPS.

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

Chemin du fichier de la clé privée SSL/TLS utilisée pour HTTPS.

zammad_ssl_cert:

Contenu du certificat SSL/TLS (obligatoire).

zammad_ssl_key:

Contenu de la clé privée SSL/TLS (obligatoire).
Veuillez noter : Dans le cas particulier où vous avez précédemment mis un couple clé SSL sur l'hôte, par exemple via Let's Encrypt, vous ne devez pas configurer les variables zammad_ssl_cert et zammad_ssl_key. Néanmoins, dans tous les cas, le rôle validera si le couple de clés SSL donné sous les chemins zammad_ssl_key_path et zammad_ssl_cert_path est valide.

zammad_nginx_server_tokens: "off"

Activez ou désactivez l’émission des informations de version de Nginx dans les pages d’erreur ou dans le champ d'en-tête Server. Veuillez lire la documentation Nginx ici pour plus d'informations.

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;

        # ... Configuration SSL

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

Configurez des directives de serveur supplémentaires dans la configuration Nginx. Cela permet de mettre en œuvre des ajustements spécifiques selon les cas d'utilisation, par exemple, configurer plusieurs domaines ou rediriger des domaines obsolètes vers le plus récent.

elasticsearch_url: "http://localhost:9200"

Adresse du serveur Elasticsearch.

Dépendances

Zammad nécessite les serveurs Elasticsearch et PostgreSQL. Ce rôle a été testé avec succès avec les rôles suivants :

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

Exemple de Playbook

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

Licence

MIT

Informations sur l'auteur

Ce rôle a été créé en 2020 par HIFIS Software Services.