jaredledvina.sensu_go_ansible

sensu-go-ansible

Ce rôle permet le déploiement et la gestion de Sensu Go.

La collection Ansible officiellement supportée par Sensu se trouve ici : https://github.com/sensu/sensu-go-ansible

Si vous souhaitez contribuer, veuillez consulter CONTRIBUTING.md et ouvrir un problème pour discuter de votre idée.

Exigences

Ansible 2.9

Variables de rôle

Consultez defaults/main.yml pour tout ce qui est configurable. Si certaines options ne sont pas claires, veuillez ouvrir un problème!

Veuillez noter que sauf si vous avez configuré hash_behaviour sur merge, la configuration de l'une des variables de hachage annule entièrement la variable par défaut.

La plupart des variables exposent une variable _overrides: {} qui est automatiquement fusionnée dans ce rôle pour mettre à jour chaque variable sélectivement. Il est fortement recommandé d'utiliser la variable _overrides.

Dépendances

Aucune

Exemple de playbook

L'exemple suivant configurera l'hôte dans le groupe d'hôtes sensu-backend-server pour être configuré avec à la fois sensu-backend et sensu-agent. Cet hôte obtiendra également l'outil en ligne de commande sensuctl pour une gestion supplémentaire de Sensu Go.

Les hôtes dans sensu-agent-severs n’obtiendront que l’installation de sensu-agent et la configuration de l’option backend-url de sensu-agent sera remplacée par ws://sensu-backend-server:8081.

Pour plus d'informations sur les options de configuration disponibles, consultez la documentation en amont pour sensu-backend et sensu-agent.

---
-
  hosts: sensu-backend-server
  become: yes
  roles:
    - role: jaredledvina.sensu_go_ansible
-
  hosts: sensu-agent-severs
  roles:
    - role: jaredledvina.sensu_go_ansible
      sensu_go_components:
        - agent
      sensu_go_configs_override:
        agent:
          config:
            backend-url:
              - ws://sensu-backend-server:8081

Tests

Ce rôle Ansible est automatiquement testé via TravisCI à chaque commit. Nous testons spécifiquement en utilisant la version de Ansible et python déclarée dans le Pipefile

Les systèmes d'exploitation suivants sont automatiquement testés :

Modules personnalisés

Ce rôle inclut les modules personnalisés suivants :

sensu-go-check

À l'heure actuelle, ces modules sont en statut preview et peuvent être sujets à des changements pouvant casser la compatibilité. Cependant, des efforts seront faits pour éviter de les casser, si possible. Veuillez vous assurer de consulter le CHANGELOG lors de la mise à jour.

Comme décrit dans la documentation en amont, pour utiliser les modules personnalisés inclus, vous devez d'abord inclure ce rôle avant d'appeler les modules. Après avoir inclus ce rôle une fois, ils seront disponibles pour les jeux/rôles suivants.

Actuellement, la documentation pour chaque module se trouve dans le bloc DOCUMENTATION dans la source de chaque module. Une fois que les modules seront stabilisés, ils pourront être proposés en PR au projet Ansible.

Avertissements

Si vous utilisez ce rôle avec Amazon Linux ou Amazon Linux 2, vous devez remplacer les variables suivantes sur ces hôtes :

Amazon Linux :

sensu_go_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/stable/el/6/x86_64
    rpm-src: https://packagecloud.io/sensu/stable/el/6/SRPMS
sensu_go_community_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/community/el/6/x86_64
    rpm-src: https://packagecloud.io/sensu/community/el/6/SRPMS

Amazon Linux 2 :

sensu_go_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/stable/el/7/x86_64
    rpm-src: https://packagecloud.io/sensu/stable/el/7/SRPMS
sensu_go_community_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/community/el/7/x86_64
    rpm-src: https://packagecloud.io/sensu/community/el/7/SRPMS

Si vous utilisez ce rôle avec des hôtes Debian 8, 9 ou 10, vous devez remplacer la variable suivante :

sensu_go_manage_community_repo: false

Cela est dû au fait que les paquets Debian ne sont pas mis à jour vers les dépôts communautaires en attendant la résolution de https://github.com/sensu/sensu-plugins-omnibus/issues/3