ansible-role-zammad

Ce rôle installe et/ou configure Zammad, connu sur https://zammad.org.

Exigences

Pour faire fonctionner Zammad, vous devez répondre aux exigences de https://docs.zammad.org/en/latest/prerequisites-software.html.

Veuillez noter qu'il est fortement recommandé de ne pas exécuter le serveur de base de données sur la même machine que Zammad lui-même.

Vous devez d'abord installer Ruby, Bundler, Rake et Rails. Utilisez par exemple geerlingguy.ruby mais choisissez de construire Ruby à partir des sources, car les paquets du gestionnaire peuvent être obsolètes.

Variables du rôle

# Installer les prérequis via apt (déverrouillez et faites-le manuellement pour utiliser un autre gestionnaire de paquets)
zammad_install_prerequisites: true

# Installer Zammad lui-même (à partir des sources)
zammad_install: true

# Configurer une installation Zammad existante (la configuration peut être effectuée en réglant ```zammad_install``` sur true)
zammad_configure: false

# Installer nginx comme reverse proxy devant Zammad
zammad_install_nginx: true

# Configurer nginx existant comme reverse proxy pour l'installation de Zammad
zammad_configure_nginx: false

# Supprimer le vhost par défaut de nginx pour activer uniquement Zammad
zammad_remove_nginx_default_vhost: false

# Mettre à true pour créer la base de données
zammad_db_create: false

# Mettre à true pour exécuter les migrations de la base de données (vous DEVEZ le faire si zammad_db_create est réglé sur true)
zammad_db_migrate: false

# Mettre à true pour peupler la base de données avec des valeurs initiales (NE PAS FAIRE CELA SUR UNE BASE DE DONNÉES EXISTANTE !)
zammad_db_seed: false

# Mettre à true pour installer avec MySQL comme pilote de base de données
zammad_db_mysql: true

# Mettre à true pour installer avec PostgreSQL comme pilote de base de données
zammad_db_postgresql: false

Ne réglez pas les deux zammad_db_mysql et zammad_db_postgresql sur true !

# Les paramètres de la base de données devraient être explicites    
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad

# Le nom d'utilisateur sous lequel Zammad doit être installé
zammad_user: zammad

# Le groupe sous lequel Zammad doit être installé
zammad_group: zammad

# Mettre à true pour créer automatiquement l'utilisateur et le groupe s'ils n'existent pas encore
zammad_user_group_create: true

# Activer ou désactiver l'installation des services systemd
zammad_install_systemd_service: true

# Mettre à true pour précompiler les actifs statiques (la base de données doit être configurée et fonctionnelle avant)
zammad_precompile_assets: false

Suggestion d'utilisation cloud

Si vous souhaitez provisionner, par exemple, une AMI qui exécute uniquement Zammad, vous devez le configurer sans le configurer :

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 ou false
zammad_db_postgresql: false ou true
zammad_user: zammad
zammad_group: zammad
zammad_user_group_create: true
zammad_install_systemd_service: true
zammad_precompile_assets: false

Dans votre configuration de lancement, vous devez ensuite le configurer :

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 cas spécial est le tout premier fonctionnement, si vous n'avez pas encore de base de données. Vous avez deux options : Soit créer la base de données manuellement et exécuter ansible une fois avec zammad_db_seed réglé sur true, soit exécuter ansible une fois avec zammad_db_create réglé sur true et zammad_db_seed réglé sur true. (Mais dans ce cas, vous devez fournir un utilisateur qui est autorisé à créer une base de données !)

Dépendances

Aucune jusqu'à présent.

Exemple de Playbook

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

Licence

MIT

Informations sur l'auteur

Créé par solutionDrive GmbH. https://solutionDrive.de/