为EC2节点启动模板加标签时Terraform类型错误排查

问题场景 #

尝试给EC2节点通过ASG动态打标，合并本地标签实现自定义命名和标记。模块内硬编码标签时正常运行，但使用动态标签并合并本地标签后，执行terraform validate报错。

相关配置 #

模块代码（modules/ecs/main.tf）

resource "aws_autoscaling_group" "ecs_asg" {
  name                      = var.name_asg
  max_size                  = var.max_size
  min_size                  = var.min_size
  ...
  service_linked_role_arn   = var.service_linked_role_arn
  tags = var.asg_tags
  launch_template {
    id      = aws_launch_template.launch_template.id
    version = "$Latest"
  }
}

模块变量定义（modules/ecs/variables.tf）

variable "asg_tags" {
  type = map(string)
  default = {}
}

主配置（main.tf）

module "ecs" {
  ...
  name_asg                  = "leo-nombre-asg"
  max_size                  = var.max_size
  min_size                  = var.min_size
  ...
  asg_tags = merge(
    local.tags,
    {
      propagate_at_launch=true,
    },
  )
}

本地标签（locals.tf）

locals {
  tags = {
    "Accountable" = "business"
    "Deploy"      = "terraform"
    "Role"        = "services"
  }
}

错误信息 #

│ Error: Incorrect attribute value type
│
│ on modules\ecs\main.tf line 38, in resource "aws_autoscaling_group" "ecs_asg":
│ 38: tags = var.asg_tags
│ ├────────────────
│ │ var.asg_tags is a map of string
│
│ Inappropriate value for attribute "tags": set of map of string required.

错误原因 #

AWS Autoscaling Group的tags属性要求的是集合类型的字符串映射（set(map(string))），每个标签项必须包含key、value、propagate_at_launch三个字段；而当前定义的var.asg_tags是普通的键值对映射（map(string)），类型完全不匹配，导致校验失败。

解决方案 #

1. 调整模块变量类型 #

修改模块内的variables.tf，将asg_tags的类型改为set(map(string))：

variable "asg_tags" {
  type = set(map(string))
  default = []
}

2. 转换标签格式后传入模块 #

在主配置main.tf中，将合并后的本地标签转换成ASG要求的集合格式，每个标签项补充propagate_at_launch字段：

module "ecs" {
  ...
  name_asg                  = "leo-nombre-asg"
  max_size                  = var.max_size
  min_size                  = var.min_size
  ...
  asg_tags = [
    for k, v in local.tags : {
      key                 = k
      value               = v
      propagate_at_launch = true
    }
  ]
}

如果需要给不同标签设置不同的propagate_at_launch值，可以单独定义：

asg_tags = [
  {
    key                 = "Accountable"
    value               = "business"
    propagate_at_launch = true
  },
  {
    key                 = "Deploy"
    value               = "terraform"
    propagate_at_launch = false
  },
  ...
]

3. 验证修改 #

执行terraform validate，确认类型匹配错误消失；再执行terraform plan检查标签配置是否符合预期。

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