ableton.prometheus_node_exporter

Ansible rola ableton.prometheus_node_exporter

Ta rola instaluje Prometheus node_exporter jako usługę na wskazanym hoście. Jeśli system docelowy ma menedżera pakietów z pakietem node_exporter, to rola zainstaluje oprogramowanie w ten sposób. W przeciwnym razie oprogramowanie zostanie zbudowane ze źródeł.

W systemie Windows, ta rola instaluje windows_exporter.

Wymagania

Wymagana jest wersja Ansible >= 2.10. Ta rola wspiera instalację opartą na pakietach na następujących typach systemów operacyjnych:

Debian Linux (przez moduł apt)
macOS (przez moduł homebrew)
Windows (przez moduł win_chocolatey)

Dla wszystkich innych platform zostanie przeprowadzona instalacja oparta na źródłach. Na takich systemach, gdzie instalacja oparta na pakietach jest niedostępna, wymagane jest oprogramowanie:

Go (golang)
GNU Make

Ta rola nie instaluje żadnego z powyższych oprogramowań na hoście; musisz zadbać o to przed zastosowaniem tej roli.

Zmienne roli

Poniższe zmienne roli są używane do konfiguracji usługi node_exporter:

node_exporter_args: Lista argumentów do przekazania do usługi node_exporter, jeden argument na pozycję na liście.
node_exporter_create_user: Kiedy true, tworzy użytkownika node_exporter_user oraz odpowiadającą grupę node_exporter_group (używane tylko na platformach Unix, domyślnie true).
node_exporter_group: Grupa dla użytkownika node_exporter_user (używane tylko na platformach Unix).
node_exporter_port: Port, na którym będą udostępniane metryki.
node_exporter_user: Użytkownik, jako którego będzie uruchamiany node_exporter (używane tylko na platformach Unix).

Poniższe zmienne są używane, gdy node_exporter jest budowany ze źródeł.

node_exporter_install_from_binary: Kiedy true, node_exporter zostanie zainstalowany z pobrania binarnego, a nie za pomocą menedżera pakietów. Ta opcja nie jest wspierana na wszystkich typach systemów (zobacz sekcję "Wymagania" powyżej).
node_exporter_binary_arch: Architektura binarna do pobrania podczas ściągania binarnego node_exporter.
node_exporter_version: Wersja node_exporter, która ma być zainstalowana ze źródeł.

Poniższe zmienne są używane w systemie Windows:

windows_exporter_version: Wersja windows_exporter, która ma być zainstalowana przy użyciu Chocolatey.

Zobacz plik defaults/main.yml dla pełnej dokumentacji na temat wymaganych i opcjonalnych zmiennych roli.

Przykładowy Playbook

---
- name: Zainstaluj node_exporter na hostach
  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: Wymuszenie instalacji z źródeł na hostach macOS, aby można było użyć konkretnej wersji
      set_fact:
        node_exporter_install_from_binary: true
      when: ansible_os_family == "Darwin"

    - name: Zainstaluj wymagane oprogramowanie dla hostów macOS
      homebrew:
        name: golang
        state: present

  roles:
    - ableton.prometheus_node_exporter