5 Instalación desde contenedores

Docker

Zabbix proporciona imágenes Docker para cada componente de Zabbix como contenedores portátiles y autosuficientes para acelerar el proceso de despliegue y actualización.

Los componentes de Zabbix vienen con soporte para bases de datos MySQL y PostgreSQL, así como soporte de servidor web Apache2 y Nginx. Estas imágenes se separan en imágenes diferentes

Imágenes base de Docker

Los componentes de Zabbix se proporcionan en las imágenes base de Ubuntu, Alpine Linux y CentOS:

Todas las imágenes están configuradas para reconstruir las últimas imágenes si las imágenes base son actualizadas.

Fuentes de archivos Docker

Todos pueden seguir los cambios del archivo Docker usando el [repositorio oficial] de Zabbix (https://github.com/zabbix/zabbix-docker) en github.com. Puedes bifurcar el proyecto o hacer tu imágenes propias basadas en archivos oficiales de Docker.

Estructura

Todos los componentes de Zabbix están disponibles en los siguientes repositorios Docker:

• Agente Zabbix - zabbix/agente-zabbix
• Servidor Zabbix
  • Servidor Zabbix con soporte de base de datos MySQL - zabbix/zabbix-servidor-mysql
  • Servidor Zabbix con soporte de base de datos PostgreSQL - zabbix/zabbix-servidor-pgsql
• Interfaz web Zabbix
  • Interfaz web Zabbix basada en el servidor web Apache2 con MySQL soporte de base de datos - zabbix/zabbix-web-apache-mysql
  • Interfaz web Zabbix basada en servidor web Apache2 con PostgreSQL soporte de base de datos - zabbix/zabbix-web-apache-pgsql
  • Interfaz web Zabbix basada en el servidor web Nginx con MySQL soporte de base de datos - zabbix/zabbix-web-nginx-mysql
  • Interfaz web Zabbix basada en el servidor web Nginx con PostgreSQL soporte de base de datos - zabbix/zabbix-web-nginx-pgsql
• Proxy de Zabbix
  • Proxy Zabbix con soporte de base de datos SQLite3 - zabbix/zabbix-proxy-sqlite3
  • Proxy Zabbix con soporte de base de datos MySQL - zabbix/zabbix-proxy-mysql
• Java Gateway de Zabbix- zabbix/zabbix-java-gateway

Además, hay compatibilidad con las capturas SNMP. Se proporciona como repositorio adicional (zabbix/zabbix-snmptraps) basado únicamente en Ubuntu Trusty. Podría estar vinculado con el servidor Zabbix y Proxy de Zabbix.

Versiones

Cada repositorio de componentes de Zabbix contiene las siguientes etiquetas:

• latest: última versión estable de un componente Zabbix basado en Imagen de Alpine Linux
• alpine-latest: última versión estable de un componente Zabbix basado en la imagen de Alpine Linux
• ubuntu-latest: última versión estable de un componente Zabbix basado en la imagen de Ubuntu
• alpine-6.0-latest: última versión menor de un componente Zabbix 6.0 basado en la imagen de Alpine Linux
• ubuntu-6.0-latest: última versión menor de un componente Zabbix 6.0 basado en la imagen de Ubuntu
• alpine-6.0.* - diferentes versiones menores de un componente Zabbix 6.0 basado en la imagen de Alpine Linux, donde * es la versión menor del componente Zabbix
• ubuntu-6.0.* - diferentes versiones menores de un componente Zabbix 6.0 basado en la imagen de Ubuntu, donde * es la versión menor del componente Zabbix

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 los puntos de montaje requeridos. A continuación, se proporcionan algunos ejemplos de configuración.

Variables de entorno

Todas las imágenes de componentes de Zabbix proporcionan variables de entorno para controlar la configuración. Estas variables de entorno se enumeran en cada repositorio de componentes. Estas variables de entorno son opciones de los archivos de configuración de Zabbix, pero con un método de denominación diferente. Por ejemplo, ZBX_LOGSLOWQUERIES es igual a LogSlowQueries de los archivos de configuración del servidor Zabbix y del proxy de Zabbix.

Algunos componentes tienen variables de entorno específicas, que no existen en los archivos de configuración oficiales de Zabbix:

Volúmenes

Las imágenes permiten utilizar algunos puntos de montaje. Estos puntos de montaje son diferentes y dependen del tipo de componente de Zabbix:

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

Ejemplos

** Ejemplo 1 **

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

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

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

2. Iniciar la 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 \
             -d mysql:8.0 \
             --restart unless-stopped \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

3. Iniciar la instancia Java gateway de Zabbix

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

4. Iniciar la instancia del servidor Zabbix y enlazar con la instancia creada del servidor MySQL

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

5. Iniciar la interfaz web de Zabbix y enlazar la instancias creadas del servidor MySQL y del servidor Zabbix.

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

** Ejemplo 2 **

El ejemplo demuestra cómo ejecutar el servidor Zabbix con soporte a la base de datos PostgreSQL, interfaz web de Zabbix basada en el servidor web Nginx y características de captura SNMP.

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

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

2. Iniciar la 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 snmptraps 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-5.4-latest

4. Iniciar la instancia del servidor Zabbix y enlazar con la instancia creada del servidor PostgreSQL

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

5. Iniciar la interfaz web de Zabbix y enlazar la instancias creadas del servidor PostgreSQL y del servidor Zabbix

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

** Ejemplo 3 **

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

1. Crear un nuevo pod llamado zabbix y exponer los puertos (interfaz web, servidor de captura Zabbix):

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

2. (opcional) Iniciar el contenedor del agente Zabbix en el pod zabbix:

podman run --name zabbix-agent \
           -eZBX_SERVER_HOST="127.0.0.1,localhost" \
           --restart=always \
           --pod=zabbix \
           -d registry.connect.redhat.com/zabbix/zabbix-agent-50: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

3. 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-50

4. Iniciar el contenedor Java Gateway de Zabbix:

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

5. 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-50

Docker Compose

Zabbix también proporciona archivos de composición para definir y ejecutar componentes Zabbix de múltiples contenedores en Docker. Estos archivos de composición están disponibles en el repositorio oficial de Docker de Zabbix en github.com: https://github.com/zabbix/zabbix-docker. Estos archivos de composición se agregan como ejemplos, están sobrecargados. Por ejemplo, contienen servidores proxy con compatibilidad con MySQL y SQLite3.

Hay algunas versiones diferentes de archivos de composición:

Almacenamiento

Los archivos de composición están configurados para admitir el almacenamiento local en una máquina host. 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 Volumes 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.

Archivos de entorno

En el mismo directorio con archivos de composición en github.com puede encontrar archivos con variables de entorno predeterminadas para cada componente en el archivo de composición. Estos archivos de entorno se denominan .env_<tipo de componente>.

Ejemplos

Ejemplo 1

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

El comando descargará las últimas imágenes de Zabbix 6.0 para cada componente Zabbix y los ejecutará en modo desconectado.

Ejemplo 2

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

El comando descargará la imagen base Ubuntu 20.04 (focal) y luego compilará los componentes de Zabbix 6.0 localmente y los ejecutará en modo separado.