文档中心知识库安全API Explorer
文档中心›KB›云平台升级一键升级脚本KB
文档目录

适用场景

  • 产品：ZCF
  • 组件：ZStack Cloud
  • Cloud 版本：4.8.x
  • 操作系统/软件源环境：H84R
  • 触发条件：当前平台存在多个已知问题，需要通过一键升级脚本升级到 4.8.x。

问题现象

  • 当前平台版本为 4.8.x。
  • 升级目标是 4.8.x。
  • 文档局部位置提到 4.8.x，但升级脚本与 ISO 实际指向 4.8.x。
  • 升级后还需处理：
  • qemu/libvirt 组件
  • 主机管理重连
  • 独享型负载均衡重连
  • ZBS 主存储配套升级

判断方法

  1. 先通过自检包确认环境健康。
  2. 一键升级完成后检查主机、主存储、镜像服务器和高可用状态。
  3. 再补做组件升级和独享型负载均衡重连验证。

原因说明

本次升级的重点是通过一键升级脚本快速把平台从较旧版本提升到 4.8.x，以修复多个已知问题并提升后续可维护性。由于一键脚本只负责控制面升级，后续仍需手动补齐虚拟化组件升级、主机重连和特定存储 / 负载均衡配套步骤。

解决方案

  1. 升级前环境检查
  2. 使用升级自检包检查环境健康：
   tar zxvf zstack-upgrade-check-master.tar.gz
   cd zstack-upgrade-check-master
   bash exec_tool.sh -p [MN_admin_password]
   cat ./log/check.log
  • 预期结果：确认环境健康并核实 check.log。
  1. 检查项包括：
  • 云路由器 / VPC
  • AD/LDAP
  • SharedBlock
  • Ceph
  • 云主机脑裂检查
  • HTTPS
  • SSH 升级方式
  • 历史 API 审计信息
  • 预期结果：环境满足升级前提。
  1. 额外检查：
   zsha2 status
  • 检查云主机实例状态、资源状态和平台高可用状态。
  • 预期结果：平台运行稳定。
  1. 变更前准备
  2. 关闭全局高可用。
  3. 在两个管理节点备份数据库。
  • 预期结果：具备回退基础。
  1. 下载一键升级脚本并校验：
  • cloud-upgrade-scripts_0.2.x.tar.gz / cloud-upgrade-scripts_0.3.x.tar.gz
  • md5 参考：
     f8965606d47babad93384b0be8cf4a55
  • 预期结果：脚本包校验通过。
  1. 下载升级 ISO 并校验：
   ZStack_Alibaba_Cloud-x86_64-DVD-4.8.36-h84r.iso
   MD5: fcad1a7ccf65282bdec516c4b6010d84
  • 预期结果：升级介质完整可用。
  1. 使用一键脚本升级云平台
  2. 在两个 MN 节点上传升级脚本和 ISO 文件。
  3. 解压升级脚本：
   mkdir -p /root/upgrade && tar -xzvf /root/cloud-upgrade-scripts_v0.3.tar.gz -C /root/upgrade
  • 预期结果：升级脚本目录展开完成。
  1. 把 ISO 拷入脚本目录：
   cp ZStack_Alibaba_Cloud-x86_64-DVD-4.8.36-h84r.iso upgrade/cloud-upgrade-scripts/
  1. 执行一键升级：
   bash upgrade/cloud-upgrade-scripts/cloud-upgrade.sh ZStack_Alibaba_Cloud-x86_64-DVD-4.8.36-h84r.iso
  • 按提示选择执行内容。
  • 输入 admin 密码与相关配置。
  • 预期结果：控制面升级到 4.8.x。
  1. 升级后补做组件与环境收口
  2. 后续需参考前一步继续升级 qemu/libvirt 组件。
  3. 升级完成后检查：
  • 主机管理连接状态
  • 云主机资源状态
  • 平台服务状态
  • 预期结果：平台基础功能恢复正常。
  1. 额外提示：
  • 升级后可能需要手动重连主机管理
  • 独享型负载均衡需重连生效
  • ZBS 为主存储时需同步升级 ZBS
  • 预期结果：环境外围依赖全部收口。
  1. 组件风险控制要求
  2. 若后续升级 QEMU 与 Libvirt，需严格遵循：
  • 关闭所有备份任务
  • 如有运行中的备份进程，在所有备份服务器执行：
     pkill qemu-nbd
  • QEMU 升级后通过热迁移或重启使生效
  • Libvirt 升级后检查 no state 云主机
  • 非 ZCE-X 环境可使用在线热升级工具
  • 平台升级后可执行：
     zstack-cli UpdateClusterOS uuid=<cluster_uuid> updatePackages=zstack-virt
  • 预期结果：组件升级风险可控。

验证方法

  • 检查一键升级脚本执行完成且平台版本达到 4.8.x。
  • 检查主机、主存储、镜像服务器和高可用状态正常。
  • 检查需要手动重连的主机已恢复连接。
  • 检查独享型负载均衡重连后功能正常。
  • 检查 ZBS 主存储环境完成配套升级。

风险与注意事项

  • 风险：升级期间管理节点不可访问，不能申请新资源。
  • 风险：一键升级完成后仍可能需要手动处理主机连接和配套组件。
  • 风险：QEMU 版本无法直接回滚。
  • 风险等级：高。

回退方法

回退路径为双管理退回单管理，核心步骤包括：

  1. 在两个管理节点准备升级前版本的 ISO、安装包和双管理 HA 套件。
  2. 再次备份数据库。
  3. 用 zsha2 status 确认 VIP 所在节点，并读取 chrony.serverIp。
  4. 停止双管理并禁用：
   zsha2 stop-node
   systemctl disable keepalived
   systemctl disable zstack-ha
  1. 在数据库执行：
   stop slave;
   reset slave all;
   show slave status;
  1. 把 DB.url 指回单管理真实 IP。
  2. 删除当前环境并恢复原始 repo、installer 和数据库。
  3. 在 VIP 节点重新安装原始 zsha2 套件。
  4. 登录 VIP:5000 检查平台资源与业务状态。
上一篇ZStack Cloud 物理机操作系统 CVE-2026-43284 漏洞修复下一篇ZStack Cloud OpenSSH CVE-2024-6387 与 8080 端口加固
云平台升级一键升级脚本 | 技术方案 · KB | ZStack 资源中心