首页
/ Harvester集群节点状态NotReady问题分析与解决方案

Harvester集群节点状态NotReady问题分析与解决方案

2025-06-14 20:03:11作者:凤尚柏Louis

问题背景

在Harvester v1.5版本中,用户通过ISO安装方式将第二个节点加入集群时,发现控制台UI上该节点的Harvester集群状态持续显示为NotReady状态。虽然该节点已成功添加到主机页面,但状态显示异常影响了用户对集群健康状况的判断。

问题现象

当通过ISO安装方式创建多节点Harvester集群时:

  1. 第一个节点安装正常
  2. 第二个节点加入集群后,控制台UI显示集群状态为NotReady
  3. 主机页面显示节点已成功加入
  4. 重启集群后,非管理节点也会出现类似问题

技术分析

经过深入排查,发现问题根源在于Kubernetes v1.32版本引入的授权机制变更。具体表现为:

  1. Kubernetes v1.32增强了基于选择器的授权机制,限制了节点对Pod资源的访问权限
  2. 节点上的harvester-installer组件不再具备足够的权限访问harvester-system命名空间中的Pod信息
  3. 控制台UI的状态检测逻辑依赖这些Pod信息来判断集群健康状况
  4. 当检测失败时,UI错误地显示为NotReady状态

解决方案

Harvester团队通过以下方式解决了该问题:

  1. 在rke2-server和kube-apiserver中添加了必要的feature-gate配置
  2. 调整了授权策略,确保节点上的必要组件能够获取所需的Pod信息
  3. 更新了相关文档,说明在升级过程中可能出现的短暂NotReady状态

验证结果

该修复已在v1.5-d84233df-head版本中得到验证:

  1. 两节点ISO安装集群:所有节点状态正常显示为Ready
  2. 三节点iPXE安装集群:所有节点状态正常
  3. 四节点iPXE安装集群:所有节点状态正常

技术启示

  1. Kubernetes版本升级可能引入不兼容的授权策略变更
  2. 集群管理工具需要及时适配底层Kubernetes的变更
  3. 状态检测逻辑应考虑授权失败等边界情况
  4. 多节点集群管理需要特别关注节点间权限一致性

最佳实践建议

  1. 生产环境升级前,先在测试环境验证多节点状态
  2. 关注Harvester版本发布说明中的已知问题
  3. 对于关键业务集群,建议采用滚动升级策略
  4. 遇到状态异常时,可通过支持包(support bundle)收集详细信息

该问题的解决体现了Harvester团队对集群稳定性的高度重视,也为用户提供了更加可靠的多节点管理体验。

登录后查看全文
热门项目推荐
相关项目推荐