Áú»¢¶Ä²©

5 ±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨® des de contenidors

Vista general

Aquesta secci¨® descriu com implementar Áú»¢¶Ä²© amb Docker o Docker Compose.

Áú»¢¶Ä²© ofereix oficialment:

• Imatges Docker separades per a cada component de Áú»¢¶Ä²© per funcionar com a contenidors port¨¤tils i autosuficients.
• Redactar fitxers per definir i executar components de Áú»¢¶Ä²© multicontenidor a Docker.

Font dels arxius Docker

Hom pot fer un seguiment dels canvis dels fitxers de Docker mitjan?ant el [repositori oficial] de Áú»¢¶Ä²© (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

Áú»¢¶Ä²© 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 Áú»¢¶Ä²© espec¨ªfic, consulteu la descripci¨® del component a . Totes les imatges de Áú»¢¶Ä²© s¨®n configurades per reconstruir les darreres imatges si s'actualitzen les imatges base.

±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨®

Per obtindre la imatge del component Áú»¢¶Ä²©, 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²©.

Els dip¨°sits seg¨¹ents s¨®n disponibles a Docker Hub:

Etiquetes

Les imatges oficials dels components de Áú»¢¶Ä²© poden contindre les etiquetes seg¨¹ents:

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²©, per¨° amb un m¨¨tode de denominaci¨® diferent. Per exemple, ZBX_LOGSLOWQUERIES ¨¦s igual a LogSlowQueries dels fitxers de configuraci¨® del servidor Áú»¢¶Ä²© o proxy Áú»¢¶Ä²©.

Les seg¨¹ents variables d'entorn s¨®n espec¨ªfiques de components de Docker i no existeixen als fitxers de configuraci¨® oficials de Áú»¢¶Ä²©:

Volums

Les imatges permeten emprar determinats punts de muntatge. Aquests punts de muntatge s¨®n diferents i depenen del tipus de component Áú»¢¶Ä²©:

Per obtindre m¨¦s informaci¨®, veieu els dip¨°sits oficials de Áú»¢¶Ä²© a Docker Hub.

Exemples

Exemple 1

L'exemple mostra com executar el servidor Áú»¢¶Ä²© amb suport de bases de dades MySQL, la interf¨ªcie web Áú»¢¶Ä²© basada en el servidor web Nginx i la passarel¡¤la Java Áú»¢¶Ä²©.

1. Creeu una xarxa dedicada als contenidors de components Áú»¢¶Ä²©:

# 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 Áú»¢¶Ä²©

# 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© i enlla?eu la inst¨¤ncia amb el servidor MySQL creat i les inst¨¤ncies del servidor Áú»¢¶Ä²©

# 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 Áú»¢¶Ä²© amb suport de bases de dades PostgreSQL, la interf¨ªcie web Áú»¢¶Ä²© basada en el servidor web Nginx i la funci¨® de trampa SNMP.

1. Creeu una xarxa dedicada als contenidors de components Áú»¢¶Ä²©:

# 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© i enllaceu la inst¨¤ncia amb el servidor PostgreSQL creat i les inst¨¤ncies del servidor Áú»¢¶Ä²©

# 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 Áú»¢¶Ä²© amb suport de bases de dades MySQL, basat en la interf¨ªcie web de Áú»¢¶Ä²© al servidor web Nginx i a la passarel¡¤la Áú»¢¶Ä²© 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 Áú»¢¶Ä²©):

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

2. (opcional) Inicieu el contenidor de l'agent Áú»¢¶Ä²© 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 Áú»¢¶Ä²©:

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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²©:

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

Áú»¢¶Ä²© tamb¨¦ proporciona fitxers de composici¨® per definir i executar components Áú»¢¶Ä²© multicontenidor a Docker. Aquests fitxers de redacci¨® s¨®n disponibles al 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 7.0

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 Áú»¢¶Ä²© 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/trunk/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 7.2
        docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d

L'ordre descarregar¨¤ les darreres imatges de Áú»¢¶Ä²© 7.2 per a cada component Áú»¢¶Ä²© i les executar¨¤ en mode de separaci¨®.

Exemple 2

 git checkout 7.0
        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 Áú»¢¶Ä²© 7.2 localment i els executar¨¤ en mode de separaci¨®.