5 Installatie vanuit containers

Overzicht

Dit gedeelte beschrijft hoe je Zabbix kunt implementeren met Docker of Docker Compose.

Zabbix biedt officieel:

• Afzonderlijke Docker-images voor elk Zabbix-component om te draaien als draagbare en zelfvoorzienende containers.
• Compose-bestanden om multi-container Zabbix-componenten in Docker te definiëren en uit te voeren.

::: notebelangrijk Sinds Zabbix 6.0 moeten deterministische triggers worden aangemaakt tijdens de installatie. Als binaire logging is ingeschakeld voor MySQL/MariaDB, zijn hiervoor supergebruikersrechten nodig of moet de variabele/configuratieparameter log_bin_trust_function_creators = 1 worden ingesteld. Raadpleeg Databasecreatie-scripts voor instructies over hoe je de variabele kunt instellen.
Merk op dat als je het vanuit een console uitvoert, de variabele slechts tijdelijk wordt ingesteld en wordt verwijderd wanneer een Docker opnieuw wordt gestart. In dat geval houd je je SQL-service actief, stop je alleen de zabbix-server-service door 'docker compose down zabbix-server' uit te voeren en vervolgens 'docker compose up -d zabbix-server'. Als alternatief kun je deze variabele instellen in het configuratiebestand. :::

Bronbestanden

Docker-bestandsbronnen worden opgeslagen in het Zabbix officiële repository op GitHub, waar je de nieuwste bestandswijzigingen kunt volgen of het project kunt forkken om je eigen afbeeldingen te maken.

Docker

Zabbix biedt afbeeldingen op basis van verschillende basis-OS-afbeeldingen. Voor een lijst van ondersteunde basisbesturingssysteemafbeeldingen voor een specifiek Zabbix-component, zie de beschrijving van het component op Docker Hub. Alle Zabbix-afbeeldingen zijn geconfigureerd om de nieuwste afbeeldingen opnieuw op te bouwen als de basisafbeeldingen worden bijgewerkt.

Installatie

Om een Zabbix-componentafbeelding te krijgen, voer je het volgende uit:

docker pull zabbix/zabbix-server-mysql

Vervang zabbix/zabbix-server-mysql door de naam van het vereiste Docker-repository.

Deze opdracht zal de nieuwste stabiele versie van het Zabbix-component ophalen op basis van het Alpine Linux-besturingssysteem. Je kunt tags aan de naam van het repository toevoegen om een afbeelding te krijgen op basis van een ander besturingssysteem of van een specifieke Zabbix-hoofd- of subversie.

De volgende repositories zijn beschikbaar op Docker Hub:

Tags

Officiële Zabbix component images kunnen de volgende tags bevatten:

Initiële configuratie

Na het downloaden van de afbeeldingen start je de containers door het uitvoeren van het docker run-commando, gevolgd door aanvullende argumenten om de vereiste omgevingsvariabelen en/of koppelingspunten op te geven. Hieronder worden enkele configuratievoorbeelden gegeven.

::: notitie Om communicatie tussen Zabbix-componenten mogelijk te maken, worden enkele poorten, zoals 10051/TCP voor Zabbix-server (trapper), 10050/TCP voor Zabbix-agent, 162/UDP voor SNMP-traps en 80/TCP voor Zabbix-webinterface, blootgesteld aan de hostmachine. Een volledige lijst van standaardpoorten die door Zabbix-componenten worden gebruikt, is beschikbaar op de Vereisten pagina. Voor Zabbix-server en -agent kan de standaardpoort worden gewijzigd door de omgevingsvariabele ZBX_LISTENPORT in te stellen. :::

Omgevingsvariabelen

Alle Zabbix-componentafbeeldingen bieden omgevingsvariabelen om de configuratie te beheersen. Ondersteunde omgevingsvariabelen worden vermeld in het componentrepository.

Deze omgevingsvariabelen zijn opties uit Zabbix-configuratiebestanden, maar met een andere benamingsmethode. Bijvoorbeeld, ZBX_LOGSLOWQUERIES is gelijk aan LogSlowQueries uit de Zabbix server en Zabbix proxy configuratiebestanden.

::: notitiebelangrijk Sommige configuratieopties kunnen niet worden gewijzigd. Bijvoorbeeld, PIDFile en LogType. :::

De volgende omgevingsvariabelen zijn specifiek voor Docker-componenten en bestaan niet in Zabbix-configuratiebestanden:

Volumes

De afbeeldingen maken het mogelijk om volumes te koppelen met behulp van de volgende koppelpunten:

Voor aanvullende informatie kunt u de officiële Zabbix-repositories in Docker Hub raadplegen.

Voorbeelden

Voorbeeld 1

Dit voorbeeld laat zien hoe je Zabbix-server met MySQL-databaseondersteuning, de Zabbix-webinterface gebaseerd op de Nginx-webserver en de Zabbix Java Gateway kunt uitvoeren.

