ansible-role-zammad

Ta rola instaluje i/lub konfiguruje Zammad, znany z https://zammad.org.

Wymagania

Aby uruchomić Zammad, musisz spełnić wymagania z https://docs.zammad.org/en/latest/prerequisites-software.html.

Zaleca się, aby nie uruchamiać serwera bazy danych na tej samej maszynie, co sam Zammad.

Musisz wcześniej zainstalować ruby, bundler, rake i rails. Możesz użyć np. geerlingguy.ruby, ale wybierz budowanie ruby ze źródła, ponieważ pakiet menedżera może być przestarzały.

Zmienne roli

# Instalowanie wymaganych programów przez apt (wyłącz to i zrób ręcznie, aby użyć innego menedżera pakietów)
zammad_install_prerequisites: true

# Instalowanie samego Zammadu (ze źródła)
zammad_install: true

# Konfigurowanie istniejącej instalacji Zammadu (możesz to zrobić ustawiając ```zammad_install``` na true)
zammad_configure: false

# Instalowanie nginx jako odwrotnego proxy przed Zammadem
zammad_install_nginx: true

# Konfigurowanie istniejącego nginx jako odwrotnego proxy dla instalacji Zammadu
zammad_configure_nginx: false

# Usuwanie domyślnego vhosta nginx, aby włączyć tylko Zammada
zammad_remove_nginx_default_vhost: false

# Ustaw na true, aby utworzyć bazę danych
zammad_db_create: false

# Ustaw na true, aby uruchomić migracje bazy danych (MUSISZ to zrobić, jeśli zammad_db_create jest ustawione na true)
zammad_db_migrate: false

# Ustaw na true, aby załadować początkowe wartości do bazy danych (NIE RÓB TEGO NA ISTNIEJĄCEJ BAZIE DANYCH!)
zammad_db_seed: false

# Ustaw na true, aby zainstalować z MySQL jako sterownikiem bazy danych
zammad_db_mysql: true

# Ustaw na true, aby zainstalować z PostgreSQL jako sterownikiem bazy danych
zammad_db_postgresql: false

Nie ustawiaj obu zammad_db_mysql i zammad_db_postgresql na true!

# Parametry bazy danych powinny być zrozumiałe    
zammad_db_host: 127.0.0.1
zammad_db_port: 3306
zammad_db_username: zammad
zammad_db_password: ~
zammad_db_name: zammad

# Nazwa użytkownika, pod którą Zammad powinien być zainstalowany
zammad_user: zammad

# Grupa, pod którą Zammad powinien być zainstalowany
zammad_group: zammad

# Ustaw na true, aby automatycznie tworzyć użytkownika i grupę, jeśli jeszcze nie istnieją
zammad_user_group_create: true

# Włącz lub wyłącz instalację usług systemd
zammad_install_systemd_service: true

# Ustaw na true, aby wstępnie skompilować statyczne zasoby (baza danych musi być skonfigurowana i działająca wcześniej)
zammad_precompile_assets: false

Sugestie dotyczące użycia w chmurze

Jeśli chcesz przygotować na przykład AMI, który tylko uruchamia Zammada, powinieneś go skonfigurować, ale nie konfigurować:

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

W swojej konfiguracji uruchamiania powinieneś potem skonfigurować to:

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

Specjalny przypadek to pierwszy uruchomienie, jeśli nie masz jeszcze bazy danych. Masz dwie opcje: Możesz albo stworzyć bazę danych ręcznie i po prostu uruchomić ansible raz z zammad_db_seed ustawionym na true, albo uruchomić ansible raz z zammad_db_create ustawionym na true i zammad_db_seed ustawionym na true. (Ale wtedy musisz podać użytkownika, który ma prawo do tworzenia bazy danych!)

Zależności

Jak na razie brak.

Przykładowy Playbook

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

Licencja

MIT

Informacje o autorze

Stworzono przez solutionDrive GmbH. https://solutionDrive.de/