5 Installation depuis les containers

Docker

Zabbix fourni des images Docker pour chaque composant Zabbix en tant que conteneurs portables et auto-suffisants pour accélérer le déploiement et mettre à jour la procédure.

Les composants Zabbix sont fournis avec la prise en charge de base de données MySQL et PostgreSQL, le support des serveurs web Apache2 et Nginx. Ces images sont séparées en différentes images.

Images de base Docker

Les composants Zabbix sont fournis sur les images de base Ubuntu, Alpine Linux et CentOS :

Toutes les images sont configurées pour reconstruire les dernières images si les images de base sont mises à jour.

Sources des fichiers Docker

Tout le monde peut suivre les modifications du fichier Docker en utilisant le dépôt officiel de Zabbix sur github.com. Vous pouvez faire un fork du projet ou créer vos propres images basées sur les fichiers Docker officiels.

Structure

Tous les composants Zabbix sont disponibles dans les dépôt Docker suivants :

• Appliance Zabbix avec prise en charge de base de données MySQL et serveur Web Nginx - zabbix/zabbix-appliance
• Agent Zabbix - zabbix/zabbix-agent
• Zabbix server
  • Serveur Zabbix avec prise en charge de base de données MySQL - zabbix/zabbix-server-mysql
  • Serveur Zabbix avec prise en charge de base de données PostgreSQL - zabbix/zabbix-server-pgsql
• Interface Web Zabbix
  • Interface Web Zabbix basée sur un serveur web Apache2 avec prise en charge de base de données MySQL - zabbix/zabbix-web-apache-mysql
  • Interface Web Zabbix basée sur un serveur web Apache2 avec prise en charge de base de données PostgreSQL - zabbix/zabbix-web-apache-pgsql
  • Interface Web Zabbix basée sur un serveur web Nginx avec prise en charge de base de données MySQL - zabbix/zabbix-web-nginx-mysql
  • Interface Web Zabbix basée sur un serveur web Nginx avec prise en charge de base de données PostgreSQL - zabbix/zabbix-web-nginx-pgsql
• Proxy Zabbix
  • Proxy Zabbix avec prise en charge de base de données SQLite3 - zabbix/zabbix-proxy-sqlite3
  • Proxy Zabbix avec prise en charge de base de données MySQL - zabbix/zabbix-proxy-mysql
• Passerelle Java Zabbix - zabbix/zabbix-java-gateway

De plus, il existe une prise en charge des traps SNMP. Il est fourni en tant que dépôt supplémentaire (zabbix/zabbix-snmptraps) basé uniquement sur Ubuntu Trusty. Il peut être lié au serveur Zabbix et au proxy Zabbix.

Versions

Chaque dépôt de composants Zabbix contient les étiquettes suivantes :

• latest - dernière version stable d'un composant Zabbix basé sur l'image Linux Alpine.
• alpine-latest - dernière version stable d'un composant Zabbix basé sur l'image Linux Alpine.
• ubuntu-latest - dernière version stable d'un composant Zabbix basé sur l'image Ubuntu
• alpine-4.0-latest - dernière version mineure d'un composant Zabbix 4.0 basé sur l'image Linux Alpine
• ubuntu-4.0-latest - dernière version mineure d'un composant Zabbix 4.0 basé sur l'image Ubuntu
• alpine-4.0.* - différentes versions mineures d'un composant Zabbix 4.0 basé sur l'image Linux Alpine, où * est la version mineure du composant Zabbix
• ubuntu-4.0.* - différentes versions mineures d'un composant Zabbix 4.0 basé sur l'image Linux Alpine, où * est la version mineure du composant Zabbix

Utilisation

Variables d'environnement

Toutes les images des composants Zabbix fournissent des variables d'environnement pour contrôler la configuration. Ces variables d'environnement sont répertoriées dans chaque dépôt de composants. Ces variables d'environnement sont des options des fichiers de configuration Zabbix, mais avec une méthode de nommage différente. Par exemple, ZBX_LOGSLOWQUERIES est égal à LogSlowQueries des fichiers de configuration du serveur Zabbix et des proxys Zabbix.

Certains composants ont des variables d'environnement spécifiques, qui n'existent pas dans les fichiers de configuration officiels de Zabbix :

Volumes

Les images permettent d'utiliser certains points de montage. Ces points de montage sont différents et dépendent du type de composant Zabbix :

