ableton.prometheus_node_exporter

Descripción general Versiones Perspectivas

Ansible rol ableton.prometheus_node_exporter

Este rol instala Prometheus node_exporter como un servicio en el host indicado. Si el sistema objetivo tiene un gestor de paquetes con el paquete node_exporter, este rol instalará el software de esa manera. De lo contrario, el software se compilará desde las fuentes.

En Windows, este rol instala windows_exporter.

Requisitos

Se requiere Ansible >= 2.10. Este rol soporta la instalación basada en paquetes en los siguientes tipos de sistemas operativos:

Debian Linux (a través del módulo apt)
macOS (a través del módulo homebrew)
Windows (a través del módulo win_chocolatey)

Para todas las demás plataformas, se realizará una instalación desde las fuentes. En tales sistemas donde la instalación basada en paquetes no está disponible, se requiere el siguiente software:

Go (golang)
GNU Make

Este rol no instala ninguno de los softwares anteriores en el host; tú debes asegurarte de hacerlo antes de aplicar este rol.

Variables del Rol

Las siguientes variables de rol se utilizan para la configuración del servicio de node_exporter:

node_exporter_args: Una lista de argumentos que se pasan al servicio node_exporter, un argumento por elemento en la lista.
node_exporter_create_user: Cuando es true, crea el usuario node_exporter_user y el correspondiente node_exporter_group (solo usado en plataformas Unix, por defecto es true).
node_exporter_group: Grupo para el usuario node_exporter_user (solo usado en plataformas Unix).
node_exporter_port: Puerto para exponer métricas.
node_exporter_user: Usuario bajo el cual se ejecutará node_exporter (solo usado en plataformas Unix).

Las siguientes variables se utilizan al compilar node_exporter desde fuentes:

node_exporter_install_from_binary: Cuando es true, node_exporter se instalará desde una descarga binaria y no a través de un gestor de paquetes. Esta opción no es soportada en todos los tipos de sistemas (consulta la sección "Requisitos" arriba).
node_exporter_binary_arch: Arquitectura binaria a obtener al descargar el binario de node_exporter.
node_exporter_version: Versión de node_exporter a instalar desde la fuente.

Las siguientes variables se utilizan en Windows:

windows_exporter_version: Versión de windows_exporter a instalar usando Chocolatey.

Consulta el archivo defaults/main.yml para la documentación completa sobre las variables de rol requeridas y opcionales.

Ejemplo de Playbook

---
- name: Instalar node_exporter en los 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: Forzar a los hosts de macOS a instalar desde la fuente, para que se pueda usar una versión específica
      set_fact:
        node_exporter_install_from_binary: true
      when: ansible_os_family == "Darwin"

    - name: Instalar software previo para los hosts de macOS
      homebrew:
        name: golang
        state: present

  roles:
    - ableton.prometheus_node_exporter