ansible-role-zammad

Este rol instala y/o configura Zammad, conocido desde https://zammad.org.

Requisitos

Para ejecutar Zammad, debes cumplir con los requisitos de https://docs.zammad.org/en/latest/prerequisites-software.html.

Por favor, ten en cuenta que se recomienda encarecidamente no ejecutar el servidor de base de datos en la misma máquina que Zammad.

Debes instalar ruby, bundler, rake y rails primero. Usa, por ejemplo, geerlingguy.ruby, pero elige construir ruby desde la fuente, ya que el paquete del administrador de paquetes puede estar desactualizado.

Variables del Rol

# Instalar requisitos previos a través de apt (desactiva esto y hazlo manualmente si usas otro administrador de paquetes)
zammad_install_prerequisites: true

# Instalar zammad (desde la fuente)
zammad_install: true

# Configurar una instalación existente de zammad (la configuración se puede hacer configurando ```zammad_install``` a true)
zammad_configure: false

# Instalar nginx como proxy inverso para Zammad
zammad_install_nginx: true

# Configurar nginx existente como proxy inverso para la instalación de zammad
zammad_configure_nginx: false

# Eliminar el vhost por defecto de nginx para habilitar solo zammad
zammad_remove_nginx_default_vhost: false

# Establecer en true para crear la base de datos
zammad_db_create: false

# Establecer en true para ejecutar migraciones de la base de datos (DEBES hacer esto si zammad_db_create está configurado a true)
zammad_db_migrate: false

# Establecer en true para poblar la base de datos con valores iniciales (¡NO HAGAS ESTO EN UNA BASE DE DATOS EXISTENTE!)
zammad_db_seed: false

# Establecer en true para instalar con MySQL como controlador de base de datos
zammad_db_mysql: true

# Establecer en true para instalar con PostgreSQL como controlador de base de datos
zammad_db_postgresql: false

¡No establezcas ambas zammad_db_mysql y zammad_db_postgresql en true!

# Los parámetros de la base de datos deberían ser autoexplicativos    
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad

# El nombre de usuario bajo el cual se debe instalar zammad
zammad_user: zammad

# El grupo bajo el cual se debe instalar zammad
zammad_group: zammad

# Establecer en true para crear automáticamente el usuario y el grupo si no existen
zammad_user_group_create: true

# Habilitar o deshabilitar la instalación de servicios systemd
zammad_install_systemd_service: true

# Establecer en true para precompilar activos estáticos (la base de datos debe estar configurada y funcionando antes)
zammad_precompile_assets: false

Sugerencia de Uso en la Nube

Si quieres aprovisionar, por ejemplo, una AMI que solo ejecute Zammad, deberías configurarla pero no configurarla:

zammad_install_prerequisites: true
zammad_install: true
zammad_configure: false
zammad_install_nginx: true
zammad_configure_nginx: false
zammad_remove_nginx_default_vhost: false
zammad_db_create: false
zammad_db_migrate: false
zammad_db_seed: false
zammad_db_mysql: true o false
zammad_db_postgresql: false o true
zammad_user: zammad
zammad_group: zammad
zammad_user_group_create: true
zammad_install_systemd_service: true
zammad_precompile_assets: false

En tu configuración de lanzamiento, entonces debes configurarlo:

zammad_install_prerequisites: false
zammad_install: false
zammad_configure: true
zammad_install_nginx: false
zammad_configure_nginx: true
zammad_remove_nginx_default_vhost: true
zammad_db_create: false
zammad_db_migrate: true
zammad_db_seed: false
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad
zammad_user: zammad
zammad_group: zammad
zammad_user_group_create: false
zammad_install_systemd_service: false
zammad_precompile_assets: true

Un caso especial es la primera ejecución, si aún no tienes una base de datos. Tienes dos opciones: Puedes crear la base de datos manualmente y ejecutar ansible una vez con zammad_db_seed configurado a true, o ejecutar ansible una vez con zammad_db_create configurado a true y zammad_db_seed configurado a true. (Pero entonces necesitas proporcionar un usuario que esté permitido para crear una base de datos).

Dependencias

Ninguna hasta ahora.

Ejemplo de Playbook

- hosts: servidores
  roles:
     - { role: solutiondrive.ansible-role-zammad }

Licencia

MIT

Información del Autor

Creado por solutionDrive GmbH. https://solutionDrive.de/