Terraform AWS EKS模块中bootstrap_extra_args配置注意事项

在使用Terraform AWS EKS模块配置Bottlerocket节点组时，一个常见的需求是通过bootstrap_extra_args参数来定制Kubernetes设置。然而，许多用户发现即使配置了该参数，Terraform也不会触发节点更新。本文将深入分析这一现象的原因及解决方案。

问题现象

当用户在EKS模块中为Bottlerocket节点组配置类似以下的bootstrap_extra_args参数时：

bootstrap_extra_args = <<-EOT
  [settings.kubernetes]
  image-gc-high-threshold-percent = 75
  image-gc-low-threshold-percent = 70
EOT

期望Terraform能够识别这些变更并重新创建worker节点，但实际上Terraform计划显示"没有变更需要应用"。

根本原因

这个问题的关键在于use_custom_launch_template参数的设置。当该参数设为false时，模块不会创建自定义启动模板，而是使用EKS管理的默认启动模板。在这种情况下：

1. bootstrap_extra_args参数实际上不会影响现有的启动配置
2. 变更不会触发节点组的更新
3. Terraform无法感知到需要应用的变更

解决方案

要使bootstrap_extra_args生效，必须同时满足以下条件：

1. 将use_custom_launch_template设置为true
2. 确保create_launch_template也为true（或使用现有的自定义启动模板）

正确的配置示例如下：

spot_managed_node_group = {
  bottlerocket_spot_v4 = {
    create_security_group      = false
    create_launch_template     = true   # 必须为true
    use_custom_launch_template = true   # 必须为true

    ami_type = "BOTTLEROCKET_x86_64"
    platform = "bottlerocket"

    bootstrap_extra_args = <<-EOT
      [settings.kubernetes]
      image-gc-high-threshold-percent = 75
      image-gc-low-threshold-percent = 70
    EOT

    # 其他配置...
  }
}

实现原理

当使用自定义启动模板时，模块会：

1. 创建一个新的启动模板版本
2. 将bootstrap_extra_args内容注入到用户数据中
3. 触发节点组更新以使用新的启动模板
4. 最终实现配置变更的应用

最佳实践

1. 对于需要定制化配置的节点组，始终使用自定义启动模板
2. 变更bootstrap_extra_args后，预期会看到节点滚动更新
3. 对于生产环境，考虑使用蓝绿部署策略来最小化服务中断
4. 测试配置变更时，可以先设置desired_size为少量节点

通过理解这一机制，用户可以更有效地管理EKS节点组的配置变更，确保定制参数能够按预期生效。