Installation à partir de conteneurs

Aperçu

Cette section décrit comment déployer Zabbix avec Docker ou Docker Compose.

Zabbix fournit officiellement :

• Des images Docker distinctes pour chaque composant Zabbix afin de les exécuter comme des conteneurs portables et autonomes.
• Des fichiers Compose pour définir et exécuter des composants Zabbix multi-conteneurs dans Docker.

Fichiers source

Les sources des fichiers Docker sont stockées dans le dépôt officiel de Zabbix sur GitHub, où vous pouvez suivre les dernières modifications des fichiers ou bifurquer le projet pour créer vos propres images.

Docker

Zabbix fournit des images basées sur une variété d’images de base de systèmes d’exploitation. Pour obtenir la liste des images de base de systèmes d’exploitation prises en charge pour un composant Zabbix spécifique, consultez la description du composant sur Docker Hub. Toutes les images Zabbix sont configurées pour reconstruire les dernières images si les images de base sont mises à jour.

Installation

Pour obtenir l’image d’un composant Zabbix, exécutez :

docker pull zabbix/zabbix-server-mysql

Remplacez zabbix/zabbix-server-mysql par le nom du dépôt Docker requis.

Cette commande récupérera la dernière version stable du composant Zabbix basée sur le système d’exploitation Alpine Linux. Vous pouvez ajouter des tags au nom du dépôt pour obtenir une image basée sur un autre système d’exploitation ou sur une version majeure ou mineure spécifique de Zabbix.

Les dépôts suivants sont disponibles sur Docker Hub :

Tags

Les images officielles des composants Zabbix peuvent contenir les tags suivants :

Configuration initiale

Après avoir téléchargé les images, démarrez les conteneurs en exécutant la commande docker run, suivie d’arguments supplémentaires pour spécifier les variables d’environnement et/ou les points de montage requis. Quelques exemples de configuration sont fournis ci-dessous.

Variables d'environnement

Toutes les images des composants Zabbix fournissent des variables d'environnement pour contrôler la configuration. Les variables d'environnement prises en charge sont répertoriées dans le dépôt du composant.

Ces variables d'environnement correspondent à des options des fichiers de configuration Zabbix, mais avec une méthode de nommage différente. Par exemple, ZBX_LOGSLOWQUERIES est équivalent à LogSlowQueries dans les fichiers de configuration du server Zabbix ou du proxy Zabbix.

Les variables d'environnement suivantes sont spécifiques aux composants Docker et n'existent pas dans les fichiers de configuration Zabbix :

Volumes

Les images permettent de monter des volumes en utilisant les points de montage suivants :

Pour plus d’informations, consultez les dépôts officiels Zabbix dans Docker Hub.

Exemples

Exemple 1

Cet exemple montre comment exécuter le serveur Zabbix avec la prise en charge de la base de données MySQL, l'interface web Zabbix basée sur le serveur web Nginx et le Java gateway Zabbix.

1. Créez un réseau dédié aux conteneurs des composants Zabbix :

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

2. Démarrez une instance vide du serveur MySQL :

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.4-oracle \
    --character-set-server=utf8 --collation-server=utf8_bin \
    --default-authentication-plugin=caching_sha2_password

3. Démarrez une instance du Java gateway Zabbix :

docker run --name zabbix-java-gateway -t \
    --network=zabbix-net \
    --restart unless-stopped \
    -d zabbix/zabbix-java-gateway:alpine-8.0-latest

4. Démarrez une instance du serveur Zabbix et liez-la à l'instance du serveur MySQL créée :

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-8.0-latest

5. Démarrez l'interface web Zabbix et liez-la aux instances du serveur MySQL et du serveur Zabbix créées :

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-8.0-latest

Exemple 2

Cet exemple montre comment exécuter le serveur Zabbix avec la prise en charge de la base de données PostgreSQL, l'interface web Zabbix basée sur le serveur web Nginx et la fonctionnalité de traps SNMP.

1. Créez un réseau dédié aux conteneurs des composants Zabbix :

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

2. Démarrez une instance vide du serveur PostgreSQL :

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. Démarrez une instance Zabbix snmptraps :

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-8.0-latest

4. Démarrez une instance du serveur Zabbix et liez-la à l'instance du serveur PostgreSQL créée :

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-8.0-latest

5. Démarrez l'interface web Zabbix et liez-la aux instances du serveur PostgreSQL et du serveur Zabbix créées :

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-8.0-latest

Exemple 3

Cet exemple montre comment exécuter le serveur Zabbix avec la prise en charge de la base de données MySQL, l'interface web Zabbix basée sur le serveur web Nginx et le Java gateway Zabbix en utilisant podman sur Red Hat 8.

1. Créez un nouveau pod nommé zabbix avec les ports exposés (interface web, trapper du serveur Zabbix) :

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

2. (facultatif) Démarrez le conteneur de l'agent Zabbix à l'emplacement du pod zabbix :

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-74:latest

3. Créez le répertoire ./mysql/ sur l'hôte et démarrez Oracle MySQL server 8.4 :

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.4 \
    --character-set-server=utf8 --collation-server=utf8_bin \
    --default-authentication-plugin=caching_sha2_password

4. Démarrez le conteneur du serveur Zabbix :

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

5. Démarrez le conteneur Java Gateway Zabbix :

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

6. Démarrez le conteneur de l'interface web Zabbix :

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

Docker Compose

Il est également possible d’installer Zabbix à l’aide du plugin Docker Compose. Les fichiers Compose permettant de définir et d’exécuter des composants Zabbix multi-conteneurs sont disponibles dans le dépôt Docker officiel de Zabbix sur GitHub.

Ces fichiers Compose sont fournis à titre d’exemple ; ils sont surchargés. Par exemple, ils contiennent des proxys avec prise en charge à la fois de MySQL et de SQLite3.

Pour obtenir les fichiers Docker Compose fournis par Zabbix, clonez le dépôt :

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

Basculez vers la version requise :

git checkout 8.0

Configurez les fichiers Compose, puis créez et démarrez les conteneurs :

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

Remplacez docker-compose_v3_alpine_mysql_latest.yaml dans la commande ci-dessus par le fichier de configuration requis.

Les options suivantes sont disponibles :

Stockage

Les fichiers Compose sont configurés pour prendre en charge le stockage local sur une machine hôte. Docker Compose créera un répertoire zbx_env dans le dossier contenant le fichier compose lorsque vous exécuterez les composants Zabbix à l’aide du fichier compose. Le répertoire contiendra la même structure que celle décrite dans la section Volumes, ainsi qu’un répertoire pour le stockage de la base de données.

Il existe également des volumes en mode lecture seule pour les fichiers /etc/localtime et /etc/timezone.

Variables d'environnement

Les fichiers de variables ont la structure de nommage suivante : .env_<type de composant> et sont situés dans le répertoire env_vars. Consultez les variables d'environnement pour plus de détails sur le nommage des variables et la sélection disponible.

Exemples

Exemple 1

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

La commande téléchargera les dernières images Zabbix 8.0 pour chaque composant Zabbix et les exécutera en mode détaché.

Exemple 2

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

La commande téléchargera l'image de base Ubuntu 24.04 (noble), puis construira localement les composants Zabbix 8.0 et les exécutera en mode détaché.