如何将Terraform输出值作为变量传入K8s Spec配置文件

首先明确两个核心问题的结论：

1. 你提到的kubectl apply -f xxx.yml -v variables.json用法原生不存在，kubectl没有内置直接传变量文件替换YAML字段的参数，可通过以下三种成熟方案实现需求，优先级从高到低排序：

方案1：Terraform原生渲染（最推荐，无额外依赖） #

直接用Terraform内置能力完成模板渲染+可选的直接部署，适合希望所有资源统一用Terraform管理的场景。

• 第一步：把现有K8s YAML改为模板文件，比如命名为aws-lb-controller-sa.yaml.tpl，待填充的字段用Terraform插值语法占位：

apiVersion: v1
kind: ServiceAccount
metadata:
  annotations:
    eks.amazonaws.com/role-arn: ${lb_controller_role_arn}
  name: aws-load-balancer-controller
  namespace: kube-system

• 第二步：在Terraform代码中用templatefile函数渲染模板，传入你已经输出的Terraform资源属性，两种落地方式二选一：
  • 方式A：直接用kubernetes_manifest资源部署到EKS集群（需要提前配置好Terraform的kubernetes provider对接EKS）

  resource "kubernetes_manifest" "lb_controller_sa" {
    manifest = templatefile("${path.module}/aws-lb-controller-sa.yaml.tpl", {
      lb_controller_role_arn = aws_iam_role.lb_controller.arn # 替换为你Terraform中对应角色的ARN属性
    })
  }
  

  • 方式B：渲染为本地静态YAML文件，后续自行用kubectl部署

  resource "local_file" "rendered_k8s_manifests" {
    content  = templatefile("${path.module}/aws-lb-controller-sa.yaml.tpl", {
      lb_controller_role_arn = aws_iam_role.lb_controller.arn
    })
    filename = "${path.module}/rendered/aws-lb-controller-sa.yaml"
  }
  

方案2：Terraform输出+YQ批量替换 #

适合希望IaC和K8s资源部署流程完全拆分的场景，仅需额外安装YQ（YAML处理工具），不会破坏原有YAML格式。

• 第一步：导出Terraform所有输出为JSON格式

  terraform output -json > tf_outputs.json
  

• 第二步：用YQ命令直接替换YAML中的对应字段，以你给出的ServiceAccount为例：

  yq eval '.metadata.annotations."eks.amazonaws.com/role-arn" = load("tf_outputs.json").lb_controller_role_arn.value' aws-lb-controller-sa.yaml -i
  

• 第三步：正常执行kubectl apply即可

  kubectl apply -f aws-lb-controller-sa.yaml
  

方案3：配合Kustomize实现原生kubectl兼容的变量替换 #

如果你已经在用Kustomize管理K8s配置，可直接适配现有工作流，Kustomize是kubectl内置组件，无需额外安装。

• 第一步：用Terraform生成Kustomize补丁文件，填入待替换的变量值，比如生成patch-sa.yaml：

  apiVersion: v1
  kind: ServiceAccount
  metadata:
    name: aws-load-balancer-controller
    namespace: kube-system
    annotations:
      eks.amazonaws.com/role-arn: ${lb_controller_role_arn} # 这里用Terraform渲染为实际ARN值
  

• 第二步：在kustomization.yaml中添加补丁配置
• 第三步：直接用kubectl的内置Kustomize能力部署

  kubectl apply -k .
  

方案选择建议 #

• 全栈资源统一运维、希望状态一致：选方案1
• 团队分工明确，IaC和K8s部署由不同角色维护：选方案2
• 已在使用Kustomize管理K8s配置：选方案3

内容的提问来源于stack exchange，提问作者Joey Yi Zhao