如何通过命令行变量动态修改Terragrunt的S3后端Bucket及路径？

给你几个可行的实现方案，解决Terragrunt remote_state配置无法直接用命令行-var覆盖的问题：

方案1：用环境变量传递动态值 #

Terragrunt支持通过get_env()函数读取环境变量，我们可以把bucket和key的动态值放在环境变量里，配置文件里做默认 fallback：

修改你的terragrunt.hcl：

remote_state {
  backend = "s3"
  config = {
    bucket  = get_env("TG_BACKEND_BUCKET", "bucket-name")
    key     = "${get_env("TG_BACKEND_KEY_PREFIX", local.cluster_name)}/${path_relative_to_include()}/terraform.tfstate"
    region  = "us-east-1"
    encrypt = true
  }
  generate = {
    path      = "backend.tf"
    if_exists = "overwrite_terragrunt"
  }
}

执行命令时直接设置环境变量：

TG_BACKEND_BUCKET=my-custom-bucket TG_BACKEND_KEY_PREFIX=my-custom-path terragrunt run-all apply

方案2：用Terragrunt变量+--terragrunt-var传递 #

先在terragrunt.hcl里定义变量，再在remote_state中引用，这样就能用Terragrunt专属的--terragrunt-var参数传递值：

1. 在配置文件顶部添加变量定义：

variable "backend_bucket" {
  type    = string
  default = "bucket-name"
}

variable "backend_key_prefix" {
  type    = string
  default = local.cluster_name
}

2. 修改remote_state配置引用变量：

remote_state {
  backend = "s3"
  config = {
    bucket  = var.backend_bucket
    key     = "${var.backend_key_prefix}/${path_relative_to_include()}/terraform.tfstate"
    region  = "us-east-1"
    encrypt = true
  }
  generate = {
    path      = "backend.tf"
    if_exists = "overwrite_terragrunt"
  }
}

3. 执行命令时用--terragrunt-var传递：

terragrunt run-all apply --terragrunt-var "backend_bucket=my-custom-bucket" --terragrunt-var "backend_key_prefix=my-custom-path"

方案3：临时配置文件覆盖（一次性场景） #

如果只是临时改一次，可以创建一个临时的配置片段，执行时和原配置合并：

1. 创建override.hcl文件：

remote_state {
  config = {
    bucket = "my-custom-bucket"
    key    = "my-custom-path/${path_relative_to_include()}/terraform.tfstate"
  }
}

2. 执行命令时用--terragrunt-config合并两个文件：

terragrunt run-all apply --terragrunt-config <(cat terragrunt.hcl override.hcl)

各方案优缺点 #

• 环境变量：操作简单，适合CI/CD流水线，不用改太多配置
• Terragrunt变量：符合Terraform生态的变量规范，类型安全，适合长期维护的场景
• 临时配置文件：适合一次性临时调整，完全不改动原有配置

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