patrickjahns.openvpn_exporter
ansible-role-openvpn-exporter
説明
Ansibleを使用してopenvpn_exporterをデプロイします。 最近の変更については、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の使用方法を参照 |
例プレイブック
---
- 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パッケージを確認してください。 複数のAnsibleバージョンでテストを簡素化するためにtoxを使用しています。toxをインストールするには、以下を実行します：
pip3 install tox
すべてのAnsibleバージョンでテストを実行するには（警告：これには少し時間がかかる場合があります）：
tox
デフォルトのテストシナリオのみのカスタム環境でカスタムmoleculeコマンドを実行するには：
tox -e ansible29 -- molecule test -s default
moleculeの詳細については、ドキュメントを参照してください。
リモートDockerホストでテストを実行したい場合は、toxテストを実行する前にDOCKER_HOST変数を指定してください。
CI
GitHub Actionsを使用して、ansible-laterとmoleculeを介してこのAnsibleロールをテストおよび検証します。 moleculeとTravis CIを組み合わせることで、新しいPRが複数のAnsibleバージョンおよび複数のオペレーティングシステムでどのように動作するかをテストできます。これにより、異なるロール構成のテストシナリオを作成することも可能です。その結果、かなり大きなテストマトリックスができるため、ローカルテストより時間がかかるので、しばらくお待ちください。Moleculeテストは、互換性を確保するために、さまざまなオペレーティングシステムおよびAnsibleバージョンで実行されます。
ライセンス
このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEを参照してください。
メンテイナーと貢献者
ansible-galaxy install patrickjahns.openvpn_exporter