feat: initial commit

This commit is contained in:
Simon Cornet 2025-04-16 17:32:51 +02:00
commit 0830507cf7
20 changed files with 459 additions and 0 deletions

56
README.md Normal file
View file

@ -0,0 +1,56 @@
# 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_proxy_address | string | | Yes |
| zabbix_agent_hostinterface | string | inventory_hostname | No |
| zabbix_agent_hostname | string | inventory_hostname | No |
| zabbix_agent_psk_enable | bool | true | No |
| zabbix_agent_psk_id | string | | Yes |
| zabbix_agent_psk | string(enc) | | Yes |
| zabbix_user_sudo | bool | true | No |
# Example usage
With PSK:
```
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:
```
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.
```
zabbix_agent_hostname: "server.example.com"
zabbix_agent_hostinterface: "192.168.10.10"
```
This is possible, but please `only use if really required`.
# Tags
| Tags | Purpose |
| --- | --- |
| zabbix_agent | Executes the whole playbook |
| 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 |