Ansibleロール: Zammad

:warning: このプロジェクトはアーカイブされています！ :warning:

このロールは、私たちの hifis.toolkit コレクションに移行されました：

• https://github.com/hifis-net/ansible-collection-toolkit
• https://galaxy.ansible.com/ui/repo/published/hifis/toolkit/

このAnsibleロールは、ウェブベースのオープンソースユーザーサポート/チケットシステムZammadをインストールおよび構成します。

注意: このロールは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"

エラーページや_Server_レスポンスヘッダーフィールドに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ソフトウェアサービスによって作成されました。