2. Terraform 核心概念回顾：Provider、Resource、Data Source、State、Module，以及它们在服务目录中的角色

在深入服务目录执行效率优化之前，必须重新校准对 Terraform 五大核心概念的理解。服务目录的本质是将这些概念以标准化、可复用的方式组织起来，形成企业级基础设施交付的“乐高积木”。

2.1 五大核心概念速览

2.2 Provider：服务目录的适配层

Provider 是 Terraform 与外部 API 之间的桥梁。在服务目录中，Provider 决定了目录的“能力边界”。

• 版本锁定：服务目录必须锁定 Provider 版本，避免上游 API 变更导致目录执行失败。
• 多 Provider 编排：一个服务目录模块可以同时使用 AWS、Azure 和 Datadog Provider，实现跨云资源编排。
• Provider 别名：通过 provider = aws.west 实现同一模块在不同区域部署。

2.3 Resource 与 Data Source：原子单元与上下文感知

Resource 是 Terraform 声明式配置的核心。每个 resource 块对应一个真实基础设施对象。在服务目录中，Resource 是“交付物”的最小粒度。

Data Source 则用于查询外部信息，不创建或管理任何资源。在服务目录中，Data Source 用于动态获取环境上下文：

• 查询现有 VPC ID 以部署新资源
• 获取当前 AWS 账号 ID 用于标签策略
• 读取 Secrets Manager 中的数据库密码

# 服务目录中典型的 Data Source + Resource 组合
data "aws_vpc" "selected" {
  tags = {
    Environment = "production"
  }
}

resource "aws_subnet" "app" {
  vpc_id     = data.aws_vpc.selected.id
  cidr_block = "10.0.1.0/24"
}

2.4 State：服务目录的一致性保障

State 文件是 Terraform 的“真相来源”。在服务目录场景中，State 管理直接决定了目录的可靠性和团队协作效率。

2.5 Module：服务目录的封装单元

Module 是 Terraform 复用的核心机制。在服务目录中，每个“产品”本质上就是一个经过严格测试、版本化、文档化的 Module。

• 输入变量：定义目录产品的配置参数（实例规格、网络 CIDR、标签等）
• 输出变量：暴露目录产品的交付结果（IP 地址、ARN、连接字符串等）
• 本地变量：封装内部计算逻辑，简化目录消费者的使用

# 服务目录模块的标准结构
module "web_app" {
  source = "git::https://gitlab.example.com/catalog/web-app-module?ref=v1.2.0"

  app_name    = "myapp"
  environment = "staging"
  instance_type = "t3.medium"
  vpc_id      = data.aws_vpc.selected.id

  # 通过变量控制目录行为
  enable_auto_scaling = true
  min_capacity        = 2
  max_capacity        = 10
}

2.6 核心概念在服务目录中的协作关系

下图展示了五大核心概念在服务目录执行流程中的协作关系：

2.7 服务目录中的概念分层模型

从服务目录架构视角，可以将五大概念分为三个层次：

1. 消费者层：Module —— 目录产品的唯一入口，消费者只需关心输入输出
2. 编排层：Resource + Data Source —— 定义“做什么”和“依赖什么”
3. 基础设施层：Provider + State —— 定义“怎么做”和“当前状态是什么”