ansible-role-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

    # 安装 nginx 作为 Zammad 前的反向代理
    zammad_install_nginx: true

    # 配置现有的 nginx 作为 Zammad 安装的反向代理
    zammad_configure_nginx: false
    
    # 移除 nginx 的默认虚拟主机，只启用 Zammad
    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

    # 设置为 true 使用 MySQL 作为数据库驱动
    zammad_db_mysql: true

    # 设置为 true 使用 PostgreSQL 作为数据库驱动
    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，应该进行设置但不配置它：

```yaml
    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

一个特殊情况是第一次运行，如果您还没有数据库。您有两个选择： 要么手动创建数据库，然后将 zammad_db_seed 设置为 true 并运行 ansible 一次， 要么将 zammad_db_create 和 zammad_db_seed 都设置为 true，然后运行 ansible 一次。 （但之后您需要提供一个允许创建数据库的用户！）

依赖

目前没有依赖。

示例剧本

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

许可证

MIT

作者信息

由 solutionDrive GmbH 创建。 https://solutionDrive.de/