Amazon EKS AMI 中 c7i-flex 实例类型缺失导致节点无法加入集群问题分析

问题背景

在使用 Amazon EKS 服务时，部分用户遇到了基于 c7i-flex 系列实例类型的节点无法正常加入 Kubernetes 集群的问题。这个问题主要出现在用户自定义构建的 AMI（Amazon Machine Image）中，特别是基于 Ubuntu 22.04 的自定义"Golden AMI"。

问题现象

当用户尝试使用 c7i-flex.large 等 c7i-flex 系列实例类型启动节点时，节点初始化过程中会出现以下错误：

1. 在 /var/log/cloud-init-output.log 中显示脚本执行失败
2. 在 /var/log/user-data.log 中出现关键错误信息：

   No entry for type 'c7i-flex.large' in /etc/eks/eni-max-pods.txt. Will attempt to auto-discover value.
   /etc/eks/max-pods-calculator.sh: line 41: a1.2xlarge: command not found
   

根本原因

经过分析，该问题主要由以下因素导致：

1. eni-max-pods.txt 文件缺失 c7i-flex 实例类型配置：Amazon EKS AMI 中的 /etc/eks/eni-max-pods.txt 文件未包含 c7i-flex 系列实例类型的网络接口和最大 Pod 数量配置。

2. 自动发现机制失败：当配置文件中找不到对应实例类型时，系统会尝试自动发现值，但在这个过程中脚本出现了语法错误，导致整个初始化过程失败。

3. 自定义 AMI 的兼容性问题：用户自定义构建的 AMI 可能没有及时更新最新的 EKS 组件和配置文件，导致与新发布的实例类型不兼容。

解决方案

针对这个问题，Amazon EKS 团队已经发布了修复方案：

1. 更新 eni-max-pods.txt 文件：确保文件中包含 c7i-flex 系列实例类型的配置项。

2. 修正 max-pods-calculator.sh 脚本：修复脚本中的语法错误，确保自动发现机制能够正常工作。

3. 更新自定义 AMI：对于使用自定义 AMI 的用户，建议：

   • 更新 AMI 中的 EKS 相关组件
   • 确保使用最新版本的 eni-max-pods.txt 和 max-pods-calculator.sh 文件
   • 测试新 AMI 与各种实例类型的兼容性

最佳实践建议

为了避免类似问题，建议 EKS 用户：

1. 定期更新 AMI：无论是使用 Amazon 官方提供的 EKS 优化 AMI 还是自定义 AMI，都应定期更新以获取最新的兼容性修复。

2. 测试新实例类型：在将新实例类型投入生产环境前，先在测试环境中验证其与现有配置的兼容性。

3. 监控节点加入过程：设置适当的监控和告警机制，及时发现节点加入失败的情况。

4. 保持组件一致性：确保所有节点使用相同版本的 EKS 组件和配置文件，避免因版本不一致导致的问题。

总结

c7i-flex 实例类型节点无法加入 EKS 集群的问题展示了基础设施即代码环境中版本管理和兼容性的重要性。通过及时更新组件和配置文件，用户可以避免这类问题，确保集群的稳定运行。对于使用自定义 AMI 的高级用户，建立完善的 AMI 更新和测试流程尤为重要。