Sensu Go install role¶

This role installs selected Sensu Go components from the official precompiled packages.

Note

This role only configures your package manager (like yum or apt) and installs the binaries. It does not configure anything and it does not run any services.

Example playbook¶

The next playbook demonstrates how to install different versions of Sensu components from specific channels.

---
- name: Install latest sensu-backend binary from stable channel
  hosts: backends
  roles:
     - sensu.sensu_go.install
  vars:
    components: [ sensu-go-backend ]

- name: Install latest sensu-agent binary from testing channel
  hosts: agents
  roles:
     - sensu.sensu_go.install
  vars:
    components: [ sensu-go-agent ]
    channel: testing

- name: Install a specific version of sensuctl binary from stable channel
  hosts: localhost
  roles:
     - sensu.sensu_go.install
  vars:
    components: [ sensu-go-cli ]
    version: 5.14.2

Role Variables¶

This role consults the following variables to determine what packages to install:

Variable	Default value	Description
components	sensu-go-backend sensu-go-agent sensu-go-cli	List of components to install. Valid values are `sensu-go-backend`, `sensu-go-agent` and `sensu-go-cli`.
channel	stable	Repository channel that serves as a source of packages. We can see all the available channels on packagecloud site.
version	latest	Package version to install. Can be any valid version string such as `5.14.2` or special value `latest`.
build	latest	Package build to install. Can be any valid build string such as `8290` or a special value `latest`. If the version variable is set to `latest`, this variable is ignored and the latest available build is installed.
packagecloud_auth	“”	Credentials to use when setting up Sensu Go repos. For publicly available repos, this can be left empty. For private repos, this should be set to the value of the read token, folloved by the `:@`. Example: `ofb9123457acdddef6734524:@`.

Tested Platforms (CI/CD)¶

OS	distribution	versions
Linux	Amazon	1, 2
	CentOS	7, 8
	RedHat	7, 8
	Debian	9, 10
	Ubuntu	14.04, 16.04, 18.04