1. Maak een netwerk aan dat is toegewijd aan containers voor Zabbix-componenten:

   docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net

2. Start een lege MySQL-serverinstantie:

   docker run --name mysql-server -t \

     -e MYSQL_DATABASE="zabbix" \
     -e MYSQL_USER="zabbix" \
     -e MYSQL_PASSWORD="zabbix_pwd" \
     -e MYSQL_ROOT_PASSWORD="root_pwd" \
     --network=zabbix-net \
     --restart unless-stopped \
     -d mysql:8.0-oracle \
     --character-set-server=utf8 --collation-server=utf8_bin \
     --default-authentication-plugin=mysql_native_password

3. Start een Zabbix Java Gateway-instantie:

   docker run --name zabbix-java-gateway -t \

     --network=zabbix-net \
     --restart unless-stopped \
     -d zabbix/zabbix-java-gateway:alpine-6.4-latest

4. Start een Zabbix-serverinstantie en koppel de instantie aan de gemaakte MySQL-serverinstantie:

   docker run --name zabbix-server-mysql -t \

     -e DB_SERVER_HOST="mysql-server" \
     -e MYSQL_DATABASE="zabbix" \
     -e MYSQL_USER="zabbix" \
     -e MYSQL_PASSWORD="zabbix_pwd" \
     -e MYSQL_ROOT_PASSWORD="root_pwd" \
     -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \
     --network=zabbix-net \
     -p 10051:10051 \
     --restart unless-stopped \
     -d zabbix/zabbix-server-mysql:alpine-6.4-latest

5. Start de Zabbix-webinterface en koppel de instantie aan de gemaakte MySQL-server- en Zabbix-serverinstanties:

   docker run --name zabbix-web-nginx-mysql -t \

     -e ZBX_SERVER_HOST="zabbix-server-mysql" \
     -e DB_SERVER_HOST="mysql-server" \
     -e MYSQL_DATABASE="zabbix" \
     -e MYSQL_USER="zabbix" \
     -e MYSQL_PASSWORD="zabbix_pwd" \
     -e MYSQL_ROOT_PASSWORD="root_pwd" \
     --network=zabbix-net \
     -p 80:8080 \
     --restart unless-stopped \
     -d zabbix/zabbix-web-nginx-mysql:alpine-6.4-latest

Voorbeeld 2

Dit voorbeeld laat zien hoe je Zabbix-server met PostgreSQL-databaseondersteuning, de Zabbix-webinterface gebaseerd op de Nginx-webserver en SNMP-trapfunctionaliteit kunt uitvoeren.

1. Maak een netwerk aan dat is toegewijd aan containers voor Zabbix-componenten:

   docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net

2. Start een lege PostgreSQL-serverinstantie:

   docker run --name postgres-server -t \

     -e POSTGRES_USER="zabbix" \
     -e POSTGRES_PASSWORD="zabbix_pwd" \
     -e POSTGRES_DB="zabbix" \
     --network=zabbix-net \
     --restart unless-stopped \
     -d postgres:latest

3. Start een Zabbix snmptraps-instantie:

   docker run --name zabbix-snmptraps -t \

     -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \
     -v /var/lib/zabbix/mibs:/usr/share/snmp/mibs:ro \
     --network=zabbix-net \
     -p 162:1162/udp \
     --restart unless-stopped \
     -d zabbix/zabbix-snmptraps:alpine-6.4-latest

4. Start een Zabbix-serverinstantie en koppel de instantie aan de gemaakte PostgreSQL-serverinstantie:

   docker run --name zabbix-server-pgsql -t \

     -e DB_SERVER_HOST="postgres-server" \
     -e POSTGRES_USER="zabbix" \
     -e POSTGRES_PASSWORD="zabbix_pwd" \
     -e POSTGRES_DB="zabbix" \
     -e ZBX_ENABLE_SNMP_TRAPS="true" \
     --network=zabbix-net \
     -p 10051:10051 \
     --volumes-from zabbix-snmptraps \
     --restart unless-stopped \
     -d zabbix/zabbix-server-pgsql:alpine-6.4-latest

5. Start de Zabbix-webinterface en koppel de instantie aan de gemaakte PostgreSQL-server- en Zabbix-serverinstanties:

   docker run --name zabbix-web-nginx-pgsql -t \

     -e ZBX_SERVER_HOST="zabbix-server-pgsql" \
     -e DB_SERVER_HOST="postgres-server" \
     -e POSTGRES_USER="zabbix" \
     -e POSTGRES_PASSWORD="zabbix_pwd" \
     -e POSTGRES_DB="zabbix" \
     --network=zabbix-net \
     -p 443:8443 \
     -p 80:8080 \
     -v /etc/ssl/nginx:/etc/ssl/nginx:ro \
     --restart unless-stopped \
     -d zabbix/zabbix-web-nginx-pgsql:alpine-6.4-latest

