ableton.prometheus_node_exporter

Rôle Ansible ableton.prometheus_node_exporter

Ce rôle installe le Prometheus node_exporter en tant que service sur l'hôte donné. Si le système cible dispose d'un gestionnaire de paquets avec le paquet node_exporter, alors ce rôle installe le logiciel de cette manière. Sinon, le logiciel sera construit à partir des sources.

Sur Windows, ce rôle installe windows_exporter.

Exigences

Ansible >= 2.10 est requis. Ce rôle prend en charge l'installation basée sur des paquets sur les types de systèmes d'exploitation suivants :

Debian Linux (via le module apt)
macOS (via le module homebrew)
Windows (via le module win_chocolatey)

Pour toutes les autres plateformes, une installation à partir des sources sera effectuée. Sur ces systèmes où l'installation basée sur des paquets n'est pas disponible, le logiciel suivant est requis :

Go (golang)
GNU Make

Ce rôle ne doit pas installer l'un ou l'autre des logiciels ci-dessus sur l'hôte ; vous devez vous en occuper avant d'appliquer ce rôle.

Variables de rôle

Les variables de rôle suivantes sont utilisées pour la configuration du service node_exporter :

node_exporter_args : Une liste d'arguments à passer au service node_exporter, un argument par élément de la liste.
node_exporter_create_user : Lorsque true, crée l'utilisateur node_exporter_user et le groupe correspondant node_exporter_group (utilisé uniquement sur les plateformes Unix, par défaut true).
node_exporter_group : Groupe pour l'utilisateur node_exporter_user (utilisé uniquement sur les plateformes Unix).
node_exporter_port : Port pour exposer les métriques.
node_exporter_user : Utilisateur sous lequel exécuter node_exporter (utilisé uniquement sur les plateformes Unix).

Les variables suivantes sont utilisées lors de la construction de node_exporter à partir des sources.

node_exporter_install_from_binary : Lorsque true, node_exporter sera installé à partir d'un téléchargement binaire et non via un gestionnaire de paquets. Cette option n'est pas prise en charge sur tous les types de systèmes (voir la section "Exigences" ci-dessus).
node_exporter_binary_arch : Architecture binaire à récupérer lors du téléchargement du binaire node_exporter.
node_exporter_version : Version de node_exporter à installer à partir des sources.

Les variables suivantes sont utilisées sous Windows :

windows_exporter_version : Version du windows_exporter à installer en utilisant Chocolatey.

Consultez le fichier defaults/main.yml pour la documentation complète sur les variables de rôle requises et optionnelles.

Exemple de Playbook

---
- name: Installer node_exporter sur les hôtes
  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: Forcer les hôtes macOS à installer à partir des sources, afin d'utiliser une version spécifique
      set_fact:
        node_exporter_install_from_binary: true
      when: ansible_os_family == "Darwin"

    - name: Installer les logiciels prérequis pour les hôtes macOS
      homebrew:
        name: golang
        state: present

  roles:
    - ableton.prometheus_node_exporter