ansible-role-zammad

Эта роль устанавливает и/или настраивает Zammad, известный с https://zammad.org.

Требования

Чтобы запустить zammad, необходимо выполнить требования с https://docs.zammad.org/en/latest/prerequisites-software.html.

Обратите внимание, что настоятельно рекомендуется не запускать сервер базы данных на том же компьютере, что и zammad.

Вам нужно установить ruby, bundler, rake и rails заранее. Используйте, например, geerlingguy.ruby, но выберите компиляцию ruby из исходников, так как пакеты менеджеров могут быть устаревшими.

Переменные роли

# Установить зависимости через apt (отключите и сделайте это вручную, чтобы использовать другой менеджер пакетов)
zammad_install_prerequisites: true

# Установить сам zammad (из исходников)
zammad_install: true

# Настроить существующую установку zammad (настройку можно провести, установив ```zammad_install``` в true)
zammad_configure: false

# Установить nginx как обратный прокси для zammad
zammad_install_nginx: true

# Настроить существующий nginx как обратный прокси для установки zammad
zammad_configure_nginx: false

# Удалить стандартный виртуальный хост nginx, чтобы оставить только zammad
zammad_remove_nginx_default_vhost: false

# Установить в true для создания базы данных
zammad_db_create: false

# Установить в true для выполнения миграций базы данных (это необходимо, если zammad_db_create установлено в true)
zammad_db_migrate: false

# Установить в true для наполнения базы данных начальными значениями (НЕ ДЕЛАЙТЕ ЭТО НА СУЩЕСТВУЮЩЕЙ БАЗЕ ДАННЫХ!)
zammad_db_seed: false

# Установить в true, чтобы установить MySQL в качестве драйвера базы данных
zammad_db_mysql: true

# Установить в true, чтобы установить PostgreSQL в качестве драйвера базы данных
zammad_db_postgresql: false

Не устанавливайте одновременно zammad_db_mysql и zammad_db_postgresql в true!

# Параметры базы данных должны быть самопоясняющимися    
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad

# Имя пользователя, под которым должен быть установлен zammad
zammad_user: zammad

# Группа, под которой должен быть установлен zammad
zammad_group: zammad

# Установить в true для автоматического создания пользователя и группы, если они еще не существуют
zammad_user_group_create: true

# Включить или отключить установку сервисов systemd
zammad_install_systemd_service: true

# Установить в true для предварительной компиляции статических ресурсов (база данных должна быть настроена и работать заранее)
zammad_precompile_assets: false

Предложения по использованию в облаке

Если вы хотите создать, например, AMI, который просто запускает zammad, вам следует настроить, но не конфигурировать его:

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

В вашей конфигурации запуска вы должны настроить его:

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

Особый случай — самый первый запуск, если у вас еще нет базы данных. У вас есть два варианта: Либо создайте базу данных вручную и запустите ansible один раз с zammad_db_seed установленным в true, либо запустите ansible один раз с zammad_db_create и zammad_db_seed установленными в true. (Но тогда вам нужно предоставить пользователя, которому разрешено создавать базу данных!)

Зависимости

На данный момент отсутствуют.

Пример плейбука

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

Лицензия

MIT

Информация об авторе

Создано компанией solutionDrive GmbH. https://solutionDrive.de/