patrickjahns.openvpn_exporter
ansible-role-openvpn-exporter
Descripción
Despliega openvpn_exporter usando ansible. Para conocer los cambios recientes, revisa el CHANGELOG o mira las versiones en github.
Requisitos
- Ansible >= 2.7
Variables del rol
Todas las variables que se pueden sobrescribir están almacenadas en el archivo defaults/main.yml así como en la tabla a continuación.
| Nombre | Valor por defecto | Descripción |
|---|---|---|
openvpn_exporter_version |
1.1.2 | La versión de openvpn_exporter a instalar |
openvpn_exporter_system_user |
openvpn_exporter | Usuario con el que se ejecutará openvpn_exporter |
openvpn_exporter_system_group |
openvpn_exporter | Grupo al que pertenece el usuario openvpn_exporter |
openvpn_exporter_user_additional_groups |
"" | Grupos adicionales a los que debe pertenecer el usuario openvpn_exporter (por ejemplo, openvpn) |
openvpn_exporter_install_dir |
/opt/openvpn_exporter | Directorio donde se instalará openvpn_exporter |
openvpn_exporter_config_web_address |
"" | ver openvpn_exporter |
openvpn_exporter_config_web_path |
"" | ver openvpn_exporter |
openvpn_exporter_config_web_root |
"" | ver openvpn_exporter |
openvpn_exporter_disable_client_metrics |
False | ver openvpn_exporter |
openvpn_exporter_config_enable_golang_metrics |
False | ver openvpn_exporter |
openvpn_exporter_config_log_level |
"info" | ver openvpn_exporter |
openvpn_exporter_config_status_files |
[] | Ruta(s) a los archivos de estado - ver openvpn_exporter |
Ejemplo de Playbook
---
- hosts: all
roles:
- role: patrickjahns.openvpn_exporter
vars:
openvpn_exporter_config_status_files:
- /etc/openvpn/server1.status
- servername:/etc/openvpn/server2.status
Pruebas Locales
La forma preferida de probar localmente el rol es usar Docker y molecule (v3.x). Deberás instalar Docker en tu sistema. Consulta "Get started" para un paquete de Docker adecuado para tu sistema. Utilizamos tox para simplificar el proceso de prueba en múltiples versiones de ansible. Para instalar tox ejecuta:
pip3 install tox
Para ejecutar pruebas en todas las versiones de ansible (ADVERTENCIA: esto puede tomar un tiempo)
tox
Para ejecutar un comando de molecule personalizado en un entorno personalizado solo con el escenario de prueba predeterminado:
tox -e ansible29 -- molecule test -s default
Para más información sobre molecule visita su documentación.
Si deseas ejecutar pruebas en un host docker remoto, solo especifica la variable DOCKER_HOST antes de ejecutar las pruebas de tox.
CI
Se usan acciones de Github para probar y validar este rol de ansible a través de ansible-later y molecule. Combinando molecule y travis CI, podemos probar cómo se comportarán nuevos PRs cuando se utilicen con múltiples versiones de ansible y múltiples sistemas operativos. Esto también nos permite crear escenarios de prueba para diferentes configuraciones del rol. Como resultado, tenemos una matriz de pruebas bastante grande que llevará más tiempo que las pruebas locales, así que por favor, ten paciencia. Las pruebas de molecule se ejecutarán con varios sistemas operativos y versiones de ansible para asegurar compatibilidad.
Licencia
Este proyecto está licenciado bajo la Licencia MIT. Consulta LICENSE para más detalles.
Mantenedores y Contribuyentes
Deploy openvpn_expoter via ansible
ansible-galaxy install patrickjahns.openvpn_exporter