patrickjahns.openvpn_exporter
ansible-role-openvpn-exporter
Description
Déployez openvpn_exporter en utilisant Ansible.
Pour les changements récents, veuillez consulter le CHANGELOG ou jetez un œil aux versions GitHub.
Exigences
- Ansible >= 2.7
Variables de rôle
Toutes les variables qui peuvent ê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 |
|---|---|---|
openvpn_exporter_version |
1.1.2 | La version de openvpn_exporter à installer |
openvpn_exporter_system_user |
openvpn_exporter | Utilisateur sous lequel openvpn_exporter s'exécutera |
openvpn_exporter_system_group |
openvpn_exporter | Groupes auxquels appartient l'utilisateur openvpn_exporter |
openvpn_exporter_user_additional_groups |
"" | Groupes supplémentaires auxquels l'utilisateur openvpn_exporter doit appartenir (par exemple, openvpn) |
openvpn_exporter_install_dir |
/opt/openvpn_exporter | Répertoire dans lequel openvpn_exporter sera installé |
openvpn_exporter_config_web_address |
"" | voir openvpn_exporter |
openvpn_exporter_config_web_path |
"" | voir openvpn_exporter |
openvpn_exporter_config_web_root |
"" | voir openvpn_exporter |
openvpn_exporter_disable_client_metrics |
False | voir openvpn_exporter |
openvpn_exporter_config_enable_golang_metrics |
False | voir openvpn_exporter |
openvpn_exporter_config_log_level |
"info" | voir openvpn_exporter |
openvpn_exporter_config_status_files |
[] | Chemin(s) vers les fichiers de statut - voir openvpn_exporter |
Exemple de Playbook
---
- hosts: all
roles:
- role: patrickjahns.openvpn_exporter
vars:
openvpn_exporter_config_status_files:
- /etc/openvpn/server1.status
- servername:/etc/openvpn/server2.status
Test local
La meilleure façon de tester le rôle localement est d'utiliser Docker et molecule (v3.x). Vous devez installer Docker sur votre système. Consultez "Démarrer" pour un package 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 un certain temps) :
tox
Pour exécuter une commande molecule personnalisée dans un environnement personnalisé avec seulement le scénario de test par défaut :
tox -e ansible29 -- molecule test -s default
Pour plus d'informations sur molecule, consultez leur documentation.
Si vous souhaitez exécuter des tests sur un hôte Docker distant, spécifiez simplement la variable DOCKER_HOST avant d'exécuter les tests tox.
CI
Les actions GitHub sont utilisées pour tester et valider ce rôle Ansible via ansible-later et molecule.
La combinaison de molecule et de travis CI nous permet de tester comment les nouvelles demandes de tirage se comporteront 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 le test local, donc veuillez être patient. Les tests de molecule s'exécuteront avec plusieurs systèmes d'exploitation ainsi que des versions d'Ansible afin de garantir la compatibilité.
Licence
Ce projet est sous licence MIT. Voir LICENSE pour plus de détails.
Mainteneurs et contributeurs
Deploy openvpn_expoter via ansible
ansible-galaxy install patrickjahns.openvpn_exporter