适用场景
- 产品：
ZCF - 组件：
Cloud - 版本：
5.5.x - 部署形态：双管理节点
- 触发条件：平台存在清单标签显示异常，需要通过 UI 补丁修复。
问题现象
- 平台清单标签显示异常。
- 修复方式依赖替换 UI 目录中的补丁内容。
- 补丁会影响 UI 服务，因此需要预先备份并具备快速回退能力。
判断方法
- 补丁前先校验压缩包
md5。 - 补丁后检查标签展示是否恢复正常。
- 如异常，可立即恢复备份目录并重启 UI。
原因说明
本次问题属于前端展示层的标签显示异常，因此修复点集中在 tag 与 virtual-shared 目录中的 UI 文件，而非底层平台逻辑。
解决方案
- 执行前准备
- 风险等级：中风险
- 先关闭全局高可用。
- 先备份数据库。
- 双管理节点都要执行补丁、权限修正和 UI 重启。
- 处理步骤
- 关闭全局高可用。
- 预期结果：平台进入可维护状态。
- 备份数据库：
zstack-ctl dump_mysql node1- 预期结果：数据库具备回退基础。
- 在双管理节点校验补丁包：
md5sum tic-5759-5.5.6.tar.gz- 目标值应为：
febaab90db1c5cd1f48ec8e636f3f0a3- 预期结果：确认补丁包未损坏。
- 备份原始目录：
tar -czvf zstack-ui-next-backup.tar.gz ~zstack/zstack-ui/zstack-ui/tag ~zstack/zstack-ui/zstack-ui/virtual-shared- 预期结果：保留完整回退目录。
- 解压补丁到 UI 目录：
tar -xzvf tic-5759-5.5.6.tar.gz -C ~zstack/zstack-ui/zstack-ui- 预期结果：异常标签相关文件完成替换。
- 修正目录权限：
chown -R zstack:zstack ~zstack/zstack-ui/zstack-ui/tag ~zstack/zstack-ui/zstack-ui/virtual-shared- 预期结果：文件属主正确。
- 重启 UI：
zstack-ctl stop_ui
zstack-ctl start_ui- 预期结果：新补丁生效。
- 检查清单标签显示是否恢复正常。
- 确认无异常后开启全局高可用。
- 预期结果：变更收口完成。
验证方法
- 检查补丁包
md5正确。 - 检查标签显示恢复正常。
- 检查 UI 服务重启后平台可正常访问。
风险与回滚
- 风险：补丁替换和 UI 重启期间，平台 UI 会短暂不可访问。
- 风险等级：中。
- 回滚步骤：
tar -xzvf zstack-ui-next-backup.tar.gz -C /
chown -R zstack:zstack ~zstack/zstack-ui/zstack-ui/tag ~zstack/zstack-ui/zstack-ui/virtual-shared然后重启 UI 服务。