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

使用法

ステップ1：ロールを追加

ロール名williamyeh.fluentdをプレイブックファイルに追加します。

ステップ2：変数を追加、もしあれば

プレイブックファイルに変数を設定します。

簡単な例：

---
# ファイル: 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

ステップ3：ユーザーの設定ファイルをコピー、必要な場合

さらに実用的な例：

---
# ファイル: 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