Terraform AWS EKS 模块中自定义 AMI 的使用实践

在 AWS EKS 环境中，使用自定义 AMI 镜像是一个常见的需求，特别是当企业需要预装特定软件或进行安全加固时。本文将深入探讨如何在 Terraform AWS EKS 模块中正确配置自定义 AMI，特别是针对 Amazon Linux 2023 (AL2023) 操作系统的场景。

自定义 AMI 的基础配置

在 EKS 模块中，当需要使用自定义 AMI 时，最基本的配置方式是设置 ami_type = "CUSTOM" 并指定 AMI ID。这种配置适用于基于 Amazon Linux 2 的自定义镜像：

eks_managed_node_groups = {
  custom_node = {
    ami_type = "CUSTOM"
    ami_id   = "ami-xxxxxxxxxxxxxxxxx"
    enable_bootstrap_user_data = true
  }
}

这种配置下，模块会自动生成适合 Amazon Linux 2 的引导用户数据，包括调用 /etc/eks/bootstrap.sh 脚本。

AL2023 的特殊处理

随着 Amazon Linux 2023 的推出，EKS 节点引导机制发生了变化，不再使用传统的 bootstrap.sh 脚本，而是采用了基于 nodeadm 的新方式。当使用基于 AL2023 的自定义 AMI 时，需要特别注意以下几点：

1. 正确的 AMI 类型指定：不应使用 CUSTOM 类型，而应明确指定为 AL2023_x86_64_STANDARD

2. 用户数据格式：AL2023 使用 multipart MIME 格式的用户数据，包含 NodeConfig YAML 文档

3. 自定义脚本注入：通过 cloudinit_pre_nodeadm 参数添加自定义初始化脚本

推荐配置方案

对于基于 AL2023 的自定义 AMI，推荐使用以下配置模式：

eks_managed_node_groups = {
  al2023_node = {
    ami_type = "AL2023_x86_64_STANDARD"
    ami_id   = "ami-xxxxxxxxxxxxxxxxx"
    
    enable_bootstrap_user_data = true
    
    cloudinit_pre_nodeadm = [
      {
        content_type = "text/x-shellscript; charset=\"us-ascii\""
        content = templatefile("${path.module}/custom_init.sh.tpl", {
          # 模板变量
        })
      }
    ]
  }
}

关键注意事项

1. 用户数据模板：模块会自动处理 NodeConfig YAML 的生成，开发者只需关注自定义脚本部分

2. 脚本内容类型：必须正确指定为 text/x-shellscript 并设置字符集

3. AMI 兼容性：自定义 AMI 必须基于官方的 EKS 优化 AMI 构建，确保包含必要的组件

4. 调试技巧：节点启动后检查 /var/lib/cloud/instance/user-data.txt 验证用户数据是否正确应用

常见问题解决

如果遇到节点无法加入集群的问题，建议按以下步骤排查：

1. 确认 AMI 确实基于 AL2023 的 EKS 优化镜像构建
2. 检查用户数据是否包含完整的 multipart MIME 结构
3. 验证 NodeConfig 中的集群信息是否正确
4. 查看 /var/log/cloud-init-output.log 获取初始化日志

通过正确理解 EKS 模块中 AMI 类型的处理逻辑，开发者可以灵活地使用自定义 AMI 同时确保节点能够成功加入 EKS 集群。对于 AL2023 这类新平台，特别需要注意其与传统 Linux 发行版在引导机制上的差异。