paulfantom.rpi_exporter
Ansible Rôle : rpi_exporter
Description
Déployez rpi-exporter en utilisant Ansible.
Exigences
- Ansible >= 2.7 (Cela pourrait fonctionner sur des versions antérieures, mais nous ne pouvons pas le garantir)
Variables du rôle
Toutes les variables pouvant être remplacées sont stockées dans le fichier defaults/main.yml ainsi que dans le tableau ci-dessous.
Nom | Valeur par défaut | Description |
---|---|---|
rpi_exporter_version |
0.6.0 | Version empaquetée de rpi-exporter. Accepte également latest comme paramètre. |
rpi_exporter_web_listen_address |
"0.0.0.0:9243" | Adresse sur laquelle rpi_exporter écoutera |
rpi_exporter_system_group |
"rpi-exporter" | Groupe système utilisé pour exécuter rpi-exporter |
rpi_exporter_system_user |
"rpi-exporter" | Utilisateur système utilisé pour exécuter rpi-exporter |
Exemple
Playbook
Utilisez-le dans un playbook comme suit :
- hosts: all
roles:
- paulfantom.rpi_exporter
Test local
La méthode préférée pour tester localement le rôle est d'utiliser Docker et molecule (v2.x). Vous devrez installer Docker sur votre système. Consultez "Démarrer" pour un paquet Docker adapté à votre système. Nous utilisons tox pour simplifier le processus de test sur plusieurs versions d'Ansible. Pour installer tox exécutez :
pip3 install tox
Pour exécuter des tests sur toutes les versions d'Ansible (AVERTISSEMENT : cela peut prendre du temps)
tox
Pour exécuter une commande molecule personnalisée dans un environnement personnalisé avec un seul scénario de test par défaut :
tox -e py35-ansible28 -- molecule test -s default
Pour plus d'informations sur molecule, allez dans leur documentation.
Si vous souhaitez exécuter des tests sur un hôte Docker distant, il suffit de spécifier la variable DOCKER_HOST
avant d'exécuter les tests tox.
Travis CI
Combiner molecule et Travis CI nous permet de tester comment les nouvelles PR se comporteront lorsqu'elles sont utilisées avec plusieurs versions d'Ansible et plusieurs systèmes d'exploitation. Cela nous permet également de créer des scénarios de test pour différentes configurations de rôle. En conséquence, nous avons une matrice de test assez grande qui prendra plus de temps que les tests locaux, donc veuillez être patient.
Contribution
Voir les directives pour les contributeurs.
Licence
Ce projet est sous licence MIT. Consultez LICENSE pour plus de détails.
ansible-galaxy install paulfantom.rpi_exporter