Course contentsShow
← Cloud and Infrastructure
Lesson 789 of 2,98915. Terraform in PracticeFree lesson

GCS Backend Configuration

Set up Google Cloud Storage bucket as Terraform backend with appropriate IAM permissions and versioning.

GCS Backend Configuration

What you'll learn: How to configure Google Cloud Storage as a remote backend for your Terraform state with proper security and versioning.

Why Use GCS as a Terraform Backend?

Just like you stored Terraform state in S3 (AWS) or Azure Storage, Google Cloud Storage (GCS) provides a reliable, centralized location for your state files when working in Google Cloud environments. This prevents local state conflicts and enables team collaboration.

Setting Up Your GCS Backend

First, you'll need a GCS bucket. Create one through the Google Cloud Console or gcloud CLI with versioning enabled:

gsutil mb gs://my-terraform-state-bucket
gsutil versioning set on gs://my-terraform-state-bucket

Versioning acts like a safety net—if something goes wrong, you can recover previous state versions.

IAM Permissions

The service account or user running Terraform needs these permissions on the bucket:

  • storage.objects.create
  • storage.objects.delete
  • storage.objects.get
  • storage.objects.list

Typically, assign the Storage Object Admin role to your Terraform service account.

Backend Configuration Block

In your Terraform configuration, declare the GCS backend:

terraform {
  backend "gcs" {
    bucket = "my-terraform-state-bucket"
    prefix = "terraform/state"
  }
}

The prefix organizes state files within the bucket, useful when managing multiple environments or projects.

After adding this block, run terraform init to migrate your state from local storage to GCS.

Security Considerations

Always enable bucket encryption (Google manages this by default) and restrict bucket access through IAM policies—never make your state bucket public.

Key Takeaway: GCS backend configuration centralizes Terraform state in Google Cloud Storage with versioning enabled and IAM-controlled access, enabling secure team collaboration and state recovery.