文档目录

适用场景

  • 产品:ZCF
  • 组件:Cloud
  • 版本:5.4.x
  • 操作系统:H84r
  • 部署形态:双管理节点
  • 触发条件:子账户删除“弹性伸缩组”时 UI 卡住,需要通过 UI 补丁做性能优化。

问题现象

  • 子账户在云平台删除“弹性伸缩组”时,UI 会卡住。
  • 问题定位在云平台 UI 层。
  • 仅在双管理节点上对 UI 界面进行变更,不影响其他云主机业务系统。

判断方法

  1. 变更前确认管理服务正常。
  2. 补丁更新后登录 UI 验证页面交互是否恢复正常。
  3. 最终通过删除“弹性伸缩组”操作确认问题已修复。

原因说明

问题并不在底层主机或存储,而是云平台 UI 在子账户删除“弹性伸缩组”时存在性能卡顿。因此本次变更通过替换 zstack-ui 对应补丁内容来修复前端/UI 侧问题。

解决方案

  1. 执行前准备
  • 风险等级:中风险
  • 先确认管理服务正常。
  • 先关闭全局高可用。
  • 先备份数据库与 UI 目录。
  1. 备份数据库和 UI 目录
  2. 在双管理节点备份数据库:
   zstack-ctl dump_mysql --file-name zstack-cloud-db-master-back
   zstack-ctl dump_mysql --file-name zstack-cloud-db-slave-back
  • 预期结果:具备数据库回退基础。
  1. 在双管理节点备份 UI 服务配置目录:
   tar -czvf zstack-ui-backup.tar.gz ~zstack/zstack-ui/zstack-ui
  • 预期结果:具备 UI 目录快速回滚副本。
  1. 校验并部署补丁
  2. 上传补丁包:
   zstack-tic-5286-5.4.6.tar.gz
  • 预期结果:补丁包已放到双管理节点。
  1. 校验 md5:
   md5sum zstack-tic-5286-5.4.6.tar.gz
  • 值必须为:
   65a8afeda4498f09546e544d812cd4a3
  • 预期结果:确认补丁包完整且版本正确。
  1. 解压覆盖到 UI 目录:
   tar -xzvf zstack-tic-5286-5.4.6.tar.gz -C ~zstack/zstack-ui/zstack-ui/
  • 预期结果:补丁文件覆盖完成。
  1. 验证与收口
  2. 登录 ZStack Cloud 云平台检查 UI 界面。
  • 预期结果:页面可正常访问。
  1. 验证删除“弹性伸缩组”是否还会卡住 UI。
  • 预期:
   删除“弹性伸缩组”卡住UI界面成功

即问题已修复。

  1. 开启全局高可用。
  • 预期结果:变更流程收口完成。

验证方法

  • 检查补丁包 md5 与内容一致。
  • 检查 UI 正常打开。
  • 检查子账户删除“弹性伸缩组”时不再卡住。
  • 检查双管理环境恢复正常运行。

风险与回滚

  • 风险:若补丁包版本或 md5 不匹配,可能导致 UI 文件覆盖错误。
  • 风险:若未备份 zstack-ui 目录,回退时会增加恢复难度。
  • 风险等级:中。
  • 回滚:“回退原先配置”,对应应使用已备份的 UI 目录和数据库副本恢复。
子账户删除弹性伸缩组时 UI 卡顿修复补丁 | 产品补丁与更新 · KB | ZStack 资源中心