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.

Requisits previs

Abans de començar, assegureu-vos que Docker (1.12.0 o posterior) sigui instal·lat al vostre sistema. Si no ho és, seguiu la Guia d'instal·lació Docker. Per a la implementació de Docker Compose, Docker Compose (2.24.0 o posterior) també és necessari.

Alguns components de Zabbix requereixen que els ports específics estiguin oberts a l'equip que executa Docker (per exemple, 10051/TCP per al servidor Zabbix, 162/UDP per a trampes SNMP). Veieu els Requisits per a una llista sencera dels ports utilitzats pels components de Zabbix. Per al servidor i l'agent de Zabbix, el port predeterminat es pot canviar establint la variable d'entorn ZBX_LISTENPORT al contenidor respectiu.

Imatges disponibles de l'acoblador

Zabbix proporciona una imatge Docker per a cada component de Zabbix, tot publicat a Docker Hub. Cada imatge s'utilitza per crear un contenidor que executa aquest component.

zabbix/<image>:<os>-<version>

# Darrer proxy estable de Zabbix (SQLite3) a Linux Alpine:
docker pull zabbix/zabbix-proxy-sqlite3:latest

# Darrer proxy estable de Zabbix (SQLite3) a Ubuntu:
docker pull zabbix/zabbix-proxy-sqlite3:ubuntu-latest

# Darrer desenvolupament (nocturn) fet sobre el servidor Zabbix (MySQL) a Ubuntu:
docker pull zabbix/zabbix-server-mysql:ubuntu-trunk

# Darrera versió menor de la 7.0 del servidor Zabbix (MySQL) a Alpine Linux:
docker pull zabbix/zabbix-server-mysql:alpine-7.0-latest

# Versió 7.0.1 del servidor Zabbix (MySQL) a Alpine Linux:
docker pull zabbix/zabbix-server-mysql:alpine-7.0.1

git clone https://github.com/zabbix/zabbix-docker.git
cd zabbix-docker
git checkout 7.0

# Amb MySQL com a base de dades:
docker compose -f ./compose.yaml up -d

# Amb PostgreSQL com a base de dades:
docker compose -f ./compose_pgsql.yaml up -d

Utilitzeu docker compose ps per comprovar l'estat del contenidor. Tots els contenidors (excepte el contenidor zabbix-docker-server-db-init-1) haurien de tenir l'estat Up. Si algun mostra Exit, comproveu els seus registres amb docker logs <container-name>. :::

Variables d'entorn

El comportament de Docker Compose i la configuració del component Zabbix es poden personalitzar mitjançant variables d'entorn.

Variables a nivell de composició (definits en el fitxer .env) controlen quins rangs d'imatges, ports i IP de xarxa d'acoblador s'utilitzen. Podeu utilitzar aquestes variables en línia abans de l'ordre docker compose, o editar el fitxer .env.

Per exemple, l'ordre següent desplega una configuració completa de Zabbix multi-contenidor utilitzant una imatge basada en Ubuntu (en lloc de la Linux Alpine per defecte) i exposant la interfície web a través de Nginx en ports HTTP (8282) i HTTPS (8443):

OS=ubuntu \
ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \
docker compose -f ./compose.yaml up -d

Variables a nivell de component (definits en els fitxers env_vars/.env_<component>) controlen la configuració del component Zabbix. Editeu el fitxer respectiu .env_<component> abans d'executar l'ordre docker compose.

Per exemple, podeu ajustar el recompte de sondejos passius del servidor Zabbix i la configuració de la memòria cau, així com configurar la zona horària de la interfície web editant les variables següents:

# env_vars/.env_srv
ZBX_STARTPOLLERS=20
ZBX_CACHESIZE=64M
ZBX_HISTORYCACHESIZE=32M

# env_vars/.env_web
PHP_TZ=Europe/Paris

Volums

Docker Compose emmagatzema dades persistents en el directori zbx_env/ creat juntament amb el fitxer Compose. Aquest directori conserva les dades dels components a través de reinicis i actualitzacions de contenidors.

El contingut de zbx_env/ està predefinit per a la imatge de cada component. Per exemple:

• zbx_env/etc/ - utilitzat pel Contenidor d'interfície web de Zabbix
• zbx_env/usr/ i zbx_env/var/ - utilitzat pel Contenidor del servidor Zabbix

Per obtenir més informació sobre cada volum, vegeu la secció Permès volums a la descripció de cada component Imatge de Docker a Docker Hub.

Makefile

El repositori Zabbix Dockerfiles també proporciona un Makefile com a drecera per a tasques comunes de Docker Compose. En lloc d'utilitzar l'ordre completa 'docker compose', podeu utilitzar ordres make més curtes (executa make help per veure les opcions disponibles):

# Desplegament per defecte (Zabbix server, web interface, MySQL, tot a Alpine Linux)
make up

# Desplegament a mida (Zabbix server, web interface amb ports Nginx personalitzats, PostgreSQL, tot a Ubuntu)
make up \
  OS=ubuntu \
  DB=pgsql \
  ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
  ZABBIX_WEB_NGINX_HTTPS_PORT=8443

Per defecte, make up comença només un conjunt mínim de serveis (servidor Zabbix, interfície web, i la base de dades). Això manté la configuració lleugera i evita els components d'inici que poden no caldre. Per incloure components addicionals, podeu utilitzar el següent perfil de Compose:

# Desplegament per defecte + Zabbix agent, Java gateway, web service, i trampes SNMP:
make up COMPOSE_PROFILES=full

# COMPOSE_PROFILES=tots + Zabbix proxy (MySQL i SQLite3):
make up COMPOSE_PROFILES=all

Docker (desplegament manual)

