Áú»¢¶Ä²©

5 ±õ²Ô²õ³Ù²¹±ô²¹³¦¾±¨®²Ô desde contenedores

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô general

Esta secci¨®n describe c¨®mo implementar Áú»¢¶Ä²© con Docker o Docker Compose.

Áú»¢¶Ä²© proporciona oficialmente:

• Im¨¢genes de Docker separadas para cada componente Áú»¢¶Ä²© para funcionar como contenedores port¨¢tiles y autosuficientes.
• Archivos de composici¨®n para definir y ejecutar componentes Áú»¢¶Ä²© "multicontenedor" en Docker.

Archivos fuente

Las fuentes de los archivos Docker se almacenan en el de Áú»¢¶Ä²© en GitHub donde puede seguir los ¨²ltimos cambios de archivos o bifurcar el proyecto para crear sus propias im¨¢genes.

Docker

Áú»¢¶Ä²© proporciona im¨¢genes basadas en una variedad de imagenes de sistemas operativos. Para obtener la lista de im¨¢genes del sistema operativo base compatibles para un componente Áú»¢¶Ä²© espec¨ªfico, consulte la descripci¨®n del componente en . Todas las im¨¢genes de Áú»¢¶Ä²© est¨¢n configuradas para reconstruir las im¨¢genes m¨¢s recientes si se actualizan las im¨¢genes base.

±õ²Ô²õ³Ù²¹±ô²¹³¦¾±¨®²Ô

Para obtener la imagen del componente Áú»¢¶Ä²©, ejecute:

docker pull zabbix/zabbix-server-mysql

Reemplace zabbix/zabbix-server-mysql con el nombre del repositorio de Docker requerido.

Este comando extraer¨¢ la ¨²ltima versi¨®n estable del componente Áú»¢¶Ä²© basada en el sistema operativo Alpine Linux. Puede agregar etiquetas al nombre del repositorio para obtener una imagen basada en otro sistema operativo o en la versi¨®n principal o secundaria espec¨ªfica de Áú»¢¶Ä²©.

Los siguientes repositorios est¨¢n disponibles en Docker Hub:

Etiquetas

Las im¨¢genes oficiales de los componentes de Áú»¢¶Ä²© pueden contener las siguientes etiquetas:

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô 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 Áú»¢¶Ä²© proporcionan variables de entorno para controlar la configuraci¨®n. Las variables de entorno admitidas se enumeran en el repositorio de componentes.

Estas variables de entorno son opciones de los archivos de configuraci¨®n de Áú»¢¶Ä²©, pero con un m¨¦todo de nomenclatura diferente. Por ejemplo, ZBX_LOGSLOWQUERIES es igual a LogSlowQueries de los archivos de configuraci¨®n del servidor Áú»¢¶Ä²© y proxy Áú»¢¶Ä²©.

Las siguientes variables de entorno son espec¨ªficas de los componentes de Docker y no existen en los archivos de configuraci¨®n de Áú»¢¶Ä²©:

³Õ´Ç±ô¨²³¾±ð²Ô±ð²õ

Las im¨¢genes permiten montar vol¨²menes utilizando los siguientes puntos de montaje:

Para obtener informaci¨®n adicional, consulte los repositorios oficiales de Áú»¢¶Ä²© en Docker. Hub.

Ejemplos de uso

** Ejemplo 1 **

El ejemplo demuestra c¨®mo ejecutar el servidor Áú»¢¶Ä²© con soporte para la base de datos MySQL, interfaz web de Áú»¢¶Ä²© basada en el servidor web Nginx y Áú»¢¶Ä²© Java gateway.

1. Crear una red dedicada para los contenedores componentes de Áú»¢¶Ä²©:

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 \
             --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 Java gateway de Áú»¢¶Ä²©

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 Áú»¢¶Ä²© 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-7.0-latest

5. Iniciar la interfaz web de Áú»¢¶Ä²© y enlazar la instancias creadas del servidor MySQL y del servidor Áú»¢¶Ä²©.

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 Áú»¢¶Ä²© con soporte a la base de datos PostgreSQL, interfaz web de Áú»¢¶Ä²© basada en el servidor web Nginx y capacidad de captura SNMP.

1. Crear una red dedicada para los contenedores componentes de Áú»¢¶Ä²©:

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 Áú»¢¶Ä²©

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

4. Iniciar la instancia del servidor Áú»¢¶Ä²© 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-7.0-latest

5. Iniciar la interfaz web de Áú»¢¶Ä²© y enlace la instancias creadas del servidor PostgreSQL y del servidor Áú»¢¶Ä²©

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 Áú»¢¶Ä²© con soporte a la base de datos MySQL, interfaz web de Áú»¢¶Ä²© basada en el servidor web Nginx y Áú»¢¶Ä²© Java gateway usando podman en Red Hat 8.

1. Crear un nuevo pod llamado zabbix y exponer los puertos (interfaz web, servidor de captura Áú»¢¶Ä²©):

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

2. (opcional) Iniciar el contenedor del agente Áú»¢¶Ä²© en el 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 equipo 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 Áú»¢¶Ä²©:

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 Java Gateway de Áú»¢¶Ä²©:

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 Áú»¢¶Ä²©:

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

Componente acoplable

Alternativamente, Áú»¢¶Ä²© se puede instalar usando el complemento Docker Compose. Los archivos de redacci¨®n para definir y ejecutar componentes Áú»¢¶Ä²© de m¨²ltiples contenedores est¨¢n disponibles en el oficial en GitHub.

Estos archivos de redacci¨®n se agregan como ejemplos; est¨¢n sobrecargados. Por ejemplo, contienen servidores proxy compatibles con MySQL y SQLite3.

Para obtener archivos de redacci¨®n de Docker proporcionados por Áú»¢¶Ä²©, clone el repositorio:

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

Cambie a la versi¨®n requerida:

git checkout 7.0

Redacte archivos de configuraci¨®n y cree e inicie contenedores:

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

Reemplace docker-compose_v3_alpine_mysql_latest.yaml en el comando anterior con 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 Áú»¢¶Ä²© usando el archivo de composici¨®n. El directorio contendr¨¢ la misma estructura que la descrita anteriormente en la Secci¨®n ³Õ´Ç±ô¨²³¾±ð²Ô±ð²õ 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 env_vars. Consulte las variables de entorno para obtener detalles sobre los nombres 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 Áú»¢¶Ä²© 7.0 para cada componente de Áú»¢¶Ä²© y las ejecutar¨¢ en modo desconectado.

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 22.04 (jammy), luego compilar¨¢ los componentes Áú»¢¶Ä²© 7.0 localmente y los ejecutar¨¢ en modo desconectado.