同配置多实例场景下Terraform Remote StateFile按客户拆分方案咨询

Terragrunt完全可以满足该场景需求，核心是利用Terragrunt的动态路径插值能力自动生成每个客户环境独立的远端state key，无需依赖Terraform Enterprise/Cloud。

配置调整步骤 #

• 先删除模块仓库根目录下的terragrunt.hcl文件，所有Terragrunt配置统一放到变量仓库中，避免模块与业务配置耦合。
• 在变量仓库的根目录新增全局terragrunt.hcl，配置通用的远端状态规则，以GCS backend为例（适配你使用的GCP资源）：

remote_state {
  backend = "gcs"
  config = {
    bucket = "提前创建好的GCS存储桶名称，确保权限配置正确"
    # 自动取当前客户环境目录的相对路径作为state前缀，实现每个环境state完全隔离
    prefix = "terraform/state/${path_relative_to_include()}"
  }
  generate = {
    path      = "backend.tf"
    if_exists = "overwrite_terragrunt"
  }
}

• 调整每个客户环境目录下的terragrunt.hcl，仅保留根配置引用、模块地址和差异化变量即可，无需重复配置backend：

# 继承根目录的全局配置
include "root" {
  path = find_in_parent_folders()
}

terraform {
  # 填写你的模块仓库地址，支持本地路径或Git地址
  source = "你的模块仓库地址//?ref=对应版本号"
}

# 每个客户的差异化配置，对应模块定义的变量
inputs = {
  subnet_id     = "当前客户环境对应的子网ID"
  disk_count    = 2
  disk_size_gb  = 100
  os_image      = "debian-cloud/debian-11"
  instance_count = 3 # 可统一配置也可按客户单独调整
}

• 验证配置：进入任意客户环境目录执行terragrunt init，Terragrunt会自动生成该环境独有的backend.tf文件，state会自动上传到GCS存储桶对应路径下，完全隔离不同客户的状态。你也可以执行terragrunt run-all plan/apply批量操作所有客户环境，符合原有使用习惯。

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