patrickjahns.openvpn_exporter
ansible-role-openvpn-exporter
Beschreibung
Installiere openvpn_exporter mit Ansible. Für aktuelle Änderungen, bitte den CHANGELOG prüfen oder die GitHub-Releases ansehen.
Anforderungen
- Ansible >= 2.7
Rollenvariablen
Alle variablen, die überschrieben werden können, sind in der Datei defaults/main.yml und in der folgenden Tabelle gespeichert.
| Name | Standardwert | Beschreibung |
|---|---|---|
openvpn_exporter_version |
1.1.2 | Die Version des openvpn_exporter, die installiert werden soll |
openvpn_exporter_system_user |
openvpn_exporter | Benutzer, unter dem der openvpn_exporter läuft |
openvpn_exporter_system_group |
openvpn_exporter | Gruppe, zu der der Benutzer openvpn_exporter gehört |
openvpn_exporter_user_additional_groups |
"" | Zusätzliche Gruppen, denen der Benutzer openvpn_exporter angehören soll (z.B. openvpn) |
openvpn_exporter_install_dir |
/opt/openvpn_exporter | Verzeichnis, in dem openvpn_exporter installiert wird |
openvpn_exporter_config_web_address |
"" | siehe openvpn_exporter |
openvpn_exporter_config_web_path |
"" | siehe openvpn_exporter |
openvpn_exporter_config_web_root |
"" | siehe openvpn_exporter |
openvpn_exporter_disable_client_metrics |
False | siehe openvpn_exporter |
openvpn_exporter_config_enable_golang_metrics |
False | siehe openvpn_exporter |
openvpn_exporter_config_log_level |
"info" | siehe openvpn_exporter |
openvpn_exporter_config_status_files |
[] | Pfad(e) zu den Statusdateien - siehe openvpn_exporter |
Beispiel-Playbook
---
- hosts: all
roles:
- role: patrickjahns.openvpn_exporter
vars:
openvpn_exporter_config_status_files:
- /etc/openvpn/server1.status
- servername:/etc/openvpn/server2.status
Lokales Testen
Die bevorzugte Möglichkeit, die Rolle lokal zu testen, ist die Verwendung von Docker und molecule (v3.x). Du musst Docker auf deinem System installieren. Siehe "Erste Schritte" für ein Docker-Paket, das für dein System geeignet ist. Wir verwenden tox, um den Prozess des Tests mit mehreren Ansible-Versionen zu vereinfachen. Um tox zu installieren, führe folgendes aus:
pip3 install tox
Um Tests auf allen Ansible-Versionen auszuführen (WARNUNG: dies kann einige Zeit in Anspruch nehmen):
tox
Um einen benutzerdefinierten Molecule-Befehl in einer benutzerdefinierten Umgebung mit nur dem Standard-Test-Szenario auszuführen:
tox -e ansible29 -- molecule test -s default
Für weitere Informationen zu Molecule gehe zu deren Dokumentation.
Wenn du Tests auf einem entfernten Docker-Host ausführen möchtest, gib einfach die Variable DOCKER_HOST an, bevor du die tox-Tests ausführst.
CI
GitHub-Aktionen werden verwendet, um diese Ansible-Rolle durch ansible-later und molecule zu testen und zu validieren. Die Kombination aus Molecule und Travis CI ermöglicht es uns, zu testen, wie neue PRs mit mehreren Ansible-Versionen und mehreren Betriebssystemen funktionieren. Dies ermöglicht es uns auch, Testszenarien für verschiedene Rollenkonfigurationen zu erstellen. Dadurch haben wir eine recht große Testmatrix, die mehr Zeit in Anspruch nimmt als lokale Tests, also bitte hab Geduld. Molecule-Tests werden mit mehreren Betriebssystemen und Ansible-Versionen durchgeführt, um die Kompatibilität sicherzustellen.
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE für weitere Details.
Wartende und Beitragende
Deploy openvpn_expoter via ansible
ansible-galaxy install patrickjahns.openvpn_exporter