5 Instal·lació des de contenidors

Vista general

Aquesta secció descriu com implementar Zabbix amb Docker o Docker Compose.

Zabbix ofereix oficialment:

• Imatges Docker separades per a cada component de Zabbix per funcionar com a contenidors portàtils i autosuficients.
• Redactar fitxers per definir i executar components de Zabbix multicontenidor a Docker.

Font dels arxius Docker

Hom pot fer un seguiment dels canvis dels fitxers de Docker mitjançant el [repositori oficial] de Zabbix (https://github.com/zabbix/zabbix-docker) a GitHub, on podeu seguir els carrers canvid d'arius o bifurcar el projecte per crear les vostres pròpies imatges.

Docker

Zabbix proporciona imatges basades en una varietat d'imatge base de SO. Per obtindre la llista d'imatges del sistema operatiu base compatibles per a un component Zabbix específic, consulteu la descripció del component a Docker Hub. Totes les imatges de Zabbix són configurades per reconstruir les darreres imatges si s'actualitzen les imatges base.

Instal·lació

Per obtindre la imatge del component Zabbix, executeu:

 docker pull zabbix/zabbix-server-mysql

Substituïu zabbix/zabbix-server-mysql pel nom del repositori docker necessari.

Aquesta ordre extreu la darrera versió estable del component Zabbix basada en el sistema operatiu Linux Alpine. Podeu afegir etiquetes al nom del repositori per obtindre una imatge basada en un altre sistema operatiu o en la versió principal o secundaria específica de Zabbix.

Els dipòsits següents són disponibles a Docker Hub:

Etiquetes

Les imatges oficials dels components de Zabbix poden contindre les etiquetes següents:

Configuració inicial

Després de descarregar les imatges, inicieu els contenidors executant l'ordre docker run seguida d'arguments addicionals per especificar variables d'entorn (#variables-d'entorn) i/o [punts de muntatge] (#volums). A continuació es proporcionen alguns exemples de configuració.

Variables d'entorn

Totes les imatges de components de Zabbix proporcionen variables d'entorn per controlar la configuració. Aquestes variables d'entorn s'enumeren a cada repositori de components.

Aquestes variables d'entorn són opcions dels fitxers de configuració de Zabbix, però amb un mètode de denominació diferent. Per exemple, ZBX_LOGSLOWQUERIES és igual a LogSlowQueries dels fitxers de configuració del servidor Zabbix i proxy Zabbix.

Les següents variables d'entorn són específiques de components de Docker i no existeixen als fitxers de configuració oficials de Zabbix:

Volums

Les imatges permeten emprar determinats punts de muntatge. Aquests punts de muntatge són diferents i depenen del tipus de component Zabbix:

Per obtindre més informació, veieu els dipòsits oficials de Zabbix a Docker Hub.

Exemples d'ús

Exemple 1

L'exemple mostra com executar el servidor Zabbix amb suport de bases de dades MySQL, la interfície web Zabbix basada en el servidor web Nginx i la passarel·la Java Zabbix.

1. Creeu una xarxa dedicada als contenidors de components Zabbix:

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

2. Inicieu la instància del servidor MySQL buida

# 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. Inicieu la instància de passarel·la Java de Zabbix

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

4. Inicieu la instància del servidor Zabbix i enllaceu la instància amb la instància del servidor MySQL creada

# 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. Inicieu la interfície web de Zabbix i enllaçeu la instància amb el servidor MySQL creat i les instàncies del servidor Zabbix

# 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

Exemple 2

L'exemple ensenya com executar el servidor Zabbix amb suport de bases de dades PostgreSQL, la interfície web Zabbix basada en el servidor web Nginx i la funció de trampa SNMP.

1. Creeu una xarxa dedicada als contenidors de components Zabbix:

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

2. Inicieu la instància del servidor PostgreSQL buida

# 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. Inicieu la instància 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-6.4-latest

4. Inicieu la instància del servidor Zabbix i enllaceu la instància amb la instància del servidor PostgreSQL creada

# 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. Inicieu la interfície web de Zabbix i enllaceu la instància amb el servidor PostgreSQL creat i les instàncies del servidor Zabbix

# 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

Exemple 3

L'exemple mostra com executar el servidor Zabbix amb suport de bases de dades MySQL, basat en la interfície web de Zabbix al servidor web Nginx i a la passarel·la Zabbix Java emprant "podman" a Red Hat 8.

1. Creeu un pod nou amb el nom "zabbix" i els ports exposats (interfície web, trapper del servidor Zabbix):

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

2. (opcional) Inicieu el contenidor de l'agent Zabbix a la ubicació del 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-64:latest

3. Creeu el directori ./mysql/ a l'equip i inicieu el servidor Oracle MySQL 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. Inicieu el contenidor del servidor 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-64

5. Inicieu el contenidor Zabbix Java Gateway:

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

6. Inicieu el contenidor de la interfície 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-64

Composició Docker

Zabbix també proporciona fitxers de composició per definir i executar components Zabbix multicontenidor a Docker. Aquests fitxers de redacció són disponibles al dipòsit oficial de docker de Zabbix a GitHub

Aquests fitxers de composició s'afegeixen com a exemples, es substitueixen. Per exemple, contenen proxys que admeten MySQL i SQLite3.

Per obtindre els arxius Compose de Docker, cloneu el repositori:

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

Canvieu a la versió que us calgui:

git checkout 6.4

Compose els arxius de configuració i creeu i inicieu els contenidors:

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

Canvieu docker-compose_v3_alpine_mysql_latest.yaml a la comanda d'amunt amb l'arxiu de configuració necessari.

Les opcions següents són disponibles:

Emmagatzematge

Els fitxers de redacció són configurats per admetre l'emmagatzematge local a un equip. Docker Compose crearà un directori zbx_env a la carpeta amb el fitxer de composició quan executeu components Zabbix amb el fitxer de composició. El directori contindrà la mateixa estructura que la descrita a la secció Volums i el directori per emmagatzemar la base de dades.

També hi ha volums de només lectura per als fitxers /etc/localtime i /etc/timezone.

Variables d'entorn

Els fitxers de variables tenen la següent estructura de noms: .env_<tipus de component> i es troben al [directori] env_vars (https://github.com/zabbix/zabbix-docker/tree/6.4/env_vars) . Veieu variables d'entorn per obtindre més informació sobre la denominació de variables i la selecció disponible.

Exemples

Exemple 1

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

L'ordre descarregarà les darreres imatges de Zabbix 6.4 per a cada component Zabbix i les executarà en mode de separació.

Exemple 2

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

L'ordre descarregarà la imatge base Ubuntu 22.04 (jammy), després crearà components de Zabbix 6.4 localment i els executarà en mode de separació.