openvpn_exporter
ansible-role-openvpn-exporter
Описание
Развертывание openvpn_exporter с помощью ansible. Для последних изменений, пожалуйста, проверьте CHANGELOG или посмотрите на релизы GitHub
Требования
- Ansible >= 2.7
Переменные роли
Все переменные, которые могут быть переопределены, хранятся в файле defaults/main.yml и в таблице ниже.
| Название | Значение по умолчанию | Описание |
|---|---|---|
openvpn_exporter_version |
1.1.2 | Версия openvpn_exporter, которую нужно установить |
openvpn_exporter_system_user |
openvpn_exporter | Пользователь, под которым будет работать openvpn_exporter |
openvpn_exporter_system_group |
openvpn_exporter | Группы, к которым принадлежит пользователь openvpn_exporter |
openvpn_exporter_user_additional_groups |
"" | Дополнительные группы, к которым должен принадлежать пользователь openvpn_exporter (например, openvpn) |
openvpn_exporter_install_dir |
/opt/openvpn_exporter | Директория, в которую будет установлен openvpn_exporter |
openvpn_exporter_config_web_address |
"" | см. openvpn_exporter |
openvpn_exporter_config_web_path |
"" | см. openvpn_exporter |
openvpn_exporter_config_web_root |
"" | см. openvpn_exporter |
openvpn_exporter_disable_client_metrics |
False | см. openvpn_exporter |
openvpn_exporter_config_enable_golang_metrics |
False | см. openvpn_exporter |
openvpn_exporter_config_log_level |
"info" | см. openvpn_exporter |
openvpn_exporter_config_status_files |
[] | Путь(и) к файлам статуса - см. openvpn_exporter |
Пример Playbook
---
- hosts: all
roles:
- role: patrickjahns.openvpn_exporter
vars:
openvpn_exporter_config_status_files:
- /etc/openvpn/server1.status
- servername:/etc/openvpn/server2.status
Локальное тестирование
Предпочтительный способ локального тестирования роли - использовать Docker и molecule (v3.x). Вам нужно будет установить Docker на вашу систему. Посмотрите "Начало работы", чтобы найти подходящий пакет Docker для вашей системы. Мы используем tox, чтобы упростить процесс тестирования на нескольких версиях ansible. Чтобы установить tox, выполните:
pip3 install tox
Чтобы запустить тесты на всех версиях ansible (ВНИМАНИЕ: это может занять некоторое время)
tox
Чтобы запустить команду molecule с пользовательской средой и только со сценарием по умолчанию:
tox -e ansible29 -- molecule test -s default
Для получения дополнительной информации о molecule перейдите в их документацию.
Если вы хотите запустить тесты на удалённом хосте Docker, просто укажите переменную DOCKER_HOST перед запуском тестов tox.
CI
Действия GitHub используются для тестирования и проверки этой роли ansible с помощью ansible-later и molecule. Совмещение molecule и travis CI позволяет нам тестировать, как новые PR будут работать с несколькими версиями ansible и несколькими операционными системами. Это также позволяет создать сценарии тестирования для различных конфигураций роли. В результате мы имеем довольно большую тестовую матрицу, что займет больше времени, чем локальное тестирование, так что, пожалуйста, будьте терпеливы. Тесты Molecule будут выполняться с несколькими операционными системами и версиями ansible для обеспечения совместимости.
Лицензия
Этот проект лицензирован под лицензией MIT. Смотрите LICENSE для получения дополнительных сведений.
Поддержка и вкладчики
ansible-galaxy install patrickjahns/ansible-role-openvpn-exporter