eksctl项目中的Bottlerocket节点升级问题解析

问题背景

在eksctl项目中，用户报告了一个关于Bottlerocket节点升级的异常行为。当尝试使用eksctl工具将Bottlerocket节点组升级到Kubernetes 1.29版本时，节点组版本会意外回退到1.27版本，而不是按预期升级到目标版本。

问题现象

用户通过以下命令尝试升级节点组：

eksctl upgrade nodegroup --name=mo-2vcpu-16gb-spot-v2 --kubernetes-version 1.29 --cluster=my-cluster

然而，升级后检查节点组状态时发现版本号仍显示为1.27，而不是预期的1.29。这种现象在之前升级到1.28版本时也曾出现过。

技术分析

经过项目维护者的深入调查，发现问题的根源在于eksctl处理Bottlerocket节点升级时的逻辑存在缺陷：

1. 版本字段未正确填充：在生成CloudFormation变更集时，Version字段未能正确更新到目标Kubernetes版本。

2. 参数处理逻辑问题：MakeManagedSSMParameterName函数返回了latestReleaseVersion，导致Version字段无法被正确填充。

3. 变更集内容差异：有效的变更集仅包含ForceUpdateEnabled属性的修改，而缺少关键的版本升级变更。

解决方案

项目维护者提出了以下修复方案：

1. 代码修正：调整MakeManagedSSMParameterName函数的逻辑，确保在Bottlerocket节点升级时能够正确填充Version字段。

2. 版本兼容性处理：完善对不同AMI家族（Bottlerocket/AL2）的版本升级路径处理。

3. 变更集生成优化：确保变更集包含必要的版本升级变更内容。

验证结果

修复后，维护者进行了以下验证步骤：

1. 创建1.27版本的集群和Bottlerocket节点组
2. 将集群升级到1.28版本
3. 执行节点组升级到1.28版本
4. 确认节点组版本成功升级

用户实践建议

对于遇到类似问题的用户，可以采取以下措施：

1. 升级eksctl版本：确保使用修复后的eksctl版本（v0.175.0及以上）。

2. 手动干预：如果升级后版本仍不正确，可以尝试手动修改CloudFormation栈中的Version字段。

3. 重建节点组：作为最后手段，考虑删除并重建节点组以确保版本正确。

总结

Bottlerocket节点升级问题暴露了eksctl在处理不同AMI家族版本升级路径时的不足。通过本次修复，项目团队完善了版本升级机制，为后续支持更多AMI类型奠定了基础。用户在使用eksctl管理Bottlerocket节点时，应确保使用最新版本以获得完整的升级功能支持。