Amazon EKS AMI 中 AL2023 节点主机名问题的分析与解决

问题背景

在 Amazon EKS 环境中使用 AL2023 (Amazon Linux 2023) 作为节点操作系统时，当 VPC 配置了自定义 DHCP 选项集来指定域名时，新启动的节点可能会遇到无法加入 Kubernetes 集群的问题。这一问题主要源于 AL2023 节点配置系统中关于主机名处理的变更。

问题表现

当节点启动并尝试加入集群时，kubelet 会记录以下错误日志：

1. 节点尝试以自定义域名注册时被拒绝
2. API 服务器拒绝节点修改请求
3. 无法获取节点信息统计
4. 访问 CSINode 资源时出现权限问题

这些错误表明节点身份识别出现了不一致，系统期望的节点名称与实际注册的名称不匹配。

根本原因

AL2023 节点配置系统原本计划将节点命名约定从 PrivateDnsName 改为使用实例 ID，这一变更带来了下游影响。当 VPC 配置了自定义 DHCP 域名时，系统获取的主机名与实际期望的格式不一致，导致节点身份验证失败。

临时解决方案

在官方修复发布前，可以通过在用户数据中手动设置主机名来解决问题：

TOKEN=$(curl --request PUT "http://169.254.169.254/latest/api/token" --header "X-aws-ec2-metadata-token-ttl-seconds: 10")
ZONE=$(curl http://169.254.169.254/latest/meta-data/placement/region --header "X-aws-ec2-metadata-token: $TOKEN")
IP_BASED_NAME=$(curl http://169.254.169.254/latest/meta-data/hostname --header "X-aws-ec2-metadata-token: $TOKEN" | cut -f1 -d".")
hostnamectl set-hostname --static $IP_BASED_NAME.$ZONE.compute.internal

此脚本通过 EC2 元数据服务获取必要信息，并设置符合 Kubernetes 预期的主机名格式。

官方修复

Amazon EKS 团队已经确认并修复了这一问题，修复内容包含在 2024 年 3 月 15 日发布的 AMI 版本中。用户可以使用以下 AMI 来获得修复：

• AMI ID: ami-07acdbd513e154aa8
• 镜像名称: amazon-eks-node-al2023-x86_64-standard-1.27-v20240315

最佳实践建议

1. 对于生产环境，建议始终使用最新的稳定版 AMI
2. 在升级节点操作系统前，先在测试环境验证兼容性
3. 如果必须使用自定义域名，确保 Kubernetes 节点命名策略与之兼容
4. 监控节点加入过程，及时发现类似认证问题

总结

AL2023 作为 Amazon Linux 的新一代发行版，在 EKS 环境中的应用可能会遇到一些过渡期问题。理解节点身份验证机制和主机名配置的关系，有助于快速诊断和解决类似问题。随着官方修复的发布，用户可以获得更稳定的 AL2023 节点运行体验。