Terraform部署AWS子网时报cidr_block无效索引错误如何解决？

问题根因 #

报错是索引越界导致的，你配置的私有子网创建数量由当前AWS区域的可用区数量决定，但提供的CIDR段数量少于可用区数量：

• 你所在的AWS区域返回了至少6个可用区（报错中count.index最高到5），所以Terraform要创建6个子网
• 你定义的var.cidr_blocks默认只有3个CIDR段，索引仅支持0、1、2，当索引到3、4、5时就找不到对应元素触发报错

修复方案 #

你可以根据自己的需求选择任意一种方案：

方案1：按CIDR段数量创建子网（最通用） #

修改private_subnet/subnets.tf中的子网创建逻辑，有多少个CIDR段就创建多少个子网，避免受区域可用区数量影响：

resource "aws_subnet" "subnet" {
  vpc_id     = var.vpc.id
  # 将count改为取CIDR列表长度
  count      = length(var.cidr_blocks)
  cidr_block = var.cidr_blocks[count.index]

  map_public_ip_on_launch = var.enable_public_ip
  # 用element函数循环取可用区，避免可用区数量少于子网数量时报错
  availability_zone_id    = element(data.aws_availability_zones.available_az.zone_ids, count.index)

  tags = {
    Name        = "${terraform.workspace}-${var.name}-subnet-${count.index}"
    Environment = terraform.workspace
  }
}

方案2：补充CIDR段匹配可用区数量 #

如果你需要为每个可用区都创建私有子网，就修改private_subnet/variables.tf中cidr_blocks的默认值，补充对应数量的不冲突CIDR段，和你所在区域的可用区数量保持一致即可。

方案3：限制使用的可用区数量 #

如果你只需要使用部分可用区，修改aws_availability_zones数据源返回的可用区数量，比如限制为3个：

data "aws_availability_zones" "available_az" {
  state = "available"
}
# 取前3个可用区作为可用列表
locals {
  allowed_az_ids = slice(data.aws_availability_zones.available_az.zone_ids, 0, 3)
}

resource "aws_subnet" "subnet" {
  vpc_id     = var.vpc.id
  count      = length(local.allowed_az_ids)
  cidr_block = var.cidr_blocks[count.index]

  map_public_ip_on_launch = var.enable_public_ip
  availability_zone_id    = local.allowed_az_ids[count.index]

  tags = {
    Name        = "${terraform.workspace}-${var.name}-subnet-${count.index}"
    Environment = terraform.workspace
  }
}

额外优化建议 #

你variables.tf中声明的list类型建议补充元素类型，避免后续版本的类型校验报错，比如：

variable "external_ip_list" {
  type        = list(string)
  description = "The ip that is allowed to talk to the nodes from external."
}

variable "cidr_blocks" {
  type    = list(string)
  default = ["172.xx.x.x/xx", "172.xx.xx.x/xx", "172.xx.xx.x/xx"]
}

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