jaredledvina.sensu_go_ansible
sensu-go-ansible
此角色允许部署和管理 Sensu Go。
官方的 Sensu 支持的 Ansible 集合可以在这里找到: https://github.com/sensu/sensu-go-ansible
如果您想贡献,请查看 CONTRIBUTING.md 并 提出一个问题来讨论您的想法。
需求
角色变量
请查看 defaults/main.yml
获取所有可配置的项。如果某些选项不清楚,请
提交问题!
请注意,除非您已将 hash_behaviour
配置为 merge
(https://docs.ansible.com/ansible/latest/reference_appendices/config.html#default-hash-behaviour),否则配置任何哈希变量将**覆盖**整个默认变量。
大多数变量都提供一个 _overrides: {}
变量,该变量会在此角色中自动合并以选择性更新每个变量。强烈建议使用 _overrides
变量。
依赖
无
示例剧本
以下示例将配置 sensu-backend-server
组中的主机,使其配置为使用 sensu-backend
和 sensu-agent
。该主机还将获得 sensuctl
CLI 工具,以便进一步管理 Sensu Go。
sensu-agent-severs
中的主机将仅获取 sensu-agent
安装,并且将 sensu-agent
的 backend-url
配置选项覆盖为 ws://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
的版本。
以下操作系统会自动测试:
- Amazon Linux
- Amazon Linux 2
- CentOS - 6
- CentOS - 7
- Debian - 8 (Jessie)
- Debian - 9 (Stretch)
- Debian - 10 (Buster)
- Fedora - 30
- Fedora - 31
- Ubuntu - 16.04 (Xenial Xerus)
- Ubuntu - 18.04 (Bionic Beaver)
自定义模块
此角色包括以下 自定义模块:
目前,这些模块处于 preview
状态,并可能会发生重大变化。不过,我们会努力尽量不破坏它们。请在升级时确保
查阅 CHANGELOG。
正如 上游文档 中所述, 要使用包含的自定义模块,您必须首先包含此角色,然后才能调用这些模块。在包含该角色后,将可用于后续的播放/角色。
目前,每个模块的文档都在每个模块源的 DOCUMENTATION
块中。一旦模块稳定,它们可能会通过 PR 上报到 Ansible 项目。
注意事项
如果您在 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
如果您在 Debian 8、9 或 10 主机上使用此角色,则必须覆盖以下变量:
sensu_go_manage_community_repo: false
这是由于 Debian 包未更新到社区仓库,等待解决 https://github.com/sensu/sensu-plugins-omnibus/issues/3
许可证
许可证
ansible-galaxy install jaredledvina.sensu_go_ansible