Utilitzeu la implementació manual quan vulgueu implementar Zabbix passa a passa, executar components individuals, integrar-los amb un entorn existent o utilitzar un temps d'execució de contenidors alternatiu com Podman.

Per exemple, per desplegar un proxy Zabbix, executeu l'ordre següent:

docker run --name zabbix-proxy-sqlite3 \
  -e ZBX_SERVER_HOST=192.0.2.0 \
  -e ZBX_PROXYMODE=0 \
  -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
  -v zabbix-proxy-data:/var/lib/zabbix/db_data \
  --init \
  -d \
  zabbix/zabbix-proxy-sqlite3:alpine-7.0-lateste

::: Nota important Zabbix (7.0.0-7.0.2) no s'ha d'executar com a procés PID1/init als contenidors. ::

Aquesta comanda:

• Tira de la Imatge de Docker zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest.

• Crea i inicia un contenidor zabbix-proxy-sqlite3 basat en la imatge de Docker (amb --init i -d.

• Configura el paràmetre Zabbix proxy Server mitjançant la variable d'entorn ZBX_SERVER_HOST. Aquest paràmetre especifica l'adreça IP del servidor Zabbix des del qual el proxy recuperarà les dades de configuració i a la qual enviarà dades recollides. Tingueu en compte que altres variables necessàries per a l'operació de proxy actiu utilitzen valors per defecte i es poden ometre.

Per obtindre més informació sobre cada volum, vegeu la secció Volums permesos a la descripció de cada component Imatge de l'acoblador a Docker Hub. ::

Després de desplegar el contenidor de proxy de Zabbix, podeu procedir a afegir el proxy a la vostra interfície de Zabbix i configurar equips per ser monitorats per aquest proxy.

Els exemples següents cobreixen tres escenaris de desplegament addicionals:

• Servidor Zabbix (MySQL) amb passarel·la Java
• Servidor Zabbix (PostgreSQL) amb trampes SNMP
• Servidor Zabbix (MySQL) amb passarel·la Java a RHEL 8

Per a més exemples, consulteu la descripció de cada component Docker image a Docker Hub.

Implementar el servidor Zabbix (MySQL) amb la passarel·la Java

Aquest exemple mostra com implementar un servidor Zabbix amb un backend MySQL, una passarel·la Java per a JMX monitoring i una interfície web basada en Nginx.

1. Creeu una xarxa dedicada als contenidors de components Zabbix, de manera que tots els contenidors de components de Zabbix puguin arribar entre si pel nom del contenidor:

    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 (canvieu zabbix_pwd i root_pwd amb paraules de pas segures):

    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=utf8mb4_bin \
          --default-authentication-plugin=mysql_native_password

3. Engegueu 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-7.0-latest

4. Engegueu la instància del servidor Zabbix i enllaceu la instància amb la instància del servidor MySQL creada (canvieu zabbix_pwd i root_pwd amb les mateixes paraules de pas de la passa 2):

    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-7.0-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 (canvieu zabbix_pwd i root_pwd amb les mateixes paraules de pas de la passa 2):

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

Després que els contenidors siguin engegats (normalment en 1-3 minuts), s'engega el servidor Zabbix i la interfície web és disponible a http://localhost.

Desplegament del servidor Zabbix (PostgreSQL) amb trampes SNMP

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. Engegueu la instància del servidor PostgreSQL buida (canvieu zabbix_pwd per un mot de pas segur):

    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. engegueu la instància del servidor Zabbix i enllaceu la instància amb la instància del servidor PostgreSQL creada (canvieu zabbix_pwd amb la mateixa paraula de pas que heu emprat al punt 2):

    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-7.0-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 (canvieu zabbix_pwd amb la mateixa paraula de pas emprada a la passa 2):

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

Després que els contenidors siguin engegats (normalment en 1-3 minuts), s'engega el servidor Zabbix i la interfície web és disponible a http://localhost.

Implementar el servidor Zabbix (MySQL) amb la passarel·la Java a RHEL 8-10

Aquest exemple ensenya com implementar un servidor Zabbix amb un dorsal MySQL, una passarel·la Java per a monitoratge JMX, i una interfície web basada en Nginx, tot executant-se en Red Hat Enterprise Linux 8, 9, o 10.

A Red Hat Enterprise Linux, el temps d'execució del contenidor recomanat és Podman en lloc de Docker. Podman funciona de manera similar a Docker, però no requereix un servei de fons que s'executi com a root, cosa que ho fa més adaptable per als entorns de Red Hat.

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

3. Creeu el directori ./mysql/ a l'equip RHEL:

mkdir -p ./mysql

4. Executeu un contenidor de servidor MySQL buit (substituïu zabbix_pwd i root_pwd per mots de pas segurs):

    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=utf8mb4_bin \
          --default-authentication-plugin=mysql_native_password

::: Nota important Si utilitzeu una imatge Docker per a MySQL 8.4 o posterior, substituïu --per defecte-autenticació-plugin=mysql_native_password amb ---autenticació-policy=caching_sha2_password.

MySQL ha d'estar totalment engegat abans d'executar el contenidor del servidor Zabbix al pas 6, en cas contrari, l'esquema de Zabbix no carregarà pas correctament. Per confirmar MySQL és a punt, executeu podman logs mysql-server i procediu només quan veieu /usr/sbin/mysqld: llest per a connexions. :::

5. Engegueu 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-70

6. Engegueu el contenidor del servidor de Zabbix (substituïu zabbix_pwd i root_pwd per els mateixos mots de pas establerts a la passa 4):

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

7. Executeu el contenidor de la interfície web de Zabbix (substituïu zabbix_pwd i root_pwd per els mateixos mots de pas establerts a la passa 4):

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