Pour plus d'informations, utilisez les dépôts officiels de Zabbix dans Docker Hub.

Exemples d'utilisation

** Exemple 1 **

L'exemple démontre comment exécuter une appliance Zabbix construite avec une base de données MySQL, un serveur Zabbix, une interface Web Zabbix basée sur une serveur web Nginx et une passerelle Java Zabbix.

# docker run --name zabbix-appliance -t \
             -p 10051:10051 \
             -p 80:80 \
             -d zabbix/zabbix-appliance:latest

** Exemple 2 **

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

1. Démarrez une instance de serveur MySQL vide

# 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" \
             -d mysql:5.7 \
             --character-set-server=utf8 --collation-server=utf8_bin

2. Démarrez l'instance de passerelle Java Zabbix

# docker run --name zabbix-java-gateway -t \
             -d zabbix/zabbix-java-gateway:latest

3. Démarrez l'instance de serveur Zabbix et liez la à l'instance de 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" \
             --link mysql-server:mysql \
             --link zabbix-java-gateway:zabbix-java-gateway \
             -p 10051:10051 \
             -d zabbix/zabbix-server-mysql:latest

4. Lancez l'interface Web de Zabbix et liez l'instance avec le serveur MySQL créé et les instances de serveur Zabbix

# docker run --name zabbix-web-nginx-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" \
             --link mysql-server:mysql \
             --link zabbix-server-mysql:zabbix-server \
             -p 80:80 \
             -d zabbix/zabbix-web-nginx-mysql:latest

** Exemple 3 **

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

1. Démarrez l'instance de serveur PostgreSQL vide

# docker run --name postgres-server -t \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix" \
             -e POSTGRES_DB="zabbix_pwd" \
             -d postgres:latest

2. Démarrez l'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 \
             -p 162:162/udp \
             -d zabbix/zabbix-snmptraps:latest

3. Démarrez l'instance de serveur Zabbix et liez la à l'instance de 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" \
             -e POSTGRES_DB="zabbix_pwd" \
             -e ZBX_ENABLE_SNMP_TRAPS="true" \
             --link postgres-server:postgres \
             -p 10051:10051 \
             --volumes-from zabbix-snmptraps \
             -d zabbix/zabbix-server-pgsql:latest

4. Démarrez l'interface Web de Zabbix et liez l'instance avec le serveur PostgreSQL créé et les instances de serveur Zabbix.

# docker run --name zabbix-web-nginx-pgsql -t \
             -e DB_SERVER_HOST="postgres-server" \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix" \
             -e POSTGRES_DB="zabbix_pwd" \
             --link postgres-server:postgres \
             --link zabbix-server-pgsql:zabbix-server \
             -p 443:443 \
             -v /etc/ssl/nginx:/etc/ssl/nginx:ro \
             -d zabbix/zabbix-web-nginx-pgsql:latest

Docker Compose

Zabbix fournit également des fichiers compose pour définir et exécuter des composants Zabbix multi-conteneurs dans Docker. Ces fichiers compose sont disponibles dans le dépôt officiel Zabbix-docker sur github.com: https://github.com/zabbix/zabbix-docker. Ces fichiers compose sont ajoutés à titre d'exemples, ils sont surchargés. Par exemple, ils contiennent des proxys avec la prise en charge MySQL et SQLite3.

Il existe quelques différentes versions des fichiers compose :

Stockage

Les fichiers compose sont configurés pour prendre en charge le stockage local sur une machine hôte. Docker Compose crée un répertoire zbx_env dans le dossier contenant le fichier compose lorsque vous exécutez des composants Zabbix à l'aide du fichier compose. Le répertoire contiendra la même structure que celle décrite ci-dessus dans la section Volumes et le répertoire de stockage de la base de données.

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

Fichiers d’environnement

Dans le même répertoire avec les fichiers compose sur github.com vous pouvez trouver des fichiers avec des variables d'environnement par défaut pour chaque composant dans le fichier compose. Ces fichiers d'environnement sont nommés comme .env_<type de composant>.

Exemples

** Exemple 1 **

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

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

** Exemple 2 **

# docker-compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d

La commande téléchargera l'image de base Ubuntu 14.04, puis construira localement les composants de Zabbix 4.0 et les exécutera en mode détaché.