garyalex / sensu-go-ansible

Ansible role to deploy and manage Sensu Go

sensu-go-ansible

This role allows for the deployment and management of Sensu Go.

If you'd like to contribute, please review CONTRIBUTING.md and open an issue to discuss your idea.

Requirements

• Ansible 2.7

Role Variables

See defaults/main.yml for everything that's configurable. If any of the options are unclear, please file an issue!

Please note that unless you've configured hash_behaviour to merge configuring any of the hash variables will override the entire default variable.

Most variables expose an _overrides: {} variable that is merged automatically in this role for selectively updating each variable. It's strongly recommended that the _overrides variable be used.

Dependencies

None

Example Playbook

The following example will configure the host in the hostgroup sensu-backend-server to be configured with both sensu-backend and sensu-agent. This host will also get the sensuctl CLI tool for further management of Sensu Go.

The hosts in sensu-agent-severs will only get the sensu-agent install and will have the sensu-agent's configuration option for backend-url overriden to ws://sensu-backend-server:8081.

For more information on the availible configuration options, checkout the upstream docs for sensu-backend and 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

Testing

This Ansible role is automatically tested via TravisCI on every commit. We specifically test using the version of Ansible and python declared in the Pipefile

The following Operating Systems are automatically tested:

• Amazon Linux
• Amazon Linux 2
• CentOS - 6
• CentOS - 7
• Debian - 8 (Jessie)
• Debian - 9 (Stretch)
• Fedora - 26
• Fedora - 27
• Fedora - 28
• Fedora - 29
• Ubuntu - 14.04 (Trusty Tahr)
• Ubuntu - 16.04 (Xenial Xerus)
• Ubuntu - 18.04 (Bionic Beaver)

Caveats

If you are using this role with Amazon Linux or Amazon Linux 2, you must override the following variables on those host(s):

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

If you are using this role with Debian 8 or 9 hosts, you must overide the following variable:

sensu_go_manage_community_repo: false

This is due to Debian packages not being updated to the community repos pending the resolution of sensu/sensu-plugins-omnibus#3

License

MIT