Terraform AWS子模块跨区域Provider配置警告问题排查

核心结论 #

Provider配置全部放在根模块，子模块仅通过required_providers声明依赖的Provider别名，不编写任何provider块，完全符合Terraform模块最佳实践，同时满足你的区域需求。

解决警告&实现需求的步骤 #

1. 子模块添加required_providers声明

在子模块的terraform.tf文件中，明确声明需要默认AWS Provider和us-east-1别名Provider：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = ">= 5.0.0" # 根据实际项目需求指定版本范围
    }
    aws.us-east-1 = {
      source  = "hashicorp/aws"
      version = ">= 5.0.0"
    }
  }
}

这一步是消除警告的关键，告诉Terraform子模块明确依赖这两个Provider配置。

2. 子模块资源的Provider绑定

• ACM证书资源保持现有配置，指定provider = aws.us-east-1，确保部署在us-east-1：

  resource "aws_acm_certificate" "site" {
    provider          = aws.us-east-1
    domain_name       = aws_route53_zone.site.name
    validation_method = "DNS"
    subject_alternative_names = [
      "*.${aws_route53_zone.site.name}"
    ]
  
    lifecycle {
      create_before_destroy = true
    }
  }
  

• 子模块中其他资源（S3、CloudFront、Route53等）不要指定provider参数，这样会自动使用根模块传递的默认AWS Provider（us-east-2区域）。

3. 根模块调用子模块时传递完整Provider

更新根模块的模块调用块，同时传递默认Provider和us-east-1别名Provider：

module "static_site_mydomain_com" {
  source = "github.com/myname/terraform-aws-static-site"

  providers = {
    aws           = aws           # 传递默认us-east-2的Provider配置
    aws.us-east-1 = aws.us-east-1 # 传递us-east-1的别名Provider配置
  }

  # 其他模块自定义参数...
}

为什么这样配置 #

• 根模块集中管理所有Provider配置，方便统一调整区域、凭证、默认标签等，避免子模块重复配置。
• 子模块仅声明依赖，保持模块的通用性，调用方可以灵活传递不同区域的Provider适配不同场景。
• 严格区分资源区域：默认资源自动使用us-east-2，ACM证书强制使用us-east-1，完全匹配你的需求。

内容的提问来源于stack exchange，提问作者Logan M.