| name | terraform-gcp |
| description | Terraform patterns for Google Cloud using the official google and google-beta providers and Cloud Foundation Toolkit modules. Covers project structure, state management, IAM, and CFT blueprint usage. Warns before terraform apply (billable and potentially destructive). |
| version | 0.1 |
| triggers | ["terraform GCP","terraform google","IaC GCP","cloud foundation toolkit","CFT","terraform plan GCP","terraform apply GCP","GCP modules","landing zone terraform","terraform google provider"] |
| required_scopes | ["resourcemanager.projects.get","resourcemanager.projects.setIamPolicy","serviceusage.services.enable"] |
| mcp_servers | [] |
Terraform — GCP
Infrastructure as Code for Google Cloud using the official Terraform provider and Cloud Foundation Toolkit (CFT).
Safety Rule — Plan Before Apply
terraform plan -out=tfplan
terraform apply tfplan
Provider Setup
terraform {
required_providers {
google = {
source = "hashicorp/google"
version = "~> 6.0"
}
}
backend "gcs" {
bucket = "PROJECT_ID-tfstate"
prefix = "env/prod"
}
}
provider "google" {
project = var.project_id
region = var.region
}
CFT Module Usage (recommended over writing from scratch)
# Example: GKE cluster via CFT module
module "gke" {
source = "terraform-google-modules/kubernetes-engine/google//modules/autopilot-cluster"
version = "~> 33.0"
project_id = var.project_id
name = "my-cluster"
region = var.region
network = module.vpc.network_name
subnetwork = module.vpc.subnets_names[0]
}
State Management
- State in GCS bucket (not local, not git)
- One state file per environment (
env/dev, env/staging, env/prod)
- Bucket versioning enabled for state rollback
- State lock via GCS object versioning (built in to google backend)
Module Structure (project convention)
infra/
├── modules/ # Reusable modules
│ └── service/
│ ├── main.tf
│ ├── variables.tf
│ └── outputs.tf
├── environments/
│ ├── dev/
│ │ ├── main.tf # Calls modules
│ │ └── terraform.tfvars
│ └── prod/
│ ├── main.tf
│ └── terraform.tfvars
└── backend.tf
References
