Ansible ロール: Zammad

これは、ウェブベースのオープンソースユーザーサポート/チケッティングソリューション Zammad をインストールおよび設定するためのAnsibleロールです。

注意: このロールはelasticsearchとpostgresqlサーバーをインストールしません。詳細は依存関係を参照してください。

要件

ターゲットホストには以下の要件が必要です：

• cryptography >= 1.6.0

ロール変数

zammad_version: "6.2.0"

インストールするZammadのバージョンです。

zammad_release_channel: "stable"

Zammadパッケージの別のリリースチャンネルを選択します。完全なリストは https://packager.io/gh/zammad/zammad を参照してください。

zammad_domain_name: "{{ ansible_fqdn }}"

Zammadの完全修飾ドメイン名です。

zammad_nginx_config_path: "/etc/nginx/sites-available/zammad.conf"

ZammadのNginx設定のファイルパスです。

zammad_ssl_cert_path: "/etc/ssl/certs/zammad_cert.pem"

HTTPSで使用されるSSL/TLS証明書のファイルパスです。

zammad_ssl_key_path: "/etc/ssl/private/zammad_key.pem"

HTTPSで使用されるSSL/TLSプライベートキーのファイルパスです。

zammad_ssl_cert:

SSL/TLS証明書の内容（必須）。

zammad_ssl_key:

SSL/TLSプライベートキーの内容（必須）。
ご注意: 以前にホストにSSLキーサーバーを設定した場合（例えばLet's Encryptを使用して）、zammad_ssl_certとzammad_ssl_keyの変数を設定する必要はありません。ただし、ロールは常にzammad_ssl_key_pathとzammad_ssl_cert_pathで指定されたSSLキーのペアが有効であるかを検証します。

zammad_nginx_server_tokens: "off"

エラーページや_Serber_のレスポンスヘッダーフィールドにNginxバージョン情報を表示するかどうかを設定します。詳細は、nginxのドキュメントを参照してください。

zammad_nginx_additional_server_configs:
  - |
      server {
        listen 80;
        server_name zammad.example.com zammad-old.example.com;
        return 301 https://zammad.example.com$request_uri;
      }
  - |
      server {
        listen 443 ssl;

        # ... SSL設定

        server_name zammad-old.example.com;
        return 301 https://zammad.example.com$request_uri;
      }

Nginx設定で追加のサーバ指示を構成します。これにより、複数のドメインの構成や古いドメインから最新のものへのリダイレクトなど、特定のユースケースに応じた調整を行うことができます。

elasticsearch_url: "http://localhost:9200"

Elasticsearchサーバーのアドレスです。

依存関係

ZammadはElasticsearchとPostgreSQLデータベースサーバーを必要とします。このロールは、以下のロールと共に正常にテストされています：

• Elasticsearch - geerlingguy.elasticsearch
• PostgreSQL - geerlingguy.postgresql

例プレイブック

    - hosts: servers
      roles:
         - role: hifis.zammad
           become: yes

ライセンス

MIT

作者情報

このロールは2020年にHIFIS Software Servicesによって作成されました。