Harvester升级控制器中UI菜单导致升级状态异常问题分析

问题背景

在Harvester项目v1.4.0至v1.4.2版本中，存在一个与升级流程相关的控制器问题。当用户通过UI界面执行"忽略升级(Dismiss it)"操作时，会导致升级自定义资源(Upgrade CR)的状态(status)字段被意外清除，进而影响系统的升级状态跟踪能力。

技术细节

该问题主要涉及Harvester升级控制器与UI界面的交互机制。在正常情况下，升级控制器会维护一个Upgrade CR对象来记录整个升级过程的状态信息。这个CR对象包含多个重要字段：

1. metadata.labels：包含如harvesterhci.io/latestUpgrade和harvesterhci.io/upgradeState等标签，标识升级状态
2. status.conditions：记录升级过程中各个阶段的完成情况
3. status.nodeStatuses：跟踪各个节点的升级状态

问题发生时，UI界面的"忽略升级"操作会错误地清除这些状态字段，导致升级记录不完整。例如，原本应该保留的Completed状态会被设置为Unknown，失去了对升级结果的准确记录。

影响范围

该问题影响以下Harvester版本：

• v1.4.0
• v1.4.1
• v1.4.2

主要影响场景包括：

1. 通过原生Harvester UI执行升级后点击"忽略升级"
2. 通过Rancher UI管理Harvester集群时的升级操作

解决方案

开发团队在v1.4.3版本中修复了此问题，主要改进包括：

1. 修改升级控制器逻辑，确保"忽略升级"操作不会清除状态字段
2. 保留完整的升级历史记录，包括所有经历过的状态
3. 正确维护harvesterhci.io/read-message: "true"标签

修复后的行为表现为：

• 升级完成后，UI可以正常显示升级结果
• 点击"忽略升级"后，Upgrade CR仍保留完整的状态信息
• 系统可以准确追踪历史升级记录

验证结果

测试团队在多种环境下验证了修复效果：

1. 原生Harvester UI测试：

   • 从v1.4.2升级到v1.4.3-rc3
   • 验证Upgrade CR保留了完整的状态字段
   • 确认所有节点状态正确记录为"Succeeded"

2. Rancher集成测试：

   • 使用Rancher v2.10.5管理Harvester集群
   • 验证升级流程和状态保持正常
   • 确认UI交互不会影响升级状态记录

技术建议

对于使用受影响版本的用户，建议：

1. 计划升级到v1.4.3或更高版本
2. 在执行重要升级前，备份关键状态信息
3. 监控Upgrade CR的状态变化，确保升级过程被正确记录

对于开发者，建议：

1. 在修改CRD控制器时，特别注意状态字段的持久性
2. UI操作应避免直接修改核心状态字段
3. 实现更完善的升级历史追踪机制

该问题的修复提升了Harvester升级过程的可靠性和可观测性，为后续版本提供了更稳定的升级基础架构。