Ansible InfluxDBサーバーロール

これは、完全なTICKスタックサーバーをセットアップするロールです（Telegrafのインストールは含まれていません）。InfluxDB、ChronografおよびKapacitorの完全なセットアップをインストールします。

このロールは、Telegrafエージェントからメトリクスを受信し、それをInfluxDBに格納してChronografとKapacitorでモニタリングやアラートを行うためのサーバーを想定しています。ChronografはGithub OAuthで設定されており、公開アクセスから保護されます。

Telegrafもインストールしたい場合は、監視したいすべてのマシンで使用できる別のロールmediafellows.telegrafがあります。

要件

OSはUbuntu 16.04以上が必要です。他のディストリビューションでも動作する可能性がありますが、python-influxdbパッケージがaptリポジトリで利用可能である必要があります。このパッケージは、AnsibleのInfluxDBモジュールが動作するために必要です。

Ansibleのバージョンが2.6未満の場合、InfluxDBモジュールをAnsibleプロジェクトのライブラリディレクトリ（通常は./library/）に追加する必要があるかもしれません。モジュールは、https://github.com/ansible/ansible/tree/devel/lib/ansible/modules/database/influxdb で見つけることができます。

また、Chronografを外部に公開するためにポート8888を開放するか、設定を変更した場合は別のポートを開放する必要があります。

ロール変数

変更すべきロール変数：

• chronograf_public_url: https://some-url.com - Chronografセットアップの公開URL
• influxdb_admin_pw: secret_pw - InfluxDB管理者ユーザー用のパスワード
• influxdb_chronograf_pw: secret_pw - InfluxDB Chronografユーザー用のパスワード（データの読み取り用）
• influxdb_telegraf_pw: secret_pw - InfluxDB Telegrafユーザー用のパスワード（データの取り込み用）
• influxdb_chronograf_oauth_secret: abc123def - 暗号化のためのランダムな文字列
• influxdb_chronograf_oauth_github_id: abc123 - Githubでアプリを作成した後に提供されたOAuthアプリID
• influxdb_chronograf_oauth_github_secret: abc123 - Githubによって提供されたOAuthアプリの秘密
• influxdb_chronograf_oauth_github_org: myorg - 自分のGithub組織に制限、OAuthアプリがこの組織に所属することを確認してください。

その他のパラメータも変更可能です。詳細はdefaults/main.ymlを参照してください。

既存のDBバックアップから状態を復元するための便利な変数：

• influxdb_meta_backup: /some/path/to/influxdb_backup/meta.00 - Local InfluxDBメタDBバックアップファイルのパス。InfluxDBインスタンスにコピーされて復元されます。他のDBセットアップ（ユーザー、テーブルなど）を置き換えます。
• influxdb_chronograf_db_backup: /some/path/chronograf-v1.db - Local Chronograf設定DBファイルへのパス。通常はInfluxのソースやChronografの認証ユーザーなどの設定を含みます。
• influxdb_kapacitor_db_backup: /some/path/kapacitor.db - Local Kapacitor設定DBファイルへのパス。通常はアラート設定/TICKスクリプトなどを含みます。

依存関係

他のロールに依存しません。

例プレイブック

ロールの統合例：

- hosts: servers
  become: true
  vars:
    influxdb_port: 123
  roles:
    - mediafellows.influxdb
  tasks:
    # 他のタスク

ライセンス

BSD、現状のままで提供。

作者情報

Stefan Horning stefan.horning@mediafellows.com