ansible/zabbix-agent
ansible/zabbix-agent
2
0
Fork 0
Code Issues 1 Pull requests Activity

feat: implement new role layout

Browse source
This commit is contained in:
Simon Cornet 2025-11-01 13:29:04 +01:00
commit f791e1d307
5 changed files with 6 additions and 45 deletions
Download patch file Download diff file Expand all files Collapse all files

71
readme.md Normal file
View file

@ -0,0 +1,71 @@
# Overview
This role the installation and configuration of the Zabbix Agent version 2.
## Supported Operating Systems
| Operating System | Version |
| --- | ----- |
| Debian | 12 |
| SLES | 15 |
| Ubuntu | 22.04 LTS |
| Ubuntu | 24.04 LTS |
## Variables
| Variable | Type | Default | Required |
| --- | --- | --- | --- |
| zabbix_agent_hostinterface | string | inventory_hostname | No |
| zabbix_agent_hostname | string | inventory_hostname | No |
| zabbix_agent_listen_port | string | 10050 | No |
| zabbix_agent_psk_enable | bool | true | No |
| zabbix_agent_psk_id | string | | Yes* |
| zabbix_agent_psk | string(enc) | | Yes* |
| zabbix_proxy_address | string | shared.proxy.monitor.itcreation.tools | No |
| zabbix_proxy_port | string | 10051 | No |
| zabbix_user_sudo | bool | true | No |
* Only if `zabbix_agent_psk_enable` is set to `true`.
## Example usage
With PSK:
```yaml
zabbix_proxy_address: "proxy.monitor.localnet.internal"
zabbix_agent_psk_id: "client-psk"
zabbix_agent_psk: !vault
$ANSIBLE_VAULT;1.1;AES256
31633463613336373164373333633038393164383835646633303163316665303934646363383530
...
```
Without PSK:
```yaml
zabbix_proxy_address: "proxy.monitor.localnet.internal"
```
### DNS override
If DNS is complicated or permanently broken for some reason. We can override the
hostname and hostinterface.
The hostname is the visible name in Zabbix.
The hostinterface is what Zabbix uses to connect to the host.
```yaml
zabbix_agent_hostname: "server.example.com"
zabbix_agent_hostinterface: "192.168.10.10"
```
This is possible, but please `only use if really required`.
## Tags
If you call the role without tags, it will execute all of the stages bellow.
| Tags | Purpose |
| --- | --- |
| zabbix_agent_config | Only manage Zabbix Agent 2 configuration |
| zabbix_agent_install | Only manage Zabbix Agent 2 installation |
| zabbix_agent_prereq | Only manage Zabbix Agent 2 prerequisites |