ableton.amtool

Descripción general Versiones Perspectivas

Rol de Ansible ableton.amtool

Este rol instala amtool (del alertmanager) en el host de control de Ansible (nota: esta es la máquina donde ejecutas tus playbooks, no el host que estás aprovisionando con Ansible). El propósito de este rol es hacer que amtool esté disponible en el host de control para crear y expirar silencios.

Requisitos

Ansible >= 2.10 y un host de control que esté ejecutando una versión de Linux basada en Debian, o macOS.

Variables del Rol

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

Después de que el rol instale amtool, establecerá el hecho amtool_exe en la ruta del ejecutable instalado. Este hecho puede ser utilizado para llamar a amtool desde tareas de command subsiguientes en tus playbooks. Ten en cuenta que tales tareas deben ser delegadas a localhost.

Ejemplo de Playbook

---
- name: Crear silencios de alerta para todos los hosts
  hosts: "todos"
  gather_facts: false
  vars:
    alertmanager_url: "https://example.com/alertmanager"
    comment: "Añadido por Ansible"
    expiration_timeout: "4h"

  roles:
    - role: ableton.amtool
      run_once: true

  tasks:
    - name: Crear silencios para alertas de ejemplo
      delegate_to: localhost
      command: "{{ amtool_exe }} \
        --alertmanager.url={{ alertmanager_url }} \
        silence add \
        --comment='{{ comment }}' \
        --duration={{ expiration_timeout }} \
        alertname={{ alert_item }}"
      loop_control:
        loop_var: alert_item
      with_items:
        - "ejemplo_alerta_uno"
        - "ejemplo_alerta_dos"