多应用目录场景下Terraform main.tf组织及批量部署最佳实践

是否可以在现有main.tf实现所有应用统一部署？ #

完全可以。你可以通过Terraform的Kubernetes Provider结合kubernetes_manifest资源，在同一个配置文件内完成GKE集群创建+3个应用的统一部署，不需要额外的部署工具。

具体实现参考代码 #

你可以在原有main.tf补充以下内容即可实现统一部署：

# 声明依赖的Provider
terraform {
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "~> 4.0"
    }
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "~> 2.0"
    }
  }
}

provider "google" {
  project = "test"
  region  = "us-central1" # 按需替换为实际使用的区域
}

# 原有GKE集群资源
resource "google_container_cluster" "test_cluster" {
  project = "test"
  name     = "test-cluster"
  initial_node_count       = 1
}

# 配置Kubernetes Provider关联刚创建的GKE集群
provider "kubernetes" {
  host  = google_container_cluster.test_cluster.endpoint
  token = google_container_cluster.test_cluster.access_token
  cluster_ca_certificate = base64decode(google_container_cluster.test_cluster.master_auth[0].cluster_ca_certificate)
}

# 批量加载3个应用的部署清单
locals {
  app_list = ["app-1", "app-2", "app-3"]
}

resource "kubernetes_manifest" "app_deployment" {
  for_each = toset(local.app_list)
  manifest = yamldecode(file("../${each.value}/kubernetes_manifest/deployment.yaml"))
}

*如果应用目录下还有Service、Ingress等其他Kubernetes资源，你可以用fileset函数批量读取指定目录下的所有YAML文件实现批量部署，不需要逐个声明资源。

多应用场景下Terraform配置的最佳实践 #

• 逻辑分层拆分，不要把所有配置都堆叠到单个main.tf里，建议拆分规则：
  • 基础设施层：单独管理GKE集群、节点池、VPC等底层资源，配置放在独立的infra/目录维护
  • 应用部署层：所有应用的部署配置放在独立的apps/目录，每个应用可以单独封装为Terraform Module，方便后续单独更新、扩缩容
• 配置分离：新增variables.tf存放所有可配置参数（比如项目ID、区域、镜像版本等），新增outputs.tf输出集群访问地址、应用域名等关键信息，避免硬编码
• 显式声明依赖：应用部署资源要显式依赖集群创建完成，避免集群还未初始化完成就触发应用部署导致报错
• 远程状态管理：使用GCS等远程存储保存Terraform状态文件，不要本地存储，避免多人协作时出现状态冲突
• 版本锁定：Terraform版本、各Provider版本都显式锁定，避免不同环境版本不一致导致的配置失效

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