适用场景
- 产品：
ZCF - 组件：
ZStack Cloud - 版本：
5.4.x - 操作系统：
H84R - 部署形态：双管理节点
- 触发条件：当前环境存在 Ceph 镜像仓库本地镜像上传问题，需要通过平台版本升级修复。
问题现象
- 当前
5.4.x平台存在 Ceph 镜像仓库本地镜像上传问题。 - 需要升级云平台到
5.4.x。 - 本次不涉及
kernel、qemu、libvirt升级。
判断方法
- 升级前通过自检脚本和资源检查确认环境健康。
- 升级后确认管理平台恢复访问、资源状态正常。
- 验证本地镜像上传问题是否消失。
原因说明
本次升级的直接目标，是修复 5.4.x 环境中的 Ceph 镜像仓库本地镜像上传问题，因此只需升级 cloud 平台版本到 5.4.x。
解决方案
- 升级前准备
- 风险等级：高
- 本次只升级 cloud，不升级
kernel和虚拟化组件。 - 先检查：
- V3 兼容项
- Ceph 兼容性
- 云主机实例状态
- 云主机资源情况
zsha2状态- 数据库大小
- HTTPS 配置
- SSH / IPMI 升级方式
- 使用
zstack-upgrade-check-master做升级前自检。 - 关闭全局高可用。
- 在两个 MN 节点备份数据库。
- 升级步骤
- 下载升级脚本与 ISO：
cloud-upgrade-scripts_0.3.x.tar.gzZStack-Cloud-x86_64-DVD-5.4.7-h84r.iso- 预期结果：升级文件准备完成。
- 上传升级脚本和 ISO 到两个 MN 节点。
- 预期结果：双管理节点都具备升级材料。
- 解压升级脚本：
mkdir -p /root/upgrade && tar -xzvf /root/cloud-upgrade-scripts_v0.3.tar.gz -C /root/upgrade- 预期结果：脚本目录解压完成。
- 将 ISO 复制到
cloud-upgrade-scripts目录。
- 预期结果：脚本执行目录内已包含目标 ISO。
- 执行升级脚本：
bash upgrade/cloud-upgrade-scripts/cloud-upgrade.sh ZStack-Cloud-x86_64-DVD-5.4.7-h84r.iso- 按提示选择执行内容，输入
admin密码并完成配置。 - 预期结果：云平台灰度升级到
5.4.x。
- 开启全局高可用。
- 预期结果：平台升级完成并恢复正常运行。
验证方法
- 检查管理节点与平台页面恢复正常。
- 检查主机与资源状态正常。
- 检查升级后如有主机未自动恢复连接，执行手工重连。
- 检查本地镜像上传问题已修复。
风险与回滚
- 风险：升级期间管理节点不可访问，不能申请新资源。
- 风险：升级后主机可能需要手动重新连接。
- 风险：UI 框架升级后，浏览器缓存可能导致域名无法正常打开。
- 风险：若 ZBS 为主存储，需要同步升级到配套版本。
- 风险等级：高。
- 回滚：双管理回退逻辑包括解耦为单管理、恢复旧 repo / 安装包、恢复数据库并恢复平台访问。