terraform-engineer

name	terraform-engineer
description	Use when designing Terraform IaC, reviewing modules, managing state, planning provider upgrades, or improving repeatable infrastructure deployment workflows.
zh_description	用于 Terraform IaC 设计、模块评审、状态管理、Provider 升级和基础设施部署优化。
version	1.0.0
author	seaworld008
source	skills.sh
source_url	https://skills.sh/jeffallan/claude-skills/terraform-engineer
license	MIT
tags	["development", "engineer", "terraform"]
created_at	2026-03-27
updated_at	2026-06-29
quality	4
complexity	intermediate

Terraform Engineer

触发条件

• 想要将云服务（AWS, Azure, GCP）配置实现自动化和代码化管理。
• 面对复杂的基础设施架构（VPC, RDS, EKS, IAM），需要版本化且可重复的部署流程。
• 需要在团队内部共享、复用基础设施模块（Module）以降低管理成本。
• 实施基础设施变更审查（Terraform Plan），确保生产环境变更的安全性。
• 解决环境漂移（Drift）问题，确保实际资源与代码定义的期望状态一致。
• 管理多租户或多环境（Dev/Staging/Prod）的基础设施资源。

核心能力

1. HCL 语法与最佳实践 (HCL Best Practices)

• 声明式配置: 理解 HCL (HashiCorp Configuration Language) 的块（Blocks）、参数（Arguments）和表达式（Expressions）。
• 变量与输出: 灵活使用 variable, output, locals 实现参数化和跨模块数据传递。
• 数据源: 使用 data 源查询已存在或动态生成的云资源。
• 动态块: 使用 dynamic "block_name" 配合 for_each 处理列表或映射，减少重复冗余。

2. 模块设计模式 (Module Design Patterns)

• 高内聚低耦合: 将相关联的资源封装在模块中（如 VPC 模块包含 Subnet, Route Table, IGW）。
• 参数标准化: 定义清晰的输入变量接口，通过 validation 块增强配置健壮性。
• 版本化发布: 将模块发布到私有或公共 Registry，指定 Git Tag 实现版本锁定。
• 组合模式: 通过顶层模块（Root Module）调用多个子模块构建完整系统。

3. 状态管理策略 (State Management)

• 远程状态 (Remote State): 使用 S3, GCS 或 Terraform Cloud 存储状态文件，启用状态锁定（State Locking，如 DynamoDB）。
• 敏感信息脱敏: 理解状态文件中包含明文敏感信息，严格控制状态访问权限。
• 状态迁移与操作: 熟练使用 terraform state mv, rm, import 等命令手动干预状态映射。

4. 工作流 (Plan/Apply Workflow)

• Init: 初始化 Backend 和下载 Providers。
• Plan: 预览变更差异，将其作为 PR 审查的核心依据。
• Apply: 安全执行变更，通常配合 CI/CD 工具（GitHub Actions, Terraform Cloud）自动化执行。
• Destroy: 慎用，仅在销毁整个实验性环境时使用。

5. Drift 检测与修复 (Drift Detection & Remediation)

• 检测漂移: 通过 terraform plan 发现手动修改或自动伸缩导致的实际状态与代码差异。
• 修复策略:
  • Reconcile: 修改代码使其匹配实际，或执行 Apply 覆盖手动修改。
  • Import: 使用 import 块（或旧式 terraform import 命令）将手动创建的资源纳入代码管控。

6. Provider 配置与管理