如何使用Terraform添加多个已存在的VMware vSphere标签

核心调整思路是将原配置中单值的字符串参数改为集合类型，通过for_each批量查询所有目标标签的ID，最终统一传入资源的tags参数，同时兼容跨分类的多标签场景。

1. 修改变量定义 #

将原来单个标签名、单个分类的字符串变量，替换为映射类型的标签集合变量，以「标签分类名: 该分类下要绑定的标签名列表」的格式存储配置：

# var.tf
variable "vsphere_tags" {
  type        = map(list(string))
  description = "待绑定的vSphere标签集合，格式：标签分类名 = [标签名1, 标签名2]"
  default     = {}
}

2. 调整变量传值（terraform.tfvars） #

按实际要绑定的标签填写配置，支持同时指定多个分类下的多个标签，示例如下：

# terraform.tfvars
vsphere_tags = {
  "业务线分类" = ["电商业务", "核心链路"],
  "环境分类"   = ["生产环境"]
}

3. 修改数据源查询逻辑 #

通过for_each遍历变量批量拉取所有用到的标签分类、对应标签的元数据，不需要为每个标签单独编写数据源块：

# main.tf 数据源块
# 批量查询所有用到的标签分类
data "vsphere_tag_category" "selected" {
  for_each = toset(keys(var.vsphere_tags))
  name     = each.key
}

# 批量查询所有目标标签的ID
data "vsphere_tag" "selected" {
  for_each = {
    for tag_pair in flatten([
      for category_name, tag_names in var.vsphere_tags : [
        for tag_name in toset(tag_names) : {
          category = category_name
          tag      = tag_name
        }
      ]
    ]) : "${tag_pair.category}:${tag_pair.tag}" => tag_pair
  }
  name        = each.value.tag
  category_id = data.vsphere_tag_category.selected[each.value.category].id
}

4. 修改资源的标签绑定参数 #

提取所有查询到的标签ID，组成列表传入资源的tags参数即可：

# main.tf 目标资源（虚拟机/标签绑定资源等）参数
tags = [for tag_data in data.vsphere_tag.selected : tag_data.id]

同分类场景简化方案 #

如果所有待绑定的标签都属于同一个分类，可以不用map结构，进一步简化配置：

# var.tf
variable "vsphere_tag_category" {
  type        = string
  description = "标签所属分类名"
}
variable "vsphere_tag_names" {
  type        = list(string)
  description = "同分类下待绑定的标签名列表"
}

# terraform.tfvars示例
vsphere_tag_category = "环境分类"
vsphere_tag_names    = ["生产环境", "华东区域", "合规等保三级"]

# main.tf数据源
data "vsphere_tag_category" "category" {
  name = var.vsphere_tag_category
}
data "vsphere_tag" "tag" {
  for_each    = toset(var.vsphere_tag_names)
  name        = each.value
  category_id = data.vsphere_tag_category.category.id
}

# 资源标签参数
tags = [for tag in data.vsphere_tag.tag : tag.id]

注意：上述配置中用到的toset方法会自动对标签去重，避免重复传值导致的Terraform运行报错。

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