59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
Zabbix Agent ansible role
|
|
=========
|
|
|
|
This role can be used to deploy Zabbix agents via Ansible automation tool
|
|
|
|
Requirements
|
|
------------
|
|
|
|
This role is only for Debian distributions. It will install 4.4 version of Zabbix agents from Zabbix official repo.\
|
|
To use TLS encryption with Auto-Registration, your server needs to be on 4.4 version as well.
|
|
|
|
Role Variables
|
|
--------------
|
|
|
|
Each variable is set with a default value in 'defaults/main.conf'. You could change the file or overide them when calling the role.
|
|
|
|
- zabbix_server: "zabbix.example.net"\
|
|
FQDN or IP address of Zabbix server. This variable is used to set 'ServerActive' parameter, so use only one FQDN/IP.
|
|
|
|
- zabbix_proxies: "127.0.0.1"\
|
|
Comma separated list of proxies or other hosts which should be able to poll passive Zabbix agent. It is used to set the 'Server' parameter along with the 'zabbix_server' variable.
|
|
|
|
- zabbix_psk: False\
|
|
PSK for TLS encryption. If set to 'False', TLS parameters won't be set in Zabbix agent configuration file.
|
|
|
|
- zabbix_psk_id: "PSKAR"\
|
|
PSK Identity for TLS encryption. See how to configure Auto-Registration with TLS here [#zabbix-auto-registration-with-tls]
|
|
|
|
Zabbix Auto-Registration with TLS
|
|
---------------------------------
|
|
|
|
In Zabbix Web interface, go to 'Administration/General/Auto-Registration' ($ZABBIX_SERVER_URL/zabbix.php?action=autoreg.edit).\
|
|
|
|
Check the PSK option and fill the two field with your PSK Identity and PSK and save.
|
|
|
|
|
|
Example Playbook
|
|
----------------
|
|
|
|
Here is an example of how to use this role in a playbook:
|
|
|
|
- hosts: servers
|
|
gather_facts: yes
|
|
become: yes
|
|
become_user: root
|
|
|
|
roles:
|
|
- { role: zabbix-agent, tags: zabbix } # when not using TLS
|
|
- { role: zabbix-agent, tags: zabbix, zabbix_psk_id: PSKAR, zabbix_psk: jdkjnckdsjncdskncsdkcldsoijds } # when using TLS
|
|
|
|
License
|
|
-------
|
|
|
|
"THE BEER-WARE LICENSE" (Revision 42):
|
|
|
|
PMJ wrote this file. As long as you retain this notice you can
|
|
do whatever you want with this stuff. If we meet some day, and you think this
|
|
stuff is worth it, you can buy me a beer in return. PMJ
|