ansible-role-zammad

このロールは、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

# Zammadの前にリバースプロキシとしてnginxをインストールします
zammad_install_nginx: true

# 既存のnginxをZammadのリバースプロキシとして設定します
zammad_configure_nginx: false

# Zammad専用にnginxのデフォルトvhostを削除します
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

# MySQLをデータベースドライバーとしてインストールするためにtrueに設定します
zammad_db_mysql: true

# PostgreSQLをデータベースドライバーとしてインストールするためにtrueに設定します
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

クラウド使用の提案

例えば、Zammadだけを実行するAMIをプロビジョニングしたい場合は、設定を行わずにセットアップする必要があります：

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

特別なケースは、最初の実行時にデータベースがまだない場合です。 次の2つのオプションがあります： データベースを手動で作成し、zammad_db_seedをtrueに設定してansibleを1回実行するか、zammad_db_createをtrueに設定して、zammad_db_seedもtrueに設定してansibleを1回実行します。 （ただし、データベースを作成する権限のあるユーザーを提供する必要があります！）

依存関係

特にありません。

例のプレイブック

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

ライセンス

MIT

著者情報

solutionDrive GmbHによって作成されました。 https://solutionDrive.de/