ableton.prometheus_node_exporter

Ansibleロール ableton.prometheus_node_exporter

このロールは、指定されたホストにPrometheus node_exporterをサービスとしてインストールします。ターゲットシステムにnode_exporterパッケージを持つパッケージマネージャーがある場合、このロールはその方法でソフトウェアをインストールします。それ以外の場合、ソフトウェアはソースからビルドされます。

Windowsの場合、このロールはwindows_exporterをインストールします。

要件

Ansible >= 2.10が必要です。このロールは次のOSタイプでのパッケージベースのインストールをサポートしています：

Debian Linux（aptモジュール経由）
macOS（homebrewモジュール経由）
Windows（win_chocolateyモジュール経由）

他のプラットフォームでは、ソースベースのインストールが実行されます。パッケージベースのインストールが利用できないシステムでは、次のソフトウェアが必要です：

Go（golang）
GNU Make

このロールはホストに上記のソフトウェアをインストールしません。適用する前にこれらを準備してください。

ロール変数

次のロール変数はnode_exporterのサービス設定に使用されます：

node_exporter_args: node_exporterサービスに渡す引数のリスト、一つの引数がリストの各項目として含まれます。
node_exporter_create_user: trueの場合、node_exporter_userユーザーと対応するnode_exporter_groupを作成します（Unixプラットフォームのみで使用、デフォルトはtrue）。
node_exporter_group: node_exporter_userユーザーのグループ（Unixプラットフォームのみで使用）。
node_exporter_port: メトリクスを公開するポート。
node_exporter_user: node_exporterを実行するユーザー（Unixプラットフォームのみで使用）。

次の変数はソースからnode_exporterをビルドする際に使用されます。

node_exporter_install_from_binary: trueの場合、node_exporterはバイナリのダウンロードからインストールされ、パッケージマネージャーを通じてはインストールされません。このオプションはすべてのシステムタイプでサポートされているわけではありません（上記の「要件」セクションを参照）。
node_exporter_binary_arch: node_exporterバイナリのダウンロード時に取得するバイナリアーキテクチャ。
node_exporter_version: ソースからインストールするnode_exporterのバージョン。

Windowsで使用される変数：

windows_exporter_version: Chocolateyを使用してインストールするwindows_exporterのバージョン。

必要なロール変数とオプションの詳細はdefaults/main.ymlファイルを参照してください。

例プレイブック

---
- name: ホストにnode_exporterをインストール
  hosts: "all"
  vars:
    node_exporter_port: 9100
    node_exporter_binary_arch: "amd64"
    node_exporter_group: "{{ ansible_user }}"
    node_exporter_user: "{{ ansible_user }}"
    node_exporter_version: "0.18.1"

  pre_tasks:
    - name: macOSホストに特定のバージョンを使用するためにソースからインストールさせる
      set_fact:
        node_exporter_install_from_binary: true
      when: ansible_os_family == "Darwin"

    - name: macOSホストのための必須ソフトウェアをインストール
      homebrew:
        name: golang
        state: present

  roles:
    - ableton.prometheus_node_exporter