William-Yeh.fluentd

概述版本洞察

williamyeh.fluentd for Ansible Galaxy

概要

Ansible Galaxy 中的角色名称: williamyeh.fluentd

这个 Ansible 角色为 Fluentd 提供以下功能：

安装 td-agent：由 Treasure Data, Inc 维护的稳定版 Fluentd 分发包。
安装多个插件。
基础配置（实际配置应留给用户的模板文件；见下面的用法部分）。

角色变量

必需变量

无。

可选变量

用户可配置的默认值：

# td-agent 版本；例如，2.3.4
# 如果未指定，将安装默认版本（通常是最新的稳定版）。
tdagent_version

# 需要安装的插件数组（带最新版本）
tdagent_plugins

# 需要安装的插件字典（带指定版本）
# 字典字段：
#   - key: 此插件的备注
#   - value:
#     - name: 插件名称
#     - version: 插件版本
tdagent_plugins_versions

用户可以安装的配置文件 - 主要配置：

# 要安装的配置文件（通常是 td-agent.conf），
# 相对于 `playbook_dir`；
# 文件将逐字复制
tdagent_conf_copy

# 要安装的配置文件（通常是 td-agent.conf.j2），
# 相对于 `playbook_dir`；
# 文件将通过 Ansible 的模板系统复制
tdagent_conf_template

用户可以安装的配置文件 - 其他配置：

# 其他配置模板，将安装到 "/etc/td-agent/conf.d"；
# 字典字段：
#   - key: 此配置的备注
#   - value:
#     - src:  相对于 `playbook_dir` 的模板文件
#     - dest: 相对于 `/etc/td-agent/conf.d/` 的目标文件
tdagent_conf_others

处理程序

reload td-agent
restart td-agent
stop td-agent

用法

第一步：添加角色

将角色名称 williamyeh.fluentd 添加到您的 playbook 文件中。

第二步：添加变量（如有）

在您的 playbook 文件中设置变量。

简单示例：

---
# 文件: simple-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

  vars:
    tdagent_plugins:
      - fluent-plugin-multiprocess
      - fluent-plugin-forest
      - fluent-plugin-elasticsearch

    tdagent_plugins_versions:
      prometheus:
        name: fluent-plugin-prometheus
        version: 0.1.2
      flowcounter:
        name: fluent-plugin-flowcounter
        version: 0.4.1

第三步：如果必要，复制用户的配置文件

更实用的示例：

---
# 文件: complex-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

  vars:
    tdagent_plugins:
      - fluent-plugin-multiprocess
      - fluent-plugin-flowcounter
      - fluent-plugin-elasticsearch

    # 逐字复制
    tdagent_conf_copy: "files/td-agent.conf"

    # 通过 Ansible 的模板系统复制
    tdagent_conf_template: "templates/td-agent.conf.j2"

    # 其他配置通过 Ansible 的模板系统复制
    tdagent_conf_others:
      prometheus_metrics:
        src:  templates/prometheus.conf.j2
        dest: prometheus.conf