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](https://zammad.org/）。

注意： 此角色不安装 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

作者信息

此角色由 HIFIS 软件服务 在 2020 年创建。