如何不重复代码即可为Terraform配置Localstack和AWS双Provider？

核心实现思路 #

通过变量动态关联Provider + 环境区分逻辑，即可完全复用现有资源代码，无需重复编写资源配置，具体配置步骤如下：

步骤1：新增环境类型控制变量 #

在variables.tf中添加变量用于切换Provider：

variable "environment_type" {
  type        = string
  description = "运行环境，可选值：real（真实AWS）、local（Localstack）"
  default     = "real"
}

步骤2：动态绑定Provider到资源 #

方案A：资源直接绑定（适合资源量少、无模块封装的场景） #

现有所有AWS资源块不需要修改原有配置，仅需新增1行Provider动态关联逻辑即可，示例如下：

resource "aws_dynamodb_table" "test_table" {
  # 原有资源配置完全不变
  name         = "test-data-table"
  billing_mode = "PAY_PER_REQUEST"
  hash_key     = "uid"
  attribute {
    name = "uid"
    type = "S"
  }

  # 仅新增下面这一行动态指定Provider
  provider = var.environment_type == "local" ? aws.fake : aws.real
}

方案B：模块层级绑定（适合资源多、用模块封装的场景） #

如果你的资源统一封装在子模块中，只需要在根模块调用子模块时动态传递Provider即可，所有子模块内的资源不需要做任何修改：

module "business_service" {
  source = "./modules/biz-service"
  # 原有传递给模块的变量完全不变
  region = local.aws_region

  # 仅新增下面的Provider动态绑定逻辑
  providers = {
    aws = var.environment_type == "local" ? aws.fake : aws.real
  }
}

步骤3：运行时切换环境 #

方式1：执行命令时传参指定 #

跑Localstack校验测试时执行：

terraform plan -var="environment_type=local"
terraform apply -var="environment_type=local"

校验通过要部署到真实AWS时执行：

terraform plan -var="environment_type=real"
terraform apply -var="environment_type=real"

方式2：绑定Terraform Workspace自动切换 #

可以为本地测试和真实环境分别创建Workspace，通过Workspace名称自动匹配Provider，不用每次传参：

# 添加到locals配置块中
locals {
  environment_type = terraform.workspace == "local" ? "local" : "real"
}

后续只需要切换Workspace就会自动选用对应Provider：

# 切换到本地测试环境
terraform workspace select local
terraform plan # 自动使用Localstack的fake Provider

# 切换到生产环境
terraform workspace select prod
terraform plan # 自动使用真实AWS的real Provider

注意事项 #

如果需要适配更多Localstack支持的AWS服务，直接在fake Provider的endpoints配置块中新增对应服务的Localstack地址即可，其他所有资源代码都不需要调整。

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