2. Terraform 基础回顾：Provider、Resource、Data Source、State、Module 核心概念

在构建 SLI 口径采集管线之前，必须牢固掌握 Terraform 的五大核心抽象。这些抽象构成了声明式基础设施管理的全部基础，也是后续模块化设计与多环境交付的基石。

2.1 Provider：基础设施的驱动层

Provider 是 Terraform 与目标平台之间的适配器。每个 Provider 负责定义一组可用的 Resource 和 Data Source，并封装与平台 API 的认证、请求、重试逻辑。

2.2 Resource：基础设施的原子单元

Resource 是 Terraform 管理的核心对象。每个 Resource 对应一个真实的基础设施组件——一台虚拟机、一个 S3 存储桶、一个 Prometheus 实例、一个 Grafana 数据源。

# 声明一个 AWS S3 存储桶作为 SLI 原始日志的暂存区
resource "aws_s3_bucket" "sli_raw_logs" {
  bucket = "sli-raw-logs-production"
  force_destroy = false

  tags = {
    Environment = "production"
    ManagedBy   = "terraform"
    Purpose     = "sli-collection"
  }
}

• 资源地址：aws_s3_bucket.sli_raw_logs，在配置中唯一标识该资源。
• 参数：bucket、force_destroy 等由 Provider 定义的 Schema。
• 元参数：depends_on、count、for_each、lifecycle 控制资源行为。

2.3 Data Source：只读的查询接口

Data Source 用于读取已有基础设施的信息，而不创建或修改任何资源。在 SLI 管线中，Data Source 常用于获取已有的 VPC、子网、KMS 密钥、Prometheus 端点等。

# 查询已有的 VPC，用于部署采集器
data "aws_vpc" "selected" {
  tags = {
    Environment = "production"
    Purpose     = "observability"
  }
}

# 引用 Data Source 的属性
resource "aws_security_group" "collector_sg" {
  vpc_id = data.aws_vpc.selected.id
  # ...
}

2.4 State：基础设施的真相映射

State 文件是 Terraform 的核心状态数据库，记录了每个 Resource 的当前属性与 Terraform 配置之间的映射关系。没有 State，Terraform 无法知道哪些资源已被管理。

• 本地 State：terraform.tfstate，仅适用于单机实验。
• 远程 State：S3 + DynamoDB、Terraform Cloud、Consul 等，支持团队协作与状态锁定。
• State 内容：每个 Resource 的 id、所有属性值、依赖关系、元数据。
• 敏感数据：State 中可能包含密码、密钥，必须加密存储并限制访问。

# backend.tf
terraform {
  backend "s3" {
    bucket         = "terraform-state-sli-pipeline"
    key            = "env:/${terraform.workspace}/sli-collection.tfstate"
    region         = "us-east-1"
    dynamodb_table = "terraform-state-lock"
    encrypt        = true
  }
}

2.5 Module：可复用的配置封装

Module 是 Terraform 中实现代码复用与抽象的核心机制。一个 Module 可以包含多个 Resource、Data Source、变量和输出，对外暴露简洁的接口。

# 调用一个 SLI 采集器模块
module "sli_collector" {
  source = "./modules/sli-collector"

  environment       = "production"
  vpc_id            = data.aws_vpc.selected.id
  subnet_ids        = data.aws_subnets.private.ids
  sli_metrics_bucket = aws_s3_bucket.sli_raw_logs.id
  collector_version = "2.1.0"
}

# 模块输出
output "collector_endpoint" {
  value = module.sli_collector.endpoint
}

2.6 核心概念在 SLI 管线中的映射

将上述五个概念映射到 SLI 口径采集管线的具体组件，可以更直观地理解它们的作用：