Simon Cornet
5aaf6a11f3
All checks were successful
ci/woodpecker/push/linting Pipeline was successful
71 lines
2.6 KiB
Markdown
71 lines
2.6 KiB
Markdown
# Overview
|
|
|
|
This role the installation and configuration of the Zabbix Agent version 2.
|
|
|
|
## Supported Operating Systems
|
|
|
|
| Operating System | Version |
|
|
| ---------------- | --------- |
|
|
| Alpine | 3.23 |
|
|
| Debian | 13 |
|
|
| SLES | 15 |
|
|
| 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 |
|