3. Terraform 高级特性：模块化设计、变量与输出、远程状态后端（S3/DynamoDB）

在生产级高可用架构中，Terraform 的简单脚本模式无法满足团队协作、环境隔离与状态安全的需求。本章深入剖析模块化设计、变量与输出机制、远程状态后端三大高级特性，为后续熔断限流自动化部署奠定工程化基础。

3.1 模块化设计：从单体到可复用组件

模块化是 Terraform 实现代码复用与环境隔离的核心手段。一个模块本质上是一个包含多个 .tf 文件的目录，通过封装资源定义、变量和输出，形成可独立部署的单元。

3.1.1 模块结构规范

标准 Terraform 模块遵循以下文件组织约定：

3.1.2 模块调用示例

以下代码展示如何在根模块中调用一个封装了熔断限流组件的子模块：

# 根模块 main.tf
module "circuit_breaker" {
  source = "./modules/circuit-breaker"

  # 输入变量赋值
  service_name    = "payment-api"
  max_requests    = 100
  timeout_seconds = 30
  alert_email     = "sre@example.com"

  # 依赖上游资源
  vpc_id     = aws_vpc.main.id
  subnet_ids = aws_subnet.private[*].id
}

# 子模块 ./modules/circuit-breaker/variables.tf
variable "service_name" {
  description = "熔断器保护的服务名称"
  type        = string
}

variable "max_requests" {
  description = "窗口期内最大请求数"
  type        = number
  default     = 50
}

variable "timeout_seconds" {
  description = "熔断开启后的超时恢复时间"
  type        = number
  default     = 60
}

variable "alert_email" {
  description = "告警接收邮箱"
  type        = string
}

variable "vpc_id" {
  description = "VPC ID"
  type        = string
}

variable "subnet_ids" {
  description = "私有子网 ID 列表"
  type        = list(string)
}

3.2 变量与输出：构建灵活的参数化接口

变量（Variables）和输出（Outputs）是模块与外部世界通信的桥梁。变量让模块可配置，输出让模块可被其他系统消费。

3.2.1 变量类型与验证

Terraform 支持丰富的变量类型和运行时验证，确保输入数据的正确性：

变量验证示例：

variable "max_requests" {
  type        = number
  description = "窗口期内最大请求数，必须大于 0"

  validation {
    condition     = var.max_requests > 0
    error_message = "max_requests 必须为正整数。"
  }

  validation {
    condition     = var.max_requests <= 10000
    error_message = "max_requests 不能超过 10000。"
  }
}

3.2.2 输出值的设计原则

输出值应暴露模块运行后的关键信息，供根模块或其他系统使用：

# outputs.tf
output "circuit_breaker_arn" {
  description = "熔断器资源的 ARN"
  value       = aws_lambda_function.circuit_breaker.arn
}

output "circuit_breaker_endpoint" {
  description = "熔断器检查端点 URL"
  value       = aws_api_gateway_deployment.circuit.invoke_url
}

output "dashboard_url" {
  description = "熔断器监控面板 URL"
  value       = "https://${var.region}.console.aws.amazon.com/cloudwatch/home?region=${var.region}#dashboards:name=${aws_cloudwatch_dashboard.circuit_breaker.dashboard_name}"
}

3.3 远程状态后端：S3 + DynamoDB 实现团队协作

默认的本地状态文件（terraform.tfstate）无法支持多人协作，存在状态冲突、丢失、泄露等风险。远程状态后端通过 S3 存储状态文件，DynamoDB 实现状态锁，是生产环境的标配方案。

3.3.1 架构原理

下图展示了 S3 + DynamoDB 远程状态后端的协作流程：

3.3.2 后端配置实战

以下配置展示如何在 Terraform 中声明 S3 + DynamoDB 远程后端：

# backend.tf
terraform {
  backend "s3" {
    bucket         = "my-company-terraform-state"
    key            = "production/circuit-breaker/terraform.tfstate"
    region         = "us-east-1"
    encrypt        = true
    dynamodb_table = "terraform-state-lock"
  }
}

3.3.3 DynamoDB 锁表创建

DynamoDB 锁表需要提前创建，通常通过独立的 Terraform 配置或 AWS CLI 完成：

# 创建锁表的 Terraform 配置（独立于业务模块）
resource "aws_dynamodb_table" "terraform_lock" {
  name         = "terraform-state-lock"
  billing_mode = "PAY_PER_REQUEST"
  hash_key     = "LockID"

  attribute {
    name = "LockID"
    type = "S"
  }

  tags = {
    Name        = "Terraform State Lock Table"
    Environment = "Global"
    ManagedBy   = "Terraform"
  }
}

3.3.4 状态后端对比

3.4 综合实践：熔断限流模块的完整调用链

将上述三个特性整合，形成熔断限流模块的完整调用链：

1. 模块封装：将熔断器、限流器、监控告警封装为独立子模块，每个模块包含 variables.tf、outputs.tf、main.tf。
2. 变量传递：根模块通过变量注入环境差异（如 environment = "production"、max_requests = 500）。
3. 远程状态：所有模块共享同一个 S3 后端，DynamoDB 确保并发操作安全。
4. 输出消费：根模块收集子模块的输出值，用于生成 CloudWatch Dashboard 或通知下游 CI/CD 系统。