Harvester升级控制器状态管理问题分析与修复

在Harvester集群管理系统中，升级控制器负责处理集群版本升级的全生命周期管理。近期发现一个关键性问题：当用户通过UI界面点击"忽略"按钮时，升级控制器的状态信息会被意外清除，导致系统无法正确记录升级历史状态。

问题本质

该问题的核心在于UI操作与控制器逻辑之间的交互存在设计缺陷。当用户完成升级后，UI提供的"忽略"操作会触发对升级CRD(自定义资源定义)状态的清理，而非仅标记该消息为已读状态。这种处理方式会导致以下问题：

1. 升级历史状态信息丢失
2. 系统无法正确判断先前的升级状态
3. 可能影响后续升级操作的决策

技术实现细节

在Kubernetes体系下，Harvester使用CRD来管理升级过程。每个升级操作都会创建一个Upgrade资源对象，其中包含完整的升级状态信息：

status:
  conditions:
  - status: "True"
    type: Completed
  - status: "True" 
    type: LogReady
  nodeStatuses:
    node1:
      state: Succeeded

正确的实现应该保持这些状态信息的持久性，仅通过标签(label)来标记用户是否已阅读升级消息：

metadata:
  labels:
    harvesterhci.io/read-message: "true"

修复方案

开发团队通过以下方式解决了该问题：

1. 分离状态管理与消息标记逻辑
2. 确保UI操作仅修改read-message标签
3. 保持status字段的完整性不变
4. 升级控制器不再响应read-message标签的变化

验证结果

在Harvester v1.4.3版本中，该修复已得到验证：

1. 原生UI操作后，状态信息保持完整
2. read-message标签正确更新
3. 升级历史记录可追溯
4. 与Rancher集成的场景也通过验证

最佳实践建议

对于集群管理员，建议：

1. 升级前检查已知问题列表
2. 升级后不要立即清理升级资源
3. 通过kubectl检查Upgrade资源状态
4. 保留升级日志用于问题排查

该修复确保了升级过程的可观测性和可靠性，是Harvester集群管理功能的重要改进。