Terraform AWS EKS模块中EC2实例标签传递问题解析

问题背景

在使用Terraform AWS EKS模块(v20.13.1)部署Kubernetes集群时，许多开发者会遇到一个常见问题：为EKS托管节点组(managed node groups)配置的标签无法正确传递到实际的EC2实例上。这个问题看似简单，但实际上涉及AWS EKS架构中标签传递的机制。

问题现象

开发者在eks_managed_node_groups配置块中设置了如下标签：

tags = {
  "tag1" = "test1"
  "tag2" = "test2"
  "tag3" = "test3"
  "propagate_at_launch" = true
}

同时也在launch_template_tags中配置了类似的标签。这些标签在EKS控制台和节点组中可见，但在实际创建的EC2实例上却缺失了。

根本原因

问题的核心在于配置中设置了use_custom_launch_template = false。这个设置导致模块不会创建自定义启动模板(Launch Template)，而AWS EKS托管节点组默认情况下不会自动将节点组级别的标签传播到EC2实例。

解决方案

要解决这个问题，有以下两种方法：

1. 启用自定义启动模板(推荐)

use_custom_launch_template = true

2. 或者完全移除该参数，因为模块默认值就是true

技术原理

在AWS EKS架构中，启动模板是控制EC2实例创建的核心配置。当使用自定义启动模板时：

• Terraform会创建一个专门的启动模板资源
• 所有配置的标签会被明确地包含在启动模板中
• 当节点组使用这个启动模板创建EC2实例时，标签会被正确应用

相比之下，当禁用自定义启动模板时，EKS会使用内部默认模板，这些模板不包含用户自定义的标签配置。

最佳实践

1. 始终使用自定义启动模板：这提供了对EC2实例配置的最大控制权

2. 标签传播策略：

   • 对于需要出现在EC2实例上的标签，确保它们同时配置在tags和launch_template_tags中
   • propagate_at_launch参数应设置为true

3. 版本兼容性检查：不同版本的Terraform AWS EKS模块可能有不同的默认行为，升级时要特别注意

总结

在Terraform AWS EKS模块中正确传递标签到EC2实例的关键在于理解和使用自定义启动模板机制。通过启用use_custom_launch_template，开发者可以确保所有配置的标签都能正确应用到实际的EC2实例上，这对于资源管理、成本分配和自动化运维都至关重要。