jaredledvina.sensu_go_ansible

概要バージョン洞察

sensu-go-ansible

このロールは、Sensu Goのデプロイと管理を行うことができます。

公式のSensuサポートのAnsibleコレクションはこちらで見つけられます: https://github.com/sensu/sensu-go-ansible

貢献したい方は、CONTRIBUTING.mdを確認し、アイデアについて議論するためにイシューを開いてください。

要件

Ansible 2.9

ロール変数

設定可能なすべての項目はdefaults/main.ymlで確認できます。オプションの説明が不明な場合は、イシューを作成してください。

hash_behaviourをmergeに設定しない限り、ハッシュ変数の設定はデフォルト変数を上書きしますので注意してください。

ほとんどの変数には、各変数を選択的に更新するために自動的にマージされる_overrides: {}変数が公開されています。_overrides変数を使用することを強くお勧めします。

依存関係

なし

例プレイブック

以下の例では、sensu-backend-serverというホストグループにホストを設定し、sensu-backendとsensu-agentの両方を設定します。このホストにはさらにSensu Goの管理用CLIツールsensuctlもインストールされます。

sensu-agent-severs内のホストは、sensu-agentのインストールのみが行われ、backend-urlの設定オプションはsensu-backend-server:8081に上書きされます。

利用可能な設定オプションの詳細については、sensu-backendとsensu-agentの上流ドキュメントを確認してください。

---
-
  hosts: sensu-backend-server
  become: yes
  roles:
    - role: jaredledvina.sensu_go_ansible
-
  hosts: sensu-agent-severs
  roles:
    - role: jaredledvina.sensu_go_ansible
      sensu_go_components:
        - agent
      sensu_go_configs_override:
        agent:
          config:
            backend-url:
              - ws://sensu-backend-server:8081

テスト

このAnsibleロールは、すべてのコミットでTravisCIを使用して自動テストされています。特に、Pipefileに記載されたバージョンのAnsibleとpythonを使用してテストしています。

以下のオペレーティングシステムが自動でテストされています：

カスタムモジュール

このロールには、次のカスタムモジュールが含まれています：

sensu-go-check

現在、これらのモジュールはpreviewの状態であり、変更が生じる可能性があります。ただし、変更がないよう努力します。アップグレード時にはCHANGELOGを確認してください。

上流ドキュメントに記載されているように、カスタムモジュールを使用するには、このロールを含めてからモジュールを呼び出す必要があります。このロールを一度含めると、その後のプレイやロールでも利用可能になります。

現在、各モジュールに関するドキュメントは、各モジュールのソースのDOCUMENTATIONブロックにあります。モジュールが安定したら、AnsibleプロジェクトにPRを出すことができます。

注意事項

Amazon LinuxまたはAmazon Linux 2でこのロールを使用する場合、次の変数をホストで上書きする必要があります：

Amazon Linux:

sensu_go_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/stable/el/6/x86_64
    rpm-src: https://packagecloud.io/sensu/stable/el/6/SRPMS
sensu_go_community_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/community/el/6/x86_64
    rpm-src: https://packagecloud.io/sensu/community/el/6/SRPMS

Amazon Linux 2:

sensu_go_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/stable/el/7/x86_64
    rpm-src: https://packagecloud.io/sensu/stable/el/7/SRPMS
sensu_go_community_repos_overrides:
  yum:
    rpm: https://packagecloud.io/sensu/community/el/7/x86_64
    rpm-src: https://packagecloud.io/sensu/community/el/7/SRPMS