Terraform AWS EKS模块：AL2023 AMI用户数据配置变更解析

背景介绍

在使用Terraform AWS EKS模块管理Amazon EKS集群时，许多用户习惯通过pre_bootstrap_user_data参数向节点注入自定义脚本。然而，当从模块版本20.8.5升级到20.9.0时，使用AL2023 AMI类型的用户可能会遇到用户数据被设置为null的问题。

问题本质

这个问题的根源在于Amazon Linux 2023(AL2023)AMI的工作机制与传统Amazon Linux 2 AMI有显著不同。AL2023采用了全新的节点初始化系统，不再支持传统的shell脚本形式的用户数据。

技术细节

AL2023的初始化机制变化

AL2023引入了基于cloud-init和nodeadm的全新节点初始化流程：

1. 不再解析传统的bash脚本形式用户数据
2. 使用YAML格式的配置声明
3. 通过nodeadm API进行节点配置

配置方式的演变

在旧版本Amazon Linux 2中，用户可以通过pre_bootstrap_user_data直接注入bash脚本：

pre_bootstrap_user_data = <<-EOT
  #!/bin/bash
  # 自定义脚本内容
EOT

而在AL2023中，必须使用cloudinit_pre_nodeadm参数，以结构化方式提供配置：

cloudinit_pre_nodeadm = [
  {
    content_type = "application/node.eks.aws"
    content      = <<-EOT
      ---
      apiVersion: node.eks.aws/v1alpha1
      kind: NodeConfig
      spec:
        kubelet:
          config:
            imageGCHighThresholdPercent: 70
            imageGCLowThresholdPercent: 50
    EOT
  }
]

解决方案

1. 使用NodeConfig配置kubelet参数

对于需要调整kubelet配置的场景，可以通过NodeConfig YAML实现：

cloudinit_pre_nodeadm = [
  {
    content_type = "application/node.eks.aws"
    content      = <<-EOT
      ---
      apiVersion: node.eks.aws/v1alpha1
      kind: NodeConfig
      spec:
        kubelet:
          config:
            maxPods: 100
            imageGCHighThresholdPercent: 70
            imageGCLowThresholdPercent: 50
    EOT
  }
]

2. 注入自定义脚本

如果确实需要执行自定义脚本，可以使用multipart cloud-init配置：

cloudinit_pre_nodeadm = [
  {
    content_type = "text/x-shellscript"
    content      = <<-EOT
      #!/bin/bash
      echo "执行自定义脚本"
      # 其他脚本命令
    EOT
  }
]

最佳实践建议

1. 版本兼容性检查：升级模块版本前，仔细检查目标AMI类型的用户数据支持情况
2. 配置验证：通过kubectl检查节点配置是否生效
3. 渐进式迁移：对于生产环境，建议先在测试集群验证配置变更
4. 文档参考：详细阅读AWS官方关于AL2023节点初始化的文档

总结

Terraform AWS EKS模块从20.9.0版本开始，对AL2023 AMI类型的支持更加规范化，强制使用正确的配置方式。这一变更虽然可能带来短期的适配工作，但从长期来看，能够确保节点配置的可靠性和一致性。开发者和运维团队应当理解这一变化的技术背景，及时调整自己的配置策略。