Kube-Hetzner 项目升级至 2.14.1 以上版本时 Agent 节点卡在"Still creating"状态的分析与解决方案
在 Kube-Hetzner 项目从 2.14.1 版本升级到更高版本时,部分用户遇到了一个关键问题:Agent 节点在创建过程中会无限期地停留在"Still creating"状态。这个问题影响了集群的正常部署和使用,值得深入分析其成因和解决方案。
问题现象
当用户将 Kube-Hetzner 项目从 2.14.1 版本升级到任何更高版本时,会观察到以下现象:
- 控制平面节点能够正常创建并运行
- Agent 节点在创建过程中卡在"Still creating"状态
- 系统日志显示 k3s-agent 服务无法正常启动
- 控制平面节点显示处于 drained 状态,带有
node.cloudprovider.kubernetes.io/uninitialized=true:NoSchedule
的污点标记
根本原因分析
经过技术团队深入排查,发现问题主要与 Hetzner CSI 驱动和 Longhorn 存储系统的交互有关:
-
CSI 驱动初始化问题:当
disable_hetzner_csi
设置为 true 时,控制平面节点无法正确初始化 CSI 驱动,导致节点标记为未初始化状态。 -
服务启动依赖:k3s-agent 服务的启动依赖于 CSI 驱动的正确初始化,当 CSI 驱动未就绪时,服务会一直等待而无法完成启动。
-
版本变更影响:从 2.14.1 版本开始,项目内部对 CSI 驱动的处理逻辑发生了变化,这可能是导致问题显现的直接原因。
临时解决方案
在官方修复发布前,用户可以采取以下临时解决方案:
-
保持 Hetzner CSI 启用:
disable_hetzner_csi = false
这种方法虽然能解决问题,但会导致集群中存在两个默认存储类(Hetzner CSI 和 Longhorn)。
-
手动清理存储类: 如果只需要 Longhorn 存储类,可以在集群创建完成后手动删除 Hetzner CSI 的存储类:
kubectl delete storageclass hcloud-volumes
最佳实践建议
-
版本升级注意事项:
- 在升级前务必备份重要数据
- 使用
terraform init -upgrade
确保工具链最新 - 创建新的系统镜像而非复用旧镜像
-
配置规范:
- 遵循标准的节点池配置格式
- 避免在初始部署时使用过多自定义 Helm 值
- 确保网络区域等基础配置正确
-
监控与调试:
- 检查 k3s-agent 服务日志:
journalctl -u k3s-agent -f
- 查看节点状态:
kubectl get nodes -o wide
- 检查存储类配置:
kubectl get storageclass
- 检查 k3s-agent 服务日志:
长期解决方案展望
技术团队已经在后续版本中修复了此问题,主要改进包括:
- 优化了 CSI 驱动的初始化和依赖管理
- 改进了节点就绪状态的检测逻辑
- 提供了更清晰的错误提示和日志输出
建议用户关注项目更新,及时升级到包含修复的版本,以获得更稳定可靠的集群部署体验。
通过理解这一问题背后的技术细节和解决方案,用户可以更有效地部署和管理基于 Kube-Hetzner 的 Kubernetes 集群,避免类似问题的发生。
cherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端TypeScript037RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统Vue0405arkanalyzer
方舟分析器:面向ArkTS语言的静态程序分析框架TypeScript040GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。02CS-Books
🔥🔥超过1000本的计算机经典书籍、个人笔记资料以及本人在各平台发表文章中所涉及的资源等。书籍资源包括C/C++、Java、Python、Go语言、数据结构与算法、操作系统、后端架构、计算机系统知识、数据库、计算机网络、设计模式、前端、汇编以及校招社招各种面经~03openGauss-server
openGauss kernel ~ openGauss is an open source relational database management systemC++0145
热门内容推荐
最新内容推荐
项目优选









