Terraform 与 Kubernetes

这一课你将能做到

1. 配置 Kubernetes Provider，让 Terraform 连上一个真实集群（含 EKS 集群的取凭证方式）
2. 用 Terraform 创建 Namespace、Deployment、Service 等 K8s 对象
3. 划清 Terraform 在 K8s 世界的适用边界，知道哪些对象该交给 Helm 或 GitOps

为什么要学

当团队把 Spring Boot 从 EC2 迁到 Kubernetes，基础设施就分成了两层：集群本身（节点、网络、插件）和集群内的对象（Deployment、Service、Ingress）。Terraform 都能管，但「能管」不代表「都该管」。现实中最常见的架构是：Terraform 建 EKS 集群和引导组件，应用清单走 Helm 或 ArgoCD。理解 Kubernetes Provider 的用法和它的脾气（apply 时序、字段漂移），才能在这种混合架构里不踩坑。

人话：Terraform 是「盖商场 + 装好公共电梯」的施工队；每家店铺（你的应用）怎么摆货架，商场物管（Helm/GitOps）另有流程。施工队可以帮头两家店铺摆，但整层都让它管就别扭了。

先建立图像

Terraform 对接 K8s 的数据流：

kubeconfig（或 EKS 数据源）
        │
        ▼
Kubernetes Provider ──► kubernetes_* 资源（声明对象的期望状态）
                     └─► helm_* 资源（下一课讲）

EKS 场景的典型分工：

Terraform：EKS 控制面 + 节点组 + 集群插件（VPC CNI、CoreDNS）
         + 少量 bootstrap 对象（命名空间、CRD）
Helm/ArgoCD：业务应用的 Deployment/Service/Ingress

跟着做

步骤 1：准备 provider

前提：有一个可用集群并配置好了 kubeconfig（本地可用 kind/minikube 练习）。

versions.tf：

terraform {
  required_version = ">= 1.7.0"

  required_providers {
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "~> 2.25"
    }
  }
}

providers.tf（本地 kubeconfig）：

provider "kubernetes" {
  config_path = "${pathexpand("~/.kube/config")}"
}

执行 terraform init。

步骤 2：创建命名空间

main.tf：

resource "kubernetes_namespace" "app" {
  metadata {
    name = "springboot"
    labels = {
      managed-by = "terraform"
    }
  }
}

先 plan 再 apply：

terraform plan -out=tfplan
terraform apply tfplan

之后 kubectl get ns 能看到 springboot。

步骤 3：部署 Spring Boot 应用

resource "kubernetes_deployment" "app" {
  metadata {
    name      = "springboot-app"
    namespace = kubernetes_namespace.app.metadata[0].name
  }

  spec {
    replicas = 2

    selector {
      match_labels = {
        app = "springboot"
      }
    }

    template {
      metadata {
        labels = {
          app = "springboot"
        }
      }

      spec {
        container {
          name  = "app"
          image = "你的镜像仓库/springboot-app:最新标签"

          port {
            container_port = 8080
          }

          env {
            name  = "SPRING_PROFILES_ACTIVE"
            value = "prod"
          }

          readiness_probe {
            http_get {
              path = "/actuator/health"
              port = 8080
            }
          }
        }
      }
    }
  }
}