5 Instalación desde contenedores

Descripción general

Esta sección describe cómo desplegar Zabbix con Docker o Docker Compose.

Zabbix proporciona oficialmente:

• Imágenes Docker separadas para cada componente de Zabbix para ejecutarse como contenedores portátiles y autosuficientes.
• Archivos Compose para definir y ejecutar componentes de Zabbix de múltiples contenedores en Docker.

Archivos fuente

Los archivos fuente de Docker se almacenan en el repositorio oficial de Zabbix en GitHub, donde puede seguir los últimos cambios en los archivos o bifurcar el proyecto para crear sus propias imágenes.

Docker

Zabbix proporciona imágenes basadas en una variedad de imágenes base de sistemas operativos. Para obtener la lista de imágenes de sistemas operativos base soportadas para un componente específico de Zabbix, consulte la descripción del componente en Docker Hub. Todas las imágenes de Zabbix están configuradas para reconstruir las imágenes más recientes si se actualizan las imágenes base.

Instalación

Para obtener la imagen de un componente de Zabbix, ejecute:

docker pull zabbix/zabbix-server-mysql

Reemplace zabbix/zabbix-server-mysql por el nombre del repositorio docker requerido.

Este comando descargará la última versión estable del componente Zabbix basada en el sistema operativo Alpine Linux. Puede añadir etiquetas al nombre del repositorio para obtener una imagen basada en otro sistema operativo o de una versión mayor o menor específica de Zabbix.

Los siguientes repositorios están disponibles en Docker Hub:

Etiquetas

Las imágenes oficiales de los componentes de Zabbix pueden contener las siguientes etiquetas:

Configuración inicial

Después de descargar las imágenes, inicie los contenedores ejecutando el comando docker run seguido de argumentos adicionales para especificar las variables de entorno y/o puntos de montaje requeridos. A continuación se proporcionan algunos ejemplos de configuración.

Variables de entorno

Todas las imágenes de los componentes de Zabbix proporcionan variables de entorno para controlar la configuración. Las variables de entorno compatibles se enumeran en el repositorio del componente.

Estas variables de entorno son opciones de los archivos de configuración de Zabbix, pero con un método de nomenclatura diferente. Por ejemplo, ZBX_LOGSLOWQUERIES es igual a LogSlowQueries de los archivos de configuración de Zabbix server o Zabbix proxy.

Las siguientes variables de entorno son específicas de los componentes Docker y no existen en los archivos de configuración de Zabbix:

Volúmenes

Las imágenes permiten montar volúmenes utilizando los siguientes puntos de montaje:

Para información adicional, consulte los repositorios oficiales de Zabbix en Docker Hub.

Ejemplos

Ejemplo 1

El ejemplo demuestra cómo ejecutar el servidor Zabbix con soporte para base de datos MySQL, la interfaz web de Zabbix basada en el servidor web Nginx y la pasarela Java de Zabbix.

1. Crear una red dedicada para los contenedores de los componentes de Zabbix:

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

2. Iniciar una instancia vacía del servidor MySQL:

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.4-oracle \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=caching_sha2_password

3. Iniciar la instancia de la pasarela Java de Zabbix:

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

4. Iniciar la instancia del servidor Zabbix y vincular la instancia con la instancia 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-8.0-latest

5. Iniciar la interfaz web de Zabbix y vincular la instancia con las instancias del servidor MySQL y del servidor Zabbix creadas:

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

Ejemplo 2

El ejemplo demuestra cómo ejecutar el servidor Zabbix con soporte para base de datos PostgreSQL, la interfaz web de Zabbix basada en el servidor web Nginx y la funcionalidad de trampa SNMP.

1. Crear una red dedicada para los contenedores de los componentes de Zabbix:

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

2. Iniciar una instancia vacía del servidor PostgreSQL:

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. Iniciar la instancia de 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-8.0-latest

4. Iniciar la instancia del servidor Zabbix y vincular la instancia con la instancia 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-8.0-latest

5. Iniciar la interfaz web de Zabbix y vincular la instancia con las instancias del servidor PostgreSQL y del servidor Zabbix creadas:

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

Ejemplo 3

El ejemplo demuestra cómo ejecutar el servidor Zabbix con soporte para base de datos MySQL, la interfaz web de Zabbix basada en el servidor web Nginx y la pasarela Java de Zabbix usando podman en Red Hat 8.

1. Crear un nuevo pod con el nombre zabbix y los puertos expuestos (interfaz web, trapper del servidor Zabbix):

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

2. (opcional) Iniciar el contenedor del agente Zabbix en la ubicación 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. Crear el directorio ./mysql/ en el host e iniciar el servidor Oracle MySQL 8.4:

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.4 \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=caching_sha2_password

4. Iniciar el contenedor 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-70

5. Iniciar el contenedor de la pasarela Java de Zabbix:

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

6. Iniciar el contenedor de la interfaz web de 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-70

Docker Compose

Alternativamente, Zabbix puede instalarse utilizando el plugin Docker Compose. Los archivos Compose para definir y ejecutar componentes Zabbix de múltiples contenedores están disponibles en el repositorio oficial de Zabbix Docker en GitHub.

Estos archivos compose se añaden como ejemplos; están sobrecargados. Por ejemplo, contienen proxies con soporte tanto para MySQL como para SQLite3.

Para obtener los archivos Docker compose proporcionados por Zabbix, clone el repositorio:

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

Cambie a la versión requerida:

git checkout 8.0

Configure los archivos de configuración de Compose y cree e inicie los contenedores:

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

Reemplace docker-compose_v3_alpine_mysql_latest.yaml en el comando anterior por el archivo de configuración requerido.

Las siguientes opciones están disponibles:

Almacenamiento

Los archivos Compose están configurados para admitir almacenamiento local en una máquina equipo. Docker Compose creará un directorio zbx_env en la carpeta donde se encuentra el archivo compose cuando ejecute los componentes de Zabbix utilizando el archivo compose. El directorio contendrá la misma estructura que se describe en la sección Volúmenes y un directorio para el almacenamiento de la base de datos.

También existen volúmenes en modo de solo lectura para los archivos /etc/localtime y /etc/timezone.

Variables de entorno

Los archivos de variables tienen la siguiente estructura de nombres: .env_<tipo de componente> y se encuentran en el directorio env_vars. Consulte variables de entorno para obtener detalles sobre la nomenclatura de variables y la selección disponible.

Ejemplos

Ejemplo 1

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

El comando descargará las imágenes más recientes de Zabbix 8.0 para cada componente de Zabbix y las ejecutará en modo desacoplado.

Ejemplo 2

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

El comando descargará la imagen base Ubuntu 24.04 (noble), luego construirá los componentes de Zabbix 8.0 localmente y los ejecutará en modo desacoplado.