Terraform GCP 是用于以 Terraform 和 hashicorp/google 提供商开通与管理 Google Cloud Platform 基础设施的技能文档集合。
用途：适用于为可重复、可审计的部署定义 GCP 基础设施（IaC）；从单一代码库管理开发、预发布、生产等多环境；在一次计划中开通复杂资源图（VPC、GKE、Cloud SQL、IAM）；将基础设施变更以 plan/apply 阶段接入 CI/CD 流水线。
主要能力：资料包含版本与提供商配置（google、google-beta，GCS 后端）、变量与校验、项目 API 启用、状态存储桶创建与版本控制；网络模块（自定义 VPC、主与 GKE 子网及次级 IP 范围、IAP 防火墙、Cloud Router 与 NAT）；GKE 集群模块（发布通道、Workload Identity、私有节点、网络策略、日志监控、独立节点池与自动扩缩）；Cloud SQL 模块（高可用、备份与时间点恢复、私有 IP、SSL、删除保护）；IAM 服务账号与 Workload Identity 绑定；根模块组合、tfvars 环境配置、CI/CD 命令、资源导入与状态管理、常见故障排查表。资料还列出相关技能：gcp-networking、gcp-gke、gcp-cloud-sql、gcp-compute、gcp-cloud-functions。
使用方式：需 Terraform >= 1.5、已启用计费的 GCP 项目，本地用 gcloud auth application-default login，CI/CD 用 GOOGLE_APPLICATION_CREDENTIALS 或更推荐的工作负载身份/短期凭证。基本流程为：terraform init、terraform plan -out=tfplan、terraform apply tfplan；可按环境传入 -var-file 指定 tfvars。
限制与注意事项：示例为部分模块，规划前需补全变量声明、子网 CIDR、API 启用依赖、私有服务网络连接/输出及提供商兼容 schema；HCL 属性使用换行而非分号。应用前确认项目/后端/工作区、成本与已保存计划变更；状态和计划文件需保护，因为生成的密码即使标记敏感仍留在状态中。优先使用工作负载身份或短期 CI 凭证而非服务账号密钥文件；私有 GKE 节点不等于私有控制面端点，需显式配置端点访问。force-new 属性通常不能靠 state mv 修复，moved/state 操作仅用于同一资源的地址重构。基础设施命令可能中断服务，变更状态前应确认目标主机/范围并准备备份或快照；上游脚本与模板未随资料提供（仅文档导入）。