Terraform 基础回顾：Provider 配置、资源声明、变量与输出、状态文件管理

在构建制品供应链误差预算监控资源栈之前，必须牢固掌握 Terraform 的核心基础。本章将系统回顾 Provider 配置、资源声明、变量与输出、状态文件管理四大支柱，为后续编排监控资源奠定语法与架构基础。

4.1 Provider 配置：连接目标平台

Provider 是 Terraform 与目标基础设施（如 AWS、Azure、GCP、Kubernetes）之间的通信桥梁。每个 Provider 负责定义资源类型、API 调用逻辑与认证方式。

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

provider "aws" {
  region = "cn-north-1"
}

4.2 资源声明：定义基础设施对象

资源（Resource）是 Terraform 中最核心的声明单元，描述“需要创建、更新或删除什么对象”。资源声明遵循 resource "provider_type" "local_name" { ... } 语法。

• provider_type：由 Provider 定义的资源类型，如 aws_instance、aws_s3_bucket。
• local_name：当前 Terraform 配置内的唯一标识符，用于引用该资源。
• 参数块：定义资源的属性，如实例规格、磁盘大小、标签等。

resource "aws_s3_bucket" "error_budget_logs" {
  bucket = "error-budget-prod-logs"
  tags = {
    Name        = "ErrorBudgetLogs"
    Environment = "production"
  }
}

resource "aws_s3_bucket_versioning" "versioning_example" {
  bucket = aws_s3_bucket.error_budget_logs.id
  versioning_configuration {
    status = "Enabled"
  }
}

4.3 变量与输出：参数化与数据暴露

变量（Variable）使配置可复用、可参数化；输出（Output）则暴露资源属性供外部消费或模块间传递。

变量声明与使用

variable "environment" {
  type        = string
  description = "部署环境名称"
  validation {
    condition     = contains(["dev", "staging", "prod"], var.environment)
    error_message = "环境必须为 dev、staging 或 prod。"
  }
}

variable "monitoring_endpoints" {
  type = list(string)
  default = ["https://api.example.com/health", "https://api.example.com/metrics"]
}

输出声明

output "s3_bucket_arn" {
  value       = aws_s3_bucket.error_budget_logs.arn
  description = "误差预算日志存储桶的 ARN"
  sensitive   = false
}

output "monitor_endpoint_list" {
  value = var.monitoring_endpoints
}

4.4 状态文件管理：基础设施的真相源

状态文件（terraform.tfstate）是 Terraform 的核心资产，记录已管理资源的元数据、属性与依赖关系。状态文件管理直接决定团队协作与灾难恢复能力。

状态管理关键策略

• 远程状态存储：使用 S3、Azure Storage 或 Terraform Cloud 存储状态文件，避免本地文件丢失风险。
• 状态锁：通过 DynamoDB（AWS）或 CosmosDB（Azure）实现并发操作互斥，防止状态冲突。
• 敏感数据保护：状态文件可能包含明文密码、密钥，必须加密存储并限制访问权限。
• 状态隔离：每个环境（dev/staging/prod）使用独立状态文件，避免环境间资源误操作。

# 远程状态配置示例（AWS S3 + DynamoDB）
terraform {
  backend "s3" {
    bucket         = "terraform-state-error-budget"
    key            = "prod/monitoring-stack.tfstate"
    region         = "cn-north-1"
    encrypt        = true
    dynamodb_table = "terraform-state-lock"
  }
}

4.5 Provider、资源、变量与状态的协作关系

下图展示 Provider 配置、资源声明、变量输入、输出暴露与状态文件之间的数据流与依赖关系，帮助理解 Terraform 执行引擎的工作机制。

4.6 常见陷阱与避坑指南