如何为Terraform aws_eks_node_group创建的EKS节点组传递--kubelet-extra-args参数

结论 #

你没有找错配置位置，aws_eks_node_group原生资源确实没有直接传递--kubelet-extra-args参数的配置项，该需求可以通过为节点组关联自定义启动模板的方式实现。

具体实现步骤 #

1. 创建自定义启动模板资源，在user_data字段中自定义EKS节点启动逻辑，在调用/etc/eks/bootstrap.sh时传入你需要的--kubelet-extra-args参数，示例配置如下：

resource "aws_launch_template" "eks_worker_lt" {
  name_prefix   = "eks-worker-custom"
  image_id      = data.aws_ami.eks_optimized.id # 替换为你使用的对应EKS版本的优化AMI ID
  instance_type = "m5.large" # 替换为你的节点实例规格

  user_data = base64encode(<<-EOF
              MIME-Version: 1.0
              Content-Type: multipart/mixed; boundary="==EKSCONFIG=="

              --==EKSCONFIG==
              Content-Type: text/x-shellscript; charset="us-ascii"

              #!/bin/bash
              /etc/eks/bootstrap.sh ${var.eks_cluster_name} --kubelet-extra-args '--max-pods=110'
              --==EKSCONFIG==--
              EOF
  )
}

注：上述示例中--max-pods=110为适配CNI扩容IP地址场景的常用参数，可根据你的实际需求替换为对应kubelet参数。

2. 在aws_eks_node_group资源配置中关联上述自定义启动模板，替换原来的直接实例规格配置，示例如下：

resource "aws_eks_node_group" "worker_group" {
  cluster_name    = var.eks_cluster_name
  node_group_name = "custom-kubelet-group"
  node_role_arn   = aws_iam_role.eks_node.arn
  subnet_ids      = var.private_subnet_ids

  # 关联自定义启动模板
  launch_template {
    id      = aws_launch_template.eks_worker_lt.id
    version = aws_launch_template.eks_worker_lt.latest_version
  }

  # 其他常规配置（缩放配置、标签、污点等）保持不变
  scaling_config {
    min_size     = 1
    max_size     = 3
    desired_size = 2
  }
}

注意事项 #

• 如果你使用官方EKS优化AMI，上述自定义启动逻辑不会覆盖默认的节点初始化配置，仅会追加你指定的kubelet额外参数。
• 若需要对存量节点组更新该配置，修改启动模板后需要触发节点轮换，新配置才会在新启动的节点上生效。

内容的提问来源于stack exchange，提问作者perdian