ableton.amtool

Rôle Ansible ableton.amtool

Ce rôle installe amtool (provenant de alertmanager) sur l'hôte de contrôle Ansible (note : il s'agit de la machine sur laquelle vous exécutez vos playbooks, pas de l'hôte que vous configurez avec Ansible). L'objectif de ce rôle est de rendre amtool disponible sur l'hôte de contrôle afin de créer et d'expirer des silences.

Exigences

Ansible >= 2.10, et un hôte de contrôle qui fonctionne sous une distribution Linux de type Debian ou sous macOS.

Variables du Rôle

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

Après que le rôle ait installé amtool, il définira le fait amtool_exe comme le chemin de l'exécutable installé. Ce fait peut être utilisé pour appeler amtool dans les tâches command suivantes de vos playbooks. Notez que ces tâches doivent être déléguées à localhost.

Exemple de Playbook

---
- name: Créer des silences d'alerte pour tous les hôtes
  hosts: "all"
  gather_facts: false
  vars:
    alertmanager_url: "https://example.com/alertmanager"
    comment: "Ajouté par Ansible"
    expiration_timeout: "4h"

  roles:
    - role: ableton.amtool
      run_once: true

  tasks:
    - name: Créer des silences pour les alertes d'exemple
      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:
        - "example_alert_one"
        - "example_alert_two"