mkayontour.influxdb

[![ビルドステータス](https://img.shields.io/github/workflow/status/mkayontour/ansible-influxdb/CI)](https://github.com/mkayontour/ansible-influxdb/actions/workflows/molecule.yml)
[![Ansible品質スコア](https://img.shields.io/ansible/quality/50067?label=role%20quality)](https://galaxy.ansible.com/mkayontour/influxdb)

Ansible InfluxDB
=========

このロールは、InfluxDBをインストール、管理、設定します。データベースやユーザーを含みます。主要なディストリビューションはサポートされているはずです。
プルリクエストや問題の報告は大歓迎です :)

要件
------------

最初に必要なのは、**influxdb Pythonクライアント**がインストールされていることです。このロールはそれを管理します。

次に、**pipが必要です**。これはinfluxdb Pythonクライアントのインストールに必要です。

ロール変数
--------------

### デフォルト

デフォルトの変数は以下にリストされています。**influxdb.conf**の各設定セクションには自身の変数があります。

デフォルトのパスワードをもっと安全なものに変更してください：

influxdb_admin_username: admin influxdb_admin_password: admin

influxdb_manage_repository: yes influxdb_manage_package: yes influxdb_config_dir: /etc/influxdb influxdb_config_global: reporting-disabled: false bind-address: 127.0.0.1:8086 influxdb_config_graphite:

• enabled: false tags:
  • region=us
  • zone=test influxdb_config_collectd:
• enabled: false influxdb_config_udp:
• enabled: false influxdb_config_meta: dir: /var/lib/influxdb/meta retention-autocreate: true logging-enabled: true influxdb_config_http: enabled: true bind-address: :8086 auth-enabled: true ping-auth-enabled: true influxdb_config_data: dir: /var/lib/influxdb/data wal-dir: /var/lib/influxdb/wal series-id-set-cache-size: 100 influxdb_admin_username: admin influxdb_admin_password: admin

各設定セクションのパラメータについてはドキュメントで確認してください：

`influxdb_config_global` [グローバル](https://docs.influxdata.com/influxdb/v1.8/administration/config/#global-settings)

`influxdb_config_meta` [メタデータ](https://docs.influxdata.com/influxdb/v1.8/administration/config/#meta)

`influxdb_config_data` [データ](https://docs.influxdata.com/influxdb/v1.8/administration/config/#data)

`influxdb_config_http` [HTTP](https://docs.influxdata.com/influxdb/v1.8/administration/config/#http)

`influxdb_config_subscriber` [サブスクライバ](https://docs.influxdata.com/influxdb/v1.8/administration/config/#subscriber)

`influxdb_config_graphite` [グラファイト](https://docs.influxdata.com/influxdb/v1.8/administration/config/#graphite)

`influxdb_config_monitor` [モニター](https://docs.influxdata.com/influxdb/v1.8/administration/config/#monitor)

`influxdb_config_shard_precreation` [シャード事前作成](https://docs.influxdata.com/influxdb/v1.8/administration/config/#shard-precreation)

`influxdb_config_collectd` [Collectd](https://docs.influxdata.com/influxdb/v1.8/administration/config/#collectd)

`influxdb_config_continuous_queries`

`influxdb_config_tls`

`influxdb_config_retention`

`influxdb_config_udp`

複数回定義できるすべてのセクションは配列として定義されます。

次の例：

influxdb_config_graphite:

• enabled: true database: graphite tags:
  • region=us
  • zone=test
  • instance=01
• enabled: true database: graphite2 tags:
  • region=de
  • zone=prod
  • instance=02

### データベースの定義

データベースを定義するには、以下の構文を使って複数を作成します：

influxdb_databases:

• name: telegraf-metrics state: present
• name: graphite state: present
• name: icinga state: present

データベースのすべてのパラメータは以下にリストされています：

influxdb_databases:

• name: login_password: login_username: hostname: port: proxies: retries: state: ssl: timeout: udp_port: use_udp: validate_certs:

### ユーザーの定義

ユーザーを定義するには、以下の構文を使って複数を作成します：

influxdb_users:

• name: influxadm password: influxdbadmpass admin: yes
• name: icinga admin: no password: icinga grants:
  • database: 'icinga' privilege: 'WRITE'

ユーザーのすべてのパラメータは以下にリストされています：

influxdb_users:

• name: foo admin: true/false state: present/absent password: 'password' port: 8086 hostname: localhost login_username: admin login_password: admin ssl: true/false

例としてのプレイブック
----------------

ロールの使い方（例えば、変数をパラメータとして渡す）の例は、ユーザーにとって便利です：

    - hosts: influxdb-node1
      vars:
        influxdb_admin_username: admin
        influxdb_admin_password: admin123
        influxdb_databases:
          - name: telegraf-metrics
            state: present
        influxdb_users:
          - name: telegraf
            password: telegraf
            grants:
              - database: telegraf-metrics
                privilege: "WRITE"
      roles:
         - { role: mkayontour.influxdb }

ライセンス
-------

Apache-2.0

著者情報
------------------

Twitter: @mkayontour