Terraform main模块模式下多环境共享资源配置问题

针对你用独立环境目录调用根main模块时，共享资源重复创建的问题，核心原因是每个环境的Terraform状态完全独立——当main模块包含共享资源定义时，每个环境都会尝试创建属于自己的副本。下面是具体解决步骤：

1. 重构目录结构，拆分共享资源 #

把VNET这类跨环境共享的资源从根main模块中剥离，单独做成共享模块，并创建独立的共享资源部署环境：

.
├── modules/
│   ├── main/          # 原业务模块（移除共享资源定义）
│   │   └── main.tf
│   └── shared/        # 共享资源模块
│       └── vnet/
│           └── main.tf
├── environments/
│   └── shared/        # 共享资源专属部署环境，单独维护状态
│       └── main.tf
└── clients/
    ├── client1/
    │   └── client1.tf
    └── client2/
        └── client2.tf

2. 编写共享资源模块 #

在modules/shared/vnet/main.tf中定义共享资源，并输出需要被其他环境引用的属性：

resource "azurerm_virtual_network" "shared_vnet" {
  name                = "shared-vnet"
  address_space       = ["10.0.0.0/16"]
  location            = var.location
  resource_group_name = var.resource_group_name
}

resource "azurerm_subnet" "shared_subnet" {
  name                 = "shared-subnet"
  resource_group_name  = var.resource_group_name
  virtual_network_name = azurerm_virtual_network.shared_vnet.name
  address_prefixes     = ["10.0.1.0/24"]
}

output "vnet_id" {
  value = azurerm_virtual_network.shared_vnet.id
}

output "subnet_id" {
  value = azurerm_subnet.shared_subnet.id
}

3. 单独部署共享资源 #

在environments/shared/main.tf中调用共享模块，配置共享资源的固定参数：

module "shared_vnet" {
  source              = "../../modules/shared/vnet"
  location            = "eastus"
  resource_group_name = "shared-resources-rg"
}

执行部署命令，让共享资源拥有独立的状态文件：

terraform -chdir="./environments/shared" init
terraform -chdir="./environments/shared" apply

4. 在业务环境中引用共享资源 #

以clients/client1/client1.tf为例，通过状态数据源读取共享资源的状态，传递给业务模块：

# 读取共享资源的本地状态（生产环境推荐用远程状态，替换为terraform_remote_state）
data "terraform_state" "shared" {
  backend_type = "local"
  config = {
    path = "../../environments/shared/terraform.tfstate"
  }
}

# 调用业务模块，传入共享资源属性
module "client1_workload" {
  source = "../../modules/main"
  
  vnet_id    = data.terraform_state.shared.outputs.vnet_id
  subnet_id  = data.terraform_state.shared.outputs.subnet_id
  # 其他业务环境专属参数...
}

如果用远程状态（如AWS S3、Azure Blob Storage），使用terraform_remote_state数据源可避免本地状态文件的路径依赖问题。

关键注意事项 #

• 共享资源必须单独部署、单独维护状态，绝对不能和业务环境的状态混在一起
• 业务模块只负责创建当前环境的专属资源，共享资源通过引用接入，而非在模块内重复定义
• 所有业务环境必须指向同一个共享资源状态源，确保引用的是同一个资源实例

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