Harvester 1.4.2升级至1.5.0的常见问题分析与解决方案

升级失败现象分析

在将Harvester从1.4.2版本升级至1.5.0版本的过程中，用户遇到了升级流程中断的问题。系统虽然连接了互联网，但出现了类似ImagePullBackOff的错误症状。检查升级日志pod时发现没有相关pod被列出，即使应用了kubectl补丁操作，系统也未能恢复正常。

问题根源探究

通过对支持包的深入分析，发现系统中残留了多个先前升级尝试留下的日志资源，这些残留资源阻碍了新升级流程的正常启动和完成。具体表现为：

1. 系统中存在两个陈旧的Logging CR资源：

   • hvst-upgrade-5554f-upgradelog-infra（存在96天）
   • hvst-upgrade-swx5p-upgradelog-operator-root（存在94天）

2. 多个关联的pod仍在运行，包括：

   • 多个fluentbit实例
   • fluentd实例
   • rancher-logging组件

这些残留资源占用了系统资源并可能造成资源冲突，导致新升级流程无法正常启动。

解决方案实施步骤

第一步：清理残留资源

1. 删除陈旧的Logging CR资源：

   kubectl delete logging hvst-upgrade-5554f-upgradelog-infra
   kubectl delete logging hvst-upgrade-swx5p-upgradelog-operator-root
   

2. 检查并清理相关pod：

   kubectl get pods -A | grep hvst-upgrade
   

   确认只保留必要的pod（如rancher-logging组件），删除其他残留pod。

第二步：准备升级环境

1. 确保系统网络连接正常，特别是到容器镜像仓库的连接。

2. 根据Harvester 1.5.0文档要求，创建Version CR来启动升级流程。

3. 在升级前禁用日志功能，减少潜在冲突。

第三步：执行升级操作

1. 重新应用v1.5版本的manifest以启用升级按钮。

2. 启动升级流程，密切监控升级状态。

3. 如遇问题，可考虑使用升级重启功能。

预防措施建议

1. 在每次升级前，检查系统中是否存在陈旧的升级资源。

2. 定期清理不再需要的升级日志和资源。

3. 对于生产环境，建议先在测试环境验证升级流程。

4. 保持对Harvester文档的关注，及时了解已知问题和解决方案。

技术要点说明

1. Harvester升级机制依赖于Kubernetes的CRD（Custom Resource Definition）来管理升级流程。

2. 升级过程中会创建临时性的日志收集组件（fluentbit/fluentd）来记录升级日志。

3. 这些组件在正常情况下应在升级完成后自动清理，但在某些异常情况下可能残留。

4. 残留资源不仅占用系统资源，还可能造成后续升级的命名冲突或资源争用。

通过以上步骤，大多数升级中断问题可以得到解决。如问题仍然存在，建议收集完整的支持包并联系技术支持团队进行深入分析。