Rôle Ansible : Zammad

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

Remarque : Ce rôle n'installe pas Elasticsearch ni le serveur 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 version pour les paquets Zammad. Veuillez consulter https://packager.io/gh/zammad/zammad pour une liste complète.

zammad_domain_name: "{{ ansible_fqdn }}"

Nom de domaine entièrement qualifié de Zammad.

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

Chemin d'accès au fichier de configuration Nginx de Zammad.

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

Chemin d'accès au certificat SSL/TLS utilisé pour HTTPS.

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

Chemin d'accès à la clé privée SSL/TLS utilisée pour HTTPS.

zammad_ssl_cert:

Contenu du certificat SSL/TLS (requise).

zammad_ssl_key:

Contenu de la clé privée SSL/TLS (requise).
Veuillez noter : Dans le cas particulier où vous avez déjà placé une paire de clés 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 la paire de clés SSL donnée sous les chemins zammad_ssl_key_path et zammad_ssl_cert_path est valide.

zammad_nginx_server_tokens: "off"

Activer ou désactiver l'émission d'informations sur la version de Nginx dans les pages d'erreur ou dans l'en-tête de réponse Server. Veuillez lire la documentation de Nginx 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;
      }

Configurer des directives supplémentaires pour le serveur dans la configuration Nginx. Cela permet de mettre en œuvre des ajustements spécifiques à des 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 Elasticsearch et le serveur de base de données 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.