从容器升级
概述
本节介绍成功将 Zabbix 容器升级到 8.2.x 所需的步骤。
以下提供了不同的操作说明:
升级前,请务必阅读相关的升级说明!
开始升级前,请确认用户具有执行数据库升级所需的权限。
对于从 Zabbix 6.0 或更早版本升级的情况,需要在升级期间创建确定性触发器。
如果 MySQL/MariaDB 启用了二进制日志记录,则需要超级用户权限,或将变量/配置参数 log_bin_trust_function_creators = 1 设置为启用。
有关如何设置该变量的说明,请参阅数据库创建脚本。
请注意,如果从控制台执行,该变量只会临时设置,在 Docker 重启时将被删除。
在这种情况下,请保持 SQL 服务运行,仅通过运行 docker compose down zabbix-server 停止 zabbix-server 服务,然后运行 docker compose up -d zabbix-server。
或者,也可以在配置文件中设置此变量。
根据数据库大小,将数据库升级到 8.2 版本可能需要较长时间。
Zabbix 组件镜像升级
这些说明用于升级作为 Zabbix 组件容器基础的 Docker 镜像。
以下步骤以 Zabbix proxy 为例。
将 zabbix-proxy-sqlite3 替换为组件的容器名称。
1. 检查所有容器,以确定其名称和当前镜像版本:
docker ps -a
# CONTAINER ID IMAGE (...) NAMES
# 5a0c2e3d02b4 zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest (...) zabbix-proxy-sqlite3
2. 拉取新镜像版本:
docker pull zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest
3. 停止 Zabbix 组件容器:
docker stop zabbix-proxy-sqlite3
4. 删除 Zabbix 组件容器:
继续操作前,请确保已记录原始 docker run 命令中使用的所有配置标志和卷挂载,因为重新创建容器时需要使用这些配置。
docker rm zabbix-proxy-sqlite3
5. 使用更新后的镜像启动新容器:
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
有关运行 Zabbix 容器的更多信息,请参阅 Docker(手动部署)。
6. 检查容器日志,确认升级是否成功:
docker logs -f zabbix-proxy-sqlite3
Docker Compose 文件升级
这些说明用于升级部署 Zabbix 组件时使用的 Docker Compose 文件。
如果您使用 Docker Compose 安装了 Zabbix,请按照以下说明操作。
1. 检查所有容器,以确定其名称和当前镜像版本:
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. 导航到之前克隆的 Zabbix Docker 仓库,拉取最新更新,并切换到 8.2 分支:
如果您修改了本地仓库中的 .env、compose.yaml 或其他文件,git pull 可能会覆盖这些文件。
运行此步骤前,请备份所有本地更改。
cd zabbix-docker
git pull
git checkout 8.2
3. 使用更新后的 Docker Compose 文件部署 Zabbix 组件:
# 使用 MySQL 作为数据库:
docker compose -f ./compose.yaml up -d
# 使用 PostgreSQL 作为数据库:
docker compose -f ./compose_pgsql.yaml up -d
所有容器重新创建并启动后,数据采集可能需要 1–3 分钟才能恢复。
有关运行 Zabbix 容器的更多信息,请参阅 Docker Compose。
4. 检查容器日志,确认升级是否成功(将 zabbix-docker-zabbix-server-1 替换为组件容器的名称):
docker logs -f zabbix-docker-zabbix-server-1