Rol de Ansible: Zammad

Un rol de Ansible que instala y configura la solución de soporte al usuario/ticketing basada en la web y de código abierto Zammad.

Nota: Este rol no instala el servidor Elasticsearch ni PostgreSQL. Consulta Dependencias.

Requisitos

Se necesitan los siguientes requisitos en el host de destino:

• cryptography >= 1.6.0

Variables del Rol

zammad_version: "6.2.0"

Versión de Zammad que se instalará.

zammad_release_channel: "stable"

Elige otro canal de lanzamiento para los paquetes de Zammad. Consulta https://packager.io/gh/zammad/zammad para una lista completa.

zammad_domain_name: "{{ ansible_fqdn }}"

Nombre de dominio completamente calificado para Zammad.

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

Ruta del archivo de configuración de Nginx para Zammad.

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

Ruta del certificado SSL/TLS que se utiliza para HTTPS.

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

Ruta de la clave privada SSL/TLS que se utiliza para HTTPS.

zammad_ssl_cert:

Contenido del certificado SSL/TLS (requerido).

zammad_ssl_key:

Contenido de la clave privada SSL/TLS (requerido).
Nota: En el caso especial de que hayas colocado previamente un par de claves SSL en el host, por ejemplo, a través de Let's Encrypt, no debes configurar las variables zammad_ssl_cert y zammad_ssl_key. Sin embargo, en cada caso, el rol verificará si el par de claves SSL especificado en las rutas zammad_ssl_key_path y zammad_ssl_cert_path es válido.

zammad_nginx_server_tokens: "off"

Habilita o deshabilita la emisión de información sobre la versión de Nginx en las páginas de error o en el campo de encabezado de respuesta Server. Por favor, lee la documentación de Nginx para más información.

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;

        # ... configuración SSL

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

Configura directivas adicionales del servidor en la configuración de Nginx. Esto permite implementar ajustes más específicos, por ejemplo, configurando múltiples dominios o redirigiendo dominios obsoletos al más reciente.

elasticsearch_url: "http://localhost:9200"

Dirección del servidor Elasticsearch.

Dependencias

Zammad requiere un servidor de base de datos Elasticsearch y PostgreSQL. Este rol ha sido probado con éxito junto con los siguientes roles:

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

Ejemplo de Playbook

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

Licencia

MIT

Información del Autor

Este rol fue creado en 2020 por HIFIS Software Services.