EKS Anywhere 在受限网络环境下部署失败的解决方案

问题背景

在使用 EKS Anywhere 部署 Kubernetes 集群时，许多企业需要在受限网络环境中进行操作。近期有用户反馈，在这种环境下部署 EKS Anywhere 集群时遇到了控制平面无法就绪的问题，具体表现为 CNI (Cilium) 无法正常初始化。

问题现象

当在以下两种场景下部署 EKS Anywhere 集群时：

1. 直接互联网访问：集群部署成功且运行正常
2. 通过受限网络访问：
   • 虚拟机能够成功启动
   • CNI (Cilium) 无法初始化
   • 控制平面节点持续处于"Not Ready"状态
   • 安装程序在此阶段停滞不前

从日志中可以看到关键错误信息："Container runtime network not ready"和"NetworkPluginNotReady"，这表明容器网络接口未能正确初始化。

根本原因分析

经过 EKS Anywhere 开发团队调查，发现问题的根源在于：

• EKS Anywhere v0.22.0 和 v0.22.1 版本中使用的 Helm 版本存在缺陷
• 这些版本的 Helm 无法正确处理网络配置
• 导致 Helm 无法通过受限网络下载必要的 CNI 组件
• 进而造成 Cilium CNI 无法完成初始化

解决方案

EKS Anywhere 团队在 v0.22.2 版本中修复了此问题，具体措施包括：

1. 将 Helm 版本回退到稳定的 v3.16.4
2. 确保网络配置能够正确传递给 Helm 组件
3. 修复了组件下载过程中的网络处理逻辑

验证结果

用户升级到 EKS Anywhere v0.22.2 后确认：

• 集群能够成功在受限网络环境下部署
• CNI 组件正常初始化
• 控制平面节点能够达到 Ready 状态
• 整个部署流程顺利完成

最佳实践建议

对于需要在受限网络环境下部署 EKS Anywhere 的用户，建议：

1. 始终使用最新稳定版本的 EKS Anywhere
2. 确保网络配置中包含所有必要的域名和 IP 段
3. 特别注意本地网络配置应包含集群内部通信的所有 CIDR
4. 部署前验证网络环境能够访问所有必需的资源

总结

受限网络环境下的 Kubernetes 集群部署往往面临额外的网络挑战。EKS Anywhere 团队通过及时识别和修复 Helm 组件的网络兼容性问题，确保了产品在各种企业网络环境下的可用性。这体现了 EKS Anywhere 对复杂企业部署场景的持续关注和改进。