Actualización desde contenedores

Descripción general

Esta sección describe los pasos necesarios para realizar correctamente la actualización a contenedores de Zabbix 8.2.x.

Hay conjuntos de instrucciones independientes disponibles para:

Antes de realizar la actualización, asegúrese de leer las notas de actualización correspondientes.

Antes de iniciar la actualización, verifique que los usuarios tengan los permisos necesarios en la base de datos para realizar la actualización.

Para las actualizaciones desde Zabbix 6.0 o versiones anteriores, será necesario crear triggers deterministas durante la actualización. Si el registro binario está habilitado para MySQL/MariaDB, esto requiere privilegios de superusuario o establecer la variable/parámetro de configuración log_bin_trust_function_creators = 1. Consulte Scripts de creación de la base de datos para obtener instrucciones sobre cómo establecer la variable.

Tenga en cuenta que, si se ejecuta desde una consola, la variable solo se establecerá temporalmente y se eliminará cuando se reinicie Docker. En este caso, mantenga el servicio SQL en ejecución, detenga únicamente el servicio zabbix-server ejecutando docker compose down zabbix-server y, a continuación, ejecute docker compose up -d zabbix-server.

Como alternativa, puede establecer esta variable en el archivo de configuración.

Según el tamaño de la base de datos, la actualización de la base de datos a la versión 8.2 puede tardar mucho tiempo.

Actualización de la imagen del componente de Zabbix

Estas instrucciones actualizan las imágenes de Docker utilizadas como base para los contenedores de componentes de Zabbix.

Los pasos siguientes utilizan un proxy de Zabbix como ejemplo.
Reemplace zabbix-proxy-sqlite3 por el nombre del contenedor de su componente.

1. Compruebe todos los contenedores para identificar sus nombres y las versiones actuales de las imágenes:

docker ps -a

# CONTAINER ID   IMAGE                                           (...) NAMES
# 5a0c2e3d02b4   zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest   (...) zabbix-proxy-sqlite3

2. Descargue la nueva versión de la imagen:

docker pull zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest

3. Detenga el contenedor del componente de Zabbix:

docker stop zabbix-proxy-sqlite3

4. Elimine el contenedor del componente de Zabbix:

Asegúrese de haber anotado todos los indicadores de configuración y los montajes de volúmenes utilizados en el comando docker run original antes de continuar, ya que serán necesarios para volver a crear el contenedor.

docker rm zabbix-proxy-sqlite3

5. Inicie un contenedor nuevo utilizando la imagen actualizada:

docker run --name zabbix-proxy-sqlite3 \
  -e ZBX_SERVER_HOST=192.0.2.1 \
  -e ZBX_PROXYMODE=0 \
  -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
  -v zabbix-proxy-data:/var/lib/zabbix/db_data \
  --init \
  -d \
  zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest

Para obtener más información sobre la ejecución de contenedores de Zabbix, consulte Docker (implementación manual).

6. Verifique que la actualización se haya realizado correctamente comprobando los registros del contenedor:

docker logs -f zabbix-proxy-sqlite3

Actualización del archivo de Docker Compose

Estas instrucciones actualizan los archivos de Docker Compose utilizados para implementar los componentes de Zabbix.
Siga estas instrucciones si instaló Zabbix mediante Docker Compose.

1. Compruebe todos los contenedores para identificar sus nombres y las versiones actuales de sus imágenes:

docker ps -a

# CONTAINER ID   IMAGE                                             (...) NAMES
# d095f486deef   zabbix/zabbix-server-mysql:alpine-8.0-latest      (...) zabbix-docker-zabbix-server-1
# 70627d833da0   zabbix/zabbix-web-nginx-mysql:alpine-8.0-latest   (...) zabbix-docker-zabbix-web-nginx-mysql-1
# aaaa664cc185   zabbix/zabbix-server-mysql:alpine-8.0-latest      (...) zabbix-docker-server-db-init-1
# 9ab3e77492ff   mysql:8.0-oracle                                  (...) zabbix-docker-mysql-server-1

2. Acceda al repositorio de Zabbix Docker que clonó anteriormente, descargue las actualizaciones más recientes y cambie a la rama 8.2:

Si ha modificado .env, compose.yaml u otros archivos en su repositorio local, git pull puede sobrescribirlos.
Realice una copia de seguridad de los cambios locales antes de ejecutar este paso.

cd zabbix-docker
git pull
git checkout 8.2

3. Implemente los componentes de Zabbix utilizando el archivo de Docker Compose actualizado:

# Con MySQL como base de datos:
docker compose -f ./compose.yaml up -d

# Con PostgreSQL como base de datos:
docker compose -f ./compose_pgsql.yaml up -d

Después de recrear e iniciar todos los contenedores, la recopilación de datos puede tardar entre 1 y 3 minutos en reanudarse.
Para obtener más información sobre la ejecución de contenedores de Zabbix, consulte Docker Compose.

4. Compruebe que la actualización se realizó correctamente revisando los registros del contenedor (sustituya zabbix-docker-zabbix-server-1 por el nombre del contenedor del componente correspondiente):

docker logs -f zabbix-docker-zabbix-server-1