ableton.prometheus_node_exporter

Ansible-Rolle ableton.prometheus_node_exporter

Diese Rolle installiert den Prometheus node_exporter als Dienst auf dem angegebenen Host. Wenn das Zielsystem einen Paketmanager mit dem node_exporter-Paket hat, wird die Software auf diese Weise installiert. Andernfalls wird die Software aus den Quellen erstellt.

Auf Windows installiert diese Rolle den windows_exporter.

Anforderungen

Ansible >= 2.10 ist erforderlich. Diese Rolle unterstützt die Installation über Pakete auf den folgenden Betriebssystemen:

Debian Linux (über das apt-Modul)
macOS (über das homebrew-Modul)
Windows (über das win_chocolatey-Modul)

Für alle anderen Plattformen erfolgt eine Installation aus den Quellen. Auf solchen Systemen, auf denen eine paketbasierte Installation nicht verfügbar ist, sind die folgenden Softwarekomponenten erforderlich:

Go (golang)
GNU Make

Diese Rolle installiert keine der oben genannten Software auf dem Host; du musst das selbst erledigen, bevor du diese Rolle anwendest.

Rollenvariablen

Die folgenden Rollenvariablen werden für die Dienstkonfiguration des node_exporter verwendet:

node_exporter_args: Eine Liste von Argumenten, die an den node_exporter-Dienst übergeben werden, jeweils ein Argument pro Listeneintrag.
node_exporter_create_user: Wenn true, erstelle den Nutzer node_exporter_user und die entsprechende Gruppe node_exporter_group (wird nur auf Unix-Plattformen verwendet, Standardwert ist true).
node_exporter_group: Gruppe für den Nutzer node_exporter_user (wird nur auf Unix-Plattformen verwendet).
node_exporter_port: Port zum Exponieren von Metriken.
node_exporter_user: Nutzer, unter dem node_exporter ausgeführt werden soll (wird nur auf Unix-Plattformen verwendet).

Die folgenden Variablen werden beim Erstellen des node_exporter aus Quellen verwendet:

node_exporter_install_from_binary: Wenn true, wird node_exporter aus einem binären Download installiert und nicht über einen Paketmanager. Diese Option wird nicht auf allen Systemtypen unterstützt (siehe den Abschnitt "Anforderungen" oben).
node_exporter_binary_arch: Binärarchitektur, die beim Herunterladen der node_exporter-Binärdatei abgerufen werden soll.
node_exporter_version: Version des node_exporter, die aus der Quelle installiert werden soll.

Die folgenden Variablen werden unter Windows verwendet:

windows_exporter_version: Version des windows_exporter, die mit Chocolatey installiert werden soll.

Siehe die Datei defaults/main.yml für die vollständige Dokumentation zu den erforderlichen und optionalen Rollenvariablen.

Beispiel-Playbook

---
- name: Installiere node_exporter auf Hosts
  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: Zwinge macOS-Hosts, aus den Quellen zu installieren, um eine spezifische Version verwenden zu können
      set_fact:
        node_exporter_install_from_binary: true
      when: ansible_os_family == "Darwin"

    - name: Installiere erforderliche Software für macOS-Hosts
      homebrew:
        name: golang
        state: present

  roles:
    - ableton.prometheus_node_exporter