diff --git a/README.md b/README.md index 03c895e..38cd106 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,56 @@ sudo chmod 0640 /etc/zabbix/ssl_targets.json Pas daarna `/etc/zabbix/ssl_targets.json` aan voor je eigen targets. +## Installatie met Docker + +Gebruik je de officiƫle Zabbix Docker-images, dan is het meestal praktischer om external scripts en de target-config in het persistente Zabbix data-volume te zetten. Met jouw volumeconfig: + +```yaml +volumes: + - /media/zabbix/zabbix-server-data:/var/lib/zabbix + - /media/zabbix/zabbix-snmptraps-data:/var/lib/zabbix/snmptraps + - /media/zabbix/zabbix-export-data:/var/lib/zabbix/export +``` + +kun je op de Docker-host deze paden gebruiken: + +```bash +sudo install -d -o 1997 -g 1995 -m 0755 /media/zabbix/zabbix-server-data/externalscripts +sudo install -o 1997 -g 1995 -m 0755 scripts/ssl_discovery.py /media/zabbix/zabbix-server-data/externalscripts/ +sudo install -o 1997 -g 1995 -m 0755 scripts/ssl_check.py /media/zabbix/zabbix-server-data/externalscripts/ +sudo install -o 1997 -g 1995 -m 0640 config/ssl_targets.json.example /media/zabbix/zabbix-server-data/ssl_targets.json +``` + +In de container worden deze bestanden dan zichtbaar als: + +```text +/var/lib/zabbix/externalscripts/ssl_discovery.py +/var/lib/zabbix/externalscripts/ssl_check.py +/var/lib/zabbix/ssl_targets.json +``` + +Zet op de host `{$SSL_CONFIG}` in de gelinkte template of host-macro daarom op: + +```text +/var/lib/zabbix/ssl_targets.json +``` + +Test daarna vanuit de Zabbix server-container. Vervang `zabbix-server` door de naam van jouw container: + +```bash +docker exec -u zabbix zabbix-server /var/lib/zabbix/externalscripts/ssl_discovery.py --config /var/lib/zabbix/ssl_targets.json +docker exec -u zabbix zabbix-server /var/lib/zabbix/externalscripts/ssl_check.py --config /var/lib/zabbix/ssl_targets.json --host home.blockje.nl --port 443 +``` + +Als jouw image external scripts niet uit `/var/lib/zabbix/externalscripts` leest, mount dan expliciet naar de directory die in de container als `ExternalScripts` is ingesteld. Vaak is dat bij niet-Docker installaties `/usr/lib/zabbix/externalscripts`. Controleer bij twijfel de Zabbix server/proxy configuratie in de container. + +Let op met UID/GID: officiƫle Zabbix containers gebruiken vaak de `zabbix` gebruiker binnen de container. De numerieke `1997:1995` komt veel voor, maar kan per image verschillen. Als de testcommando's permission errors geven, controleer dan met: + +```bash +docker exec zabbix-server id zabbix +docker exec zabbix-server ls -l /var/lib/zabbix/externalscripts /var/lib/zabbix/ssl_targets.json +``` + ## Configuratie Voorbeeld: