5 Installatie vanuit containers

Docker

Zabbix biedt Docker images voor elk Zabbix component als draagbare en zelfstandige containers om de implementatie en updateprocedure te versnellen.

Zabbix componenten worden geleverd met ondersteuning voor MySQL en PostgreSQL databases, evenals ondersteuning voor Apache2 en Nginx webservers. Deze images zijn opgedeeld in verschillende containers.

Docker basisimages

Zabbix componenten worden geleverd op basis van Ubuntu, Alpine Linux en CentOS basisimages:

Alle images zijn geconfigureerd om de nieuwste images opnieuw op te bouwen als de basisimages worden bijgewerkt.

Docker bestandbronnen

Iedereen kan Docker-bestandswijzigingen volgen via de officiële repository van Zabbix op github.com. Je kunt het project forkken of je eigen images maken op basis van de officiële Docker-bestanden.

Structuur

Alle Zabbix-componenten zijn beschikbaar in de volgende Docker-repositories:

• Zabbix-agent - zabbix/zabbix-agent
• Zabbix-server
  • Zabbix-server met ondersteuning voor MySQL-database - zabbix/zabbix-server-mysql
  • Zabbix-server met ondersteuning voor PostgreSQL-database - zabbix/zabbix-server-pgsql
• Zabbix-webinterface
  • Zabbix-webinterface gebaseerd op Apache2-webserver met ondersteuning voor MySQL-database - zabbix/zabbix-web-apache-mysql
  • Zabbix-webinterface gebaseerd op Apache2-webserver met ondersteuning voor PostgreSQL-database - zabbix/zabbix-web-apache-pgsql
  • Zabbix-webinterface gebaseerd op Nginx-webserver met ondersteuning voor MySQL-database - zabbix/zabbix-web-nginx-mysql
  • Zabbix-webinterface gebaseerd op Nginx-webserver met ondersteuning voor PostgreSQL-database - zabbix/zabbix-web-nginx-pgsql
• Zabbix-proxy
  • Zabbix-proxy met ondersteuning voor SQLite3-database - zabbix/zabbix-proxy-sqlite3
  • Zabbix-proxy met ondersteuning voor MySQL-database - zabbix/zabbix-proxy-mysql
• Zabbix Java Gateway - zabbix/zabbix-java-gateway

Daarnaast is er ondersteuning voor SNMP-traps. Dit wordt geleverd als een extra repository (zabbix/zabbix-snmptraps) alleen gebaseerd op Ubuntu Trusty. Het kan worden gekoppeld aan Zabbix-server en Zabbix-proxy.

Versies

Elke repository van Zabbix-componenten bevat de volgende tags:

• latest - de nieuwste stabiele versie van een Zabbix-component gebaseerd op de Alpine Linux-image
• alpine-latest - de nieuwste stabiele versie van een Zabbix-component gebaseerd op de Alpine Linux-image
• ubuntu-latest - de nieuwste stabiele versie van een Zabbix-component gebaseerd op de Ubuntu-image
• alpine-6.0-latest - de nieuwste kleine versie van een Zabbix 6.0-component gebaseerd op de Alpine Linux-image
• ubuntu-6.0-latest - de nieuwste kleine versie van een Zabbix 6.0-component gebaseerd op de Ubuntu-image
• alpine-6.0.* - verschillende kleine versies van een Zabbix 6.0-component gebaseerd op de Alpine Linux-image, waarbij * staat voor de kleine versie van het Zabbix-component
• ubuntu-6.0.* - verschillende kleine versies van een Zabbix 6.0-component gebaseerd op de Ubuntu-image, waarbij * staat voor de kleine versie van het Zabbix-component

Initial configuration

After downloading the images, start the containers by executing docker run command followed by additional arguments to specify required environment variables and/or mount points. Some configuration examples are provided below.

Omgevingsvariabelen

Alle Zabbix-componentimages bieden omgevingsvariabelen om de configuratie te beheren. Deze omgevingsvariabelen worden vermeld in elke componentrepository. Deze omgevingsvariabelen zijn opties uit de Zabbix-configuratiebestanden, maar met een andere benaming. Bijvoorbeeld, ZBX_LOGSLOWQUERIES komt overeen met LogSlowQueries in de configuratiebestanden van Zabbix-server en Zabbix-proxy.

Sommige componenten hebben specifieke omgevingsvariabelen die niet bestaan in de officiële Zabbix-configuratiebestanden:

Volumes

De images bieden de mogelijkheid om enkele koppelingspunten te gebruiken. Deze koppelingspunten verschillen en zijn afhankelijk van het type Zabbix-component:

Voor aanvullende informatie kunt u de officiële Zabbix-repositories op Docker Hub gebruiken.

Deze voorbeelden laten zien hoe je Zabbix-server en gerelateerde componenten kunt draaien in Docker- of Podman-containers.

Voorbeeld 1: Zabbix-server met MySQL-database, Zabbix-webinterface en Zabbix Java-gateway.

1. Maak een toegewijd netwerk voor Zabbix-componentcontainers:

   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 \
                --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.0-latest

4. Start een Zabbix-serverinstantie en koppel deze 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.0-latest

5. Start een Zabbix-webinterface en koppel deze 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.0-latest

Voorbeeld 2: Zabbix-server met PostgreSQL-database, Zabbix-webinterface en SNMP-trapfunctionaliteit.

1. Maak een toegewijd netwerk voor Zabbix-componentcontainers:

   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.0-latest

4. Start een Zabbix-serverinstantie en koppel deze 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.0-latest

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

   ```bash 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.0-latest ```

Voorbeeld 3: Zabbix-server met MySQL-database, Zabbix-webinterface en Zabbix Java-gateway met Podman op Red Hat 8.

1. Maak een nieuwe pod met de naam zabbix en de blootgestelde 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-60:latest

3. Maak een ./mysql/-map 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-60

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-60

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-60

In deze voorbeelden wordt het gebruik van Docker en Podman gedemonstreerd om Zabbix-server en gerelateerde componenten te starten met verschillende database-opties en functionaliteiten. Volg de instructies voor het gewenste scenario om Zabbix in te stellen en te draaien.

Zabbix provides Docker Compose files for defining and running multi-container Zabbix components in Docker. These Compose files are available in the Zabbix Docker official repository on GitHub: https://github.com/zabbix/zabbix-docker. These files are provided as examples and serve as a starting point for setting up Zabbix components using Docker Compose. Different versions of the Compose files are available to support various configurations.

Here's a list of the available Docker Compose files along with their descriptions:

• docker-compose_v3_alpine_mysql_latest.yaml: Runs the latest version of Zabbix 6.0 components on Alpine Linux with MySQL database support.
• docker-compose_v3_alpine_mysql_local.yaml: Locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Alpine Linux with MySQL database support.
• docker-compose_v3_alpine_pgsql_latest.yaml: Runs the latest version of Zabbix 6.0 components on Alpine Linux with PostgreSQL database support.
• docker-compose_v3_alpine_pgsql_local.yaml: Locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Alpine Linux with PostgreSQL database support.
• docker-compose_v3_centos_mysql_latest.yaml: Runs the latest version of Zabbix 6.0 components on CentOS 8 with MySQL database support.
• docker-compose_v3_centos_mysql_local.yaml: Locally builds the latest version of Zabbix 6.0 and runs Zabbix components on CentOS 8 with MySQL database support.
• docker-compose_v3_centos_pgsql_latest.yaml: Runs the latest version of Zabbix 6.0 components on CentOS 8 with PostgreSQL database support.
• docker-compose_v3_centos_pgsql_local.yaml: Locally builds the latest version of Zabbix 6.0 and runs Zabbix components on CentOS 8 with PostgreSQL database support.
• docker-compose_v3_ubuntu_mysql_latest.yaml: Runs the latest version of Zabbix 6.0 components on Ubuntu 20.04 with MySQL database support.
• docker-compose_v3_ubuntu_mysql_local.yaml: Locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Ubuntu 20.04 with MySQL database support.
• docker-compose_v3_ubuntu_pgsql_latest.yaml: Runs the latest version of Zabbix 6.0 components on Ubuntu 20.04 with PostgreSQL database support.
• docker-compose_v3_ubuntu_pgsql_local.yaml: Locally builds the latest version of Zabbix 6.0 and runs Zabbix components on Ubuntu 20.04 with PostgreSQL database support.

It's important to note that these Docker Compose files are designed to work with version 3 of Docker Compose. You can use these files as a starting point and customize them according to your specific needs and configurations.

Opslag

Compose-bestanden zijn geconfigureerd om lokale opslag op een hostmachine te ondersteunen. Docker Compose maakt een zbx_env-map aan 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 hierboven 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.

Omgevingsbestanden

In dezelfde map met compose-bestanden op github.com kun je bestanden vinden met standaardomgevingsvariabelen voor elk component in het compose-bestand. Deze omgevingsbestanden hebben namen zoals .env_<type van component>.

Voorbeelden

Voorbeeld 1

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

Dit commando zal de nieuwste Zabbix 6.0-images downloaden voor elk Zabbix-component en ze in de detach-modus uitvoeren.

Voorbeeld 2

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

Dit commando zal de basisafbeelding Ubuntu 20.04 (focal) downloaden, vervolgens lokaal Zabbix 6.0-componenten bouwen en ze in de detach-modus uitvoeren.