如何在循环中调用Terraform模块并传递列表参数？

核心问题原因 #

你遇到的问题是因为重复使用相同的模块逻辑名称定义多个模块块，Terraform要求每个模块的逻辑名称在配置中唯一。正确的做法是通过count或for_each参数在单个模块块中生成多个实例，而非手动编写重复的模块调用块。

解决方案1：使用count（适合有序列表场景） #

如果输入是普通列表，用count配合列表索引生成唯一模块实例：

1. 定义输入变量：

variable "service_instances" {
  type        = list(string)
  description = "要部署的服务实例名称列表"
  default     = ["auth-service", "user-service", "pay-service"]
}

2. 模块调用配置：

module "service" {
  # 根据列表长度生成对应数量的模块实例
  count = length(var.service_instances)
  
  source = "./modules/service"

  # 将列表对应索引的元素传递给模块
  instance_name = var.service_instances[count.index]
  # 其他模块参数示例：按索引偏移端口
  service_port = 8080 + count.index
}

Terraform会自动生成唯一实例标识：module.service[0]、module.service[1]等，彻底避免名称冲突。

解决方案2：使用for_each（适合有唯一键的场景） #

如果输入是集合（set）或映射（map），推荐用for_each，它以元素值或键作为实例标识，比count更直观，还能避免列表顺序变化导致的资源重建：

1. 定义变量（用set确保元素唯一）：

variable "service_instances" {
  type        = set(string)
  description = "要部署的服务实例名称集合"
  default     = ["auth-service", "user-service", "pay-service"]
}

2. 模块调用配置：

module "service" {
  # 遍历集合中的每个元素
  for_each = var.service_instances
  
  source = "./modules/service"

  # 直接传递当前遍历的元素值给模块
  instance_name = each.value
  service_port  = 8080 + index(var.service_instances, each.value)
}

此时模块实例标识为module.service["auth-service"]、module.service["user-service"]，可读性更强，删除集合元素时只会销毁对应实例，不影响其他资源。

关键注意事项 #

模块内部的资源也要确保名称唯一，避免实例间资源冲突。比如模块内的云资源名称要使用传入的instance_name参数：

# ./modules/service/main.tf
resource "aws_instance" "service" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"

  tags = {
    Name = var.instance_name
  }
}

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