5 Instalación desde contenedores

Descripción general

Esta sección describe cómo implementar 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 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 de 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 con 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 de 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 el Java gateway 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.0-oracle \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

3. Iniciar la instancia del Java gateway 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. 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-7.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-7.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 SNMP trap.

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 snmptraps de Zabbix:

docker run --name zabbix-snmptraps -t \
             -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \
             --network=zabbix-net \
             -p 162:1162/udp \
             --restart unless-stopped \
             -d zabbix/zabbix-snmptraps:alpine-7.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-7.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-7.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 el Java gateway 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 agent de 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.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. 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 del Java Gateway 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

Como alternativa, Zabbix puede instalarse utilizando el plugin Docker Compose. Los archivos Compose para definir y ejecutar componentes Zabbix multi-contenedor 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 7.0

Configure los archivos de configuración 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 de composición están configurados para admitir el almacenamiento local en una máquina anfitriona. Docker Compose creará un directorio zbx_env en la carpeta con el archivo de composición cuando ejecuta los componentes de Zabbix usando el archivo de composición. El directorio contendrá la misma estructura que la descrita anteriormente en la Sección Volúmenes y el directorio para el almacenamiento de la base de datos.

También hay 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 las variables y la selección disponible.

Ejemplos

Ejemplo 1

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

El comando descargará las últimas imágenes de Zabbix 7.0 para cada componente de Zabbix y las ejecutará en modo detach.

Ejemplo 2

git checkout 7.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 7.0 localmente y los ejecutará en modo detach.