Terraform部署AWS时重复创建Route 53区域的问题咨询

场景概述 #

使用Terraform模块化部署AWS资源（含EC2、VPC、ALB、CloudFront、WAFv2、Route53），仓库目录结构如下：

.
├── modules
│   ├── acm
│   │   ├── main.tf
│   │   ├── outputs.tf
│   │   └── variables.tf
│   ├── alb
│   │   ├── main.tf
│   │   ├── outputs.tf
│   │   └── variables.tf
│   ├── cloudfront
│   │   ├── main.tf
│   │   └── variables.tf
│   ├── ec2
│   │   ├── main.tf
│   │   ├── outputs.tf
│   │   └── variables.tf
│   ├── jenkins
│   │   ├── main.tf
│   │   ├── outputs.tf
│   │   └── variables.tf
│   ├── route53
│   │   ├── main.tf
│   │   ├── outputs.tf
│   │   └── variables.tf
│   ├── vpc
│   │   ├── main.tf
│   │   ├── outputs.tf
│   │   └── variables.tf
│   └── wafv2
│       ├── main.tf
│       ├── outputs.tf
│       └── variables.tf
├── script
│   ├── app_instance_docker.sh
│   ├── change_ssh_port.sh
│   ├── get_jenkins_password.sh
│   └── jenkins_container.sh
├── .gitignore
├── .terraform.lock.hcl
├── jenkins.tf
├── LICENSE
├── main.tf
├── outputs.tf
├── README.md
├── terraform.tfstate
├── terraform.tfstate.backup
├── terraform.tfvars
└── variables.tf

核心main.tf中Route53相关配置片段：

locals {
  region      = "ap-northeast-2"
  domain_name = "donghyeonporfol.site"
}

# Route 53 module
module "route53" {
  source         = "./modules/route53"
  domain_name    = local.domain_name
  alb_dns_name   = module.alb.alb_dns_name
  alb_zone_id    = module.alb.alb_zone_id
  depends_on     = [module.alb, module.ec2]
}

# ACM certificate creation and validation
module "acm" {
  source         = "./modules/acm"
  domain_name    = local.domain_name
  route53_zone_id = module.route53.zone_id
  ttl            = var.ttl
  depends_on     = [module.route53]
}

遇到的问题：Route53区域被重复创建——初始阶段创建一次，EC2实例创建完成后再次创建，最终生成两个同域名的Route53区域。

问题解答 #

1. 为何Route53区域会被重复创建？ #

• 模块内部资源定义重复：检查modules/route53/main.tf，可能存在多次定义aws_route53_zone资源的情况。
• 状态文件脏数据：本地terraform.tfstate或备份文件中残留了旧的Route53资源记录，导致Terraform无法识别已创建的Zone，重复执行创建逻辑。
• 依赖关系与资源刷新异常：当前Route53模块依赖module.ec2属于不必要约束，可能导致Terraform在资源创建顺序上出现混乱，触发重复创建；或模块内部存在条件判断错误，未正确识别已存在的Zone。
• ACM模块联动问题：如果ACM模块内部默认创建Route53 Zone而非复用已有Zone，会与Route53模块的创建逻辑冲突。

2. 将Route53配置拆分到单独的.tf文件后再执行apply是否为最佳实践？ #

不是。Terraform会自动合并所有.tf文件的配置，拆分文件只是代码组织方式的调整，无法解决重复创建的根本问题。仅当需要按资源类型划分代码结构时，拆分文件是合理的代码组织方式，但与解决重复创建问题无关。

3. 如何确保Route53区域仅创建一次且无需执行两次terraform apply？ #

• 检查并修复Route53模块：打开modules/route53/main.tf，确保仅定义一个aws_route53_zone资源，且以domain_name作为唯一标识，无多余条件创建逻辑。
• 使用数据资源复用已有Zone：在Route53模块中先查询是否存在对应域名的Zone，仅当不存在时才创建：

  data "aws_route53_zone" "existing" {
    name         = var.domain_name
    private_zone = false
  }
  
  resource "aws_route53_zone" "new" {
    count         = data.aws_route53_zone.existing.id == "" ? 1 : 0
    name          = var.domain_name
    tags          = var.tags
  }
  
  output "zone_id" {
    value = data.aws_route53_zone.existing.id != "" ? data.aws_route53_zone.existing.id : aws_route53_zone.new[0].id
  }
  

• 清理不必要的依赖：Route53 Zone的创建无需等待EC2实例，移除module.route53中的depends_on = [module.ec2]约束，避免资源创建顺序混乱。
• 重置状态文件（谨慎操作）：执行terraform state list检查是否存在重复的Route53资源，若有则用terraform state rm移除多余记录，再执行terraform plan确认计划。
• 强制唯一性：确保aws_route53_zone的name参数为固定值，不使用动态生成的名称导致重复。

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