Voorbeeld 3

Dit voorbeeld laat zien hoe je Zabbix-server met MySQL-databaseondersteuning, de Zabbix-webinterface gebaseerd op de Nginx-webserver en de Zabbix Java Gateway kunt uitvoeren met podman op Red Hat 8.

1. Maak een nieuwe pod met de naam zabbix en open poorten (webinterface, Zabbix-server trapper):

   podman pod create --name zabbix -p 80:8080 -p 10051:10051

2. (optioneel) Start de Zabbix-agentcontainer op de locatie van de zabbix-pod:

   podman run --name zabbix-agent
   -e ZBX_SERVER_HOST="127.0.0.1,localhost"
   --restart=always
   --pod=zabbix
   -d registry.connect.redhat.com/zabbix/zabbix-agent-64:latest

3. Maak de ./mysql/-directory aan op de host

   en start Oracle MySQL-server 8.0:

   podman run --name mysql-server -t
   -e MYSQL_DATABASE="zabbix"
   -e MYSQL_USER="zabbix"
   -e MYSQL_PASSWORD="zabbix_pwd"
   -e MYSQL_ROOT_PASSWORD="root_pwd"
   -v ./mysql/:/var/lib/mysql/:Z
   --restart=always
   --pod=zabbix
   -d mysql:8.0
   --character-set-server=utf8 --collation-server=utf8_bin
   --default-authentication-plugin=mysql_native_password

4. Start de Zabbix-servercontainer:

   podman run --name zabbix-server-mysql -t
   -e DB_SERVER_HOST="127.0.0.1"
   -e MYSQL_DATABASE="zabbix"
   -e MYSQL_USER="zabbix"
   -e MYSQL_PASSWORD="zabbix_pwd"
   -e MYSQL_ROOT_PASSWORD="root_pwd"
   -e ZBX_JAVAGATEWAY="127.0.0.1"
   --restart=always
   --pod=zabbix
   -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-64

5. Start de Zabbix Java Gateway-container:

   podman run --name zabbix-java-gateway -t
   --restart=always
   --pod=zabbix
   -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-64

6. Start de Zabbix-webinterface-container:

   podman run --name zabbix-web-mysql -t
   -e ZBX_SERVER_HOST="127.0.0.1"
   -e DB_SERVER_HOST="127.0.0.1"
   -e MYSQL_DATABASE="zabbix"
   -e MYSQL_USER="zabbix"
   -e MYSQL_PASSWORD="zabbix_pwd"
   -e MYSQL_ROOT_PASSWORD="root_pwd"
   --restart=always
   --pod=zabbix
   -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-64

Docker Compose

Als alternatief kan Zabbix worden geïnstalleerd met behulp van de Docker Compose-plugin. Samenstellingsbestanden voor het definiëren en uitvoeren van Zabbix-componenten in meerdere containers zijn beschikbaar in de officiële Zabbix Docker-repository op GitHub.

Deze samenstellingsbestanden zijn toegevoegd als voorbeelden; ze zijn overlappend. Zo bevatten ze proxies met zowel MySQL- als SQLite3-ondersteuning.

Om Docker Compose-bestanden van Zabbix te verkrijgen, kloon je de repository:

git clone https://github.com/zabbix/zabbix-docker.git

Schakel over naar de gewenste versie:

git checkout 6.4

Configureer samenstellingsbestanden, maak containers aan en start ze:

docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up

Vervang docker-compose_v3_alpine_mysql_latest.yaml in het bovenstaande commando door het gewenste configuratiebestand.

De volgende opties zijn beschikbaar:

Opslag

Compose-bestanden zijn geconfigureerd om lokale opslag op een hostmachine te ondersteunen. Docker Compose zal een zbx_env-map aanmaken in de map met het compose-bestand wanneer je Zabbix-componenten uitvoert met behulp van het compose-bestand. De map zal dezelfde structuur bevatten als beschreven in de Volumes-sectie en de map voor database-opslag.

Er zijn ook volumes in alleen-lezen modus voor de bestanden /etc/localtime en /etc/timezone.

Omgevingsvariabelen

De variabele bestanden hebben de volgende naamstructuur: .env_<type component> en bevinden zich in de env_vars map. Zie omgevingsvariabelen voor details over de benaming van variabelen en de beschikbare selecties.

Voorbeelden

Voorbeeld 1

# git checkout 6.4
# docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d

Deze opdracht zal de nieuwste Zabbix 6.4-images downloaden voor elk Zabbix-component en ze in detach-modus uitvoeren.

Voorbeeld 2

# git checkout 6.4
# docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d

Deze opdracht zal het basisbeeld Ubuntu 22.04 (jammy) downloaden, vervolgens Zabbix 6.4-componenten lokaal bouwen en ze in detach-modus uitvoeren.