5 Instal·lació des de contenidors

Descripció general

Aquesta pàgina descriu com implementar Zabbix utilitzant Docker o Docker Compose.

Docker Compose és la manera més ràpida d'implementar Zabbix. Es llegeix un arxiu de configuració i automàticament s'inicia tots els contenidors que componen una configuració completa Zabbix, en l'ordre correcte.

Desplegament manual de Docker aconsegueix el mateix resultat desplegant cada component passa a passa.

::: nota important Des de Zabbix 6.0, cal crear desencadenants deterministes durant la instal·lació. Si el registre binari està habilitat per a MySQL/MariaDB, això requereix privilegis de superusuari o establir el paràmetre de variable/configuració log_bin_trust_function_creators = 1. Vegeu Scripts de creació de base de dades per obtenir instruccions sobre com establir la variable.

Tingueu en compte que si s'executa des d'una consola, la variable només s'establirà temporalment i es deixarà caure quan es reiniciï un acoblador. En aquest cas, mantingueu el vostre servei SQL en funcionament, només atureu el servei zabbix-server executant docker compose down zabbix-server i després docker compose up -d zabbix-server.

Alternativament, podeu establir aquesta variable al fitxer de configuració. ::

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.

Estructura

Tots els components de Zabbix són disponibles als següents repositoris Docker:

A més, hi ha suport per a trampes SNMP. Es proporciona com a repositori addicional (zabbix/zabbix-snmptraps) basat només en Ubuntu Trusty. Es pot enllaçar al servidor Zabbix i al proxy Zabbix.

Etiquetes d'imatge

Cada imatge admet etiquetes per triar el sistema operatiu base i la versió de Zabbix:

``default zabbix/<image>:<os>-<versió>


Valors suportats `<os>`:

- 'alpine' - Alpine Linux
- `ubuntu` - Ubuntu
- `centos` - Corrent CentOS
- `ol` - Oracle Linux
- `ltsc2022` - Windows 11 LTSC 2022 (només agent de Zabbix)

Valors suportats `<version>`:

- `latest' - Darrera versió estable de Zabbix a Alpine Linux
- `<os>-latest` - Darrera versió estable de Zabbix en el sistema operatiu seleccionat
- `<os>-trunk` - Darrer desenvolupament (per nit) construir sobre el sistema operatiu seleccionat
- `<os>-X.X-latest` - Darrera versió menor de Zabbix d'una versió principal específica de Zabbix en el sistema operatiu seleccionat
- `<os>-X.X. *` - Versió menor específica de Zabbix en el sistema operatiu seleccionat

Exemples:

``bash
# Darrer proxy estable de Zabbix (SQLite3) a Linux Alpine:
docker pull zabbix/zabbix-proxy-sqlite3: últim

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

# Darrer desenvolupament (nit) construcció del servidor Zabbix (MySQL) en Ubuntu:
docker pull zabbix/zabbix-server-mysql:ubuntu-trunk

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

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

Docker compose

Docker Compose és la manera més ràpida de desplegar Zabbix. Llegeix un fitxer de configuració (composeu un fitxer) i gestiona tota la configuració: estireu les imatges de l'acoblador, creeu una xarxa interna entre contenidors, configureu l'emmagatzematge, inicialitzeu la base de dades i inicieu-ho tot en l'ordre correcte.

El repositori oficial Zabbix Dockerfiles proporciona fitxers Docker Compose preparats per utilitzar i un sistema de configuració basat en .env que suporta diferents sistemes operatius, backends de bases de dades i configuració de components de Zabbix.

1. Cloneu el repositori, navegueu-hi i canvieu a la versió 6.0:

``bash git clone https://github.com/zabbix/zabbix-docker.git cd zabbix-docker git checkout 6.0


2\. (Opcional) Personalitzar el desplegament amb [variables d'entorn](#environment-variables).
Aquesta passa es pot saltar per a una configuració per defecte.

3\. Desplegueu la configuració per defecte: servidor Zabbix, interfície web (executant a Nginx) i un backend de base de dades (MySQL o PostgreSQL), cadascun executant-se en el seu propi contenidor a Alpine Linux.

``bash
# 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

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.

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 s'ensenya alguna Sortida, comproveu els seus registres amb acoblador 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.

Compose-level variables (definit en el fitxer .env) controlen quins rangs de Docker imatges, ports i xarxa IP 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):

``bash 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>`](https://github.com/zabbix/zabbix-docker/blob/6.0/env_vars/)) 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:

``·lícia
# env_vars/.env_srv
ZBX_STARTPOLLERS=20
ZBX_CACHESIZE=64M
ZBX_HISTORYCACHESIZE = 32M

# env_vars/.env_web
PHP_TZ=Europa/París

Les variables d'entorn de nivell de component corresponen a paràmetres de configuració de components de Zabbix utilitzant un estil de denominació diferent (per exemple, ZBX_STARTPOLLERS correspon a StartPollers. Algunes variables són específiques de Docker, i alguns paràmetres de configuració no es poden canviar (per exemple, 'PIDFileiLogType`). Quan utilitzeu variables d'entorn, consulteu la secció Variables de medi ambient a la descripció de cada component Imatge de l'acoblador a Docker Hub. ::

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:

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):

# Implementació per defecte (servidor Zabbix, interfície web, MySQL, tot a Alpine Linux)
make up

# Implementació personalitzada (servidor Zabbix, interfície web 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

Quan s'aturen o s'esborren contenidors, especifiqueu sempre el mateix tipus de base de dades que s'ha desplegat (per exemple, fer baixar DB=pgsql).

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 ser necessaris. Per incloure components addicionals, podeu utilitzar els següents Perfils de composició:

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

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

Docker (desplegament manual)

Utilitzeu la implementació manual quan vulgueu implementar Zabbix pas a pas, 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 de 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 \
  -d \
  zabbix/zabbix-proxy-sqlite3:alpine-6.0-latest

Zabbix no s'ha d'executar com a procés PID1/init a contenidors.

Aquesta ordre:

  • Tira de la zabbix/zabbix-proxy-sqlite3:alpine-6.0-latst Imatge de l'acoblador.

  • Crea i inicia un contenidor zabbix-proxy-sqlite3 basat en la imatge de l'acoblador (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 servidor intermediari 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.

Les variables d'entorn corresponen a paràmetres de configuració de components de Zabbix utilitzant un estil de denominació diferent (per exemple, ZBX_SERVER_HOST correspon a Server). Algunes variables són específiques de Docker, i alguns paràmetres de configuració no es poden canviar (per exemple, 'PIDFileiLogType`). Quan utilitzeu variables d'entorn, consulteu la secció Variables de medi ambient a la descripció de cada component Imatge de l'acoblador a Docker Hub. ::

  • Connecta una ubicació d'emmagatzematge gestionada per Docker (per exemple, /var/lib/docker/volumes/zabbix-proxy-data/) al directori /var/lib/zabbix del contenidor de manera que les dades del proxy de Zabbix s'emmagatzemen permanentment, fins i tot si el contenidor s'esborra.

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

Després de desplegar el contenidor de proxy de Zabbix, podeu procedir a afegir el servidor intermediari al vostre frontend de Zabbix i configurar equips per ser monitoritzat 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 MySQL, una passarel·la Java per a monitorar JMX i una interfície web basada en Nginx.

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

``bash xarxa docker create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net


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

```bash
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=utf8mb4 --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 --default-authentication-plugin=mysql_native_password per --authentication-policy=caching_sha2_password.

MySQL ha d'estar completament inicialitzat abans d'executar el contenidor del servidor Zabbix en el pas 4, en cas contrari l'esquema de Zabbix pot no carregar-se correctament. Per confirmar que MySQL és a punt, executeu docker logs mysql-server i procediu només quan veieu /usr/sbin/mysqld: llest per a connexions. ::

3. Executeu un contenidor de passarel·la de Java de Zabbix:

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

4. Executeu un contenidor de servidor Zabbix i enllaceu-lo al contenidor del servidor MySQL (substituïu zabbix_pwd i root_pwd amb els mateixos mots de pas emprats a 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-6.0-latest

::: nota important Després d'executar el contenidor del servidor Zabbix, espereu que el servidor Zabbix acabi d'inicialitzar l'esquema de la base de dades. Per confirmar que és a punt, executeu docker logs zabbix-server-mysql i procediu només quan ja no veieu 'Creant d'esquema 'zabbix' a MySQL `. ::

5. Executeu un contenidor d'interfície web de Zabbix i enllaceu amb el servidor Zabbix i els contenidors del servidor MySQL (substituïu zabbix_pwd i root_pwd per els mateixos mots de pas emprats a 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-6.0-latest

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

Desplegar el servidor Zabbix (PostgreSQL) amb trampes SNMP

Aquest exemple ensenya com implementar un servidor Zabbix amb un dorsal PostgreSQL, snMP traps i una interfície web basada en Nginx.

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

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


2\. Executeu un contenidor de servidor PostgreSQL buit (substituïu `zabbix_pwd` amb un mot de pas segur):

```bash
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. Executeu un contenidor de trampes SNMP de Zabbix:

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.0-latest

4. Executeu un contenidor de servidor Zabbix, enllaceu-lo al contenidor del servidor PostgreSQL i al contenidor de trampes SNMP (substituïu zabbix_pwd amb el mateix mot de pas emprat a la passa 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-6.0-latest

::: nota important Després d'executar el contenidor del servidor Zabbix, espereu que el servidor Zabbix acabi d'inicialitzar l'esquema de la base de dades. Per confirmar que està llest, executar docker logs zabbix-server-pgsql i procedir només quan ja no vegi Creant l'esquema 'zabbix' a PostgreSQL. ::

5. Executeu un contenidor d'interfície web de Zabbix i enllaceu-lo amb el servidor Zabbix i els contenidors del servidor PostgreSQL (substituïu `zabbix_pwd`` per el mateix mot de pas emprat 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-6.0-latest

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

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

Aquest exemple mostra 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 a 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'executa com a arrel, el que fa que sigui un millor ajust per als entorns de Red Hat.

1. Creeu un nou pod amb el nom zabbix i ports exposats per a la interfície web de Zabbix i el trap del servidor Zabbix:

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


2\. (Opcional) Executar un contenidor d'agent Zabbix a la ubicació de la beina `zabbix`:

```bash
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-6.0:latest

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

``bash mkdir -p ./mysql


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

```bash
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=utf8mb4 --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 --default-authentication-plugin=mysql_native_password per --authentication-policy=caching_sha2_password.

MySQL ha de ser engegat del tot abans d'executar el contenidor del servidor Zabbix a la passa 6; en cas contrari l'esquema de Zabbix podria no carregar correctament. Per confirmar que MySQL és llest, executar podman logs mysql-server i procedir només quan veieu /usr/sbin/mysqld: llest per a connexions. ::

5. Executeu un contenidor de passarel·la de Java de Zabbix:

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

6. Executeu un contenidor del servidor Zabbix (substituïu zabbix_pwd i root_pwd amb els mateixos mots de pas emprats a la passa 4):

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

7. Executeu un contenidor d'interfície web de Zabbix (substituïu zabbix_pwd i root_pwd amb els mateixos mots de pas emprats 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-60

Pod zabbix exposa 80/TCP port (HTTP) a l'equip de 8080/TCP del contenidor zabbix-web-mysql.