eksctl在AWS中国区创建集群时遇到metrics-server版本不可用问题分析

问题背景

在使用eksctl工具在AWS中国区(cn-north-1)创建EKS集群时，用户遇到了一个关于metrics-server插件的错误。尽管用户配置文件中并未显式指定要安装metrics-server插件，但集群创建过程仍然因"no versions available for 'metrics-server'"错误而失败。

问题现象

用户使用以下插件配置创建集群：

addons:
- name: vpc-cni
  attachPolicyARNs:
    - arn:aws-cn:iam::aws:policy/AmazonEKS_CNI_Policy
  version: latest
- name: coredns
  version: latest
- name: kube-proxy
  version: latest

创建过程中，虽然vpc-cni、coredns和kube-proxy三个插件都成功安装，但最终集群创建失败，错误信息显示无法获取metrics-server的可用版本。

问题原因分析

1. AWS中国区服务差异：AWS中国区与其他区域的服务存在一定差异，某些插件可能在中国区不可用或版本不同。metrics-server插件在AWS中国区可能确实没有可用的版本。

2. eksctl内部逻辑问题：尽管用户没有在配置中显式指定metrics-server插件，但eksctl内部可能默认会检查或尝试安装某些核心插件，包括metrics-server。

3. 版本兼容性问题：有用户反馈在eksctl 0.201.0版本遇到此问题，而回退到0.199.0版本可以解决，表明这可能是一个版本引入的回归问题。

解决方案

1. 使用旧版本eksctl：临时解决方案是回退到eksctl 0.199.0版本，该版本没有此问题。

2. 等待官方修复：开发团队已经通过PR #8146修复了此问题，用户可等待包含该修复的新版本发布。

3. 显式配置插件：在配置文件中明确列出所有需要的插件，避免依赖默认行为。

技术建议

1. 中国区部署注意事项：在AWS中国区部署时，需要特别注意服务可用性和版本差异问题。建议提前验证所有依赖组件的可用性。

2. 插件管理最佳实践：

   • 明确指定所有需要的插件
   • 避免使用"latest"标签，而是指定已知可用的版本号
   • 考虑使用Pod Identity Associations而非IRSA进行权限管理

3. 故障排查：遇到类似问题时，可以：

   • 检查CloudFormation控制台获取详细错误信息
   • 尝试简化配置排除问题
   • 查阅eksctl文档和GitHub issue了解已知问题

总结

这个问题展示了在特定云区域部署时可能遇到的兼容性问题，也提醒我们在使用基础设施即代码工具时需要理解其默认行为。随着eksctl的持续更新，这类区域特定问题有望得到更好的处理。对于关键业务部署，建议在升级工具版本前进行全面测试，并关注项目的更新日志和issue跟踪。