Cloud Foundation Fabric (CFF)

Overview

Cloud Foundation Fabric is a comprehensive suite of Terraform modules and end-to-end blueprints designed for Google Cloud Platform (GCP). It provides:

Modules: A library of composable, production-ready Terraform modules (e.g., project, net-vpc, gke-cluster)
FAST: An opinionated, stage-based landing zone toolkit for bootstrapping enterprise-grade GCP organizations

Repository: https://github.com/GoogleCloudPlatform/cloud-foundation-fabric
Latest Version: v53.0.0 (as of February 2025)

Module Usage Pattern

ALWAYS pin modules to a tagged release to ensure stability:

module "project" {
  source  = "github.com/GoogleCloudPlatform/cloud-foundation-fabric//modules/project?ref=v53.0.0"
  name    = "my-project"
  # ... other configuration
}

Version Reference

| Version | Release Date | Status | |---------|-------------|--------| | v53.0.0 | 2025-02-12 | Latest | | v52.1.0 | 2025-02-12 | Stable | | v52.0.0 | 2025-01-31 | Stable |

Quick Examples

Project with APIs and IAM

module "project" {
  source  = "github.com/GoogleCloudPlatform/cloud-foundation-fabric//modules/project?ref=v53.0.0"
  name    = "my-application"
  parent  = "folders/1234567890"
  
  services = [
    "compute.googleapis.com",
    "container.googleapis.com",
    "logging.googleapis.com",
  ]
  
  iam = {
    "roles/viewer" = ["group:developers@example.com"]
    "roles/editor" = ["serviceAccount:ci-cd@my-project.iam.gserviceaccount.com"]
  }
}

VPC with Subnets

module "vpc" {
  source  = "github.com/GoogleCloudPlatform/cloud-foundation-fabric//modules/net-vpc?ref=v53.0.0"
  project_id = module.project.project_id
  name    = "production-vpc"
  
  subnets = [
    {
      name          = "subnet-1"
      region        = "us-central1"
      ip_cidr_range = "10.0.0.0/24"
    },
    {
      name          = "subnet-2"
      region        = "europe-west1"
      ip_cidr_range = "10.0.1.0/24"
    }
  ]
}

GKE Autopilot Cluster

module "gke" {
  source  = "github.com/GoogleCloudPlatform/cloud-foundation-fabric//modules/gke-cluster-autopilot?ref=v53.0.0"
  project_id = module.project.project_id
  name    = "main-cluster"
  location = "us-central1"
  
  vpc_config = {
    network    = module.vpc.self_link
    subnetwork = module.vpc.subnet_self_links["us-central1/subnet-1"]
  }
}

Reference Documentation

For detailed information, see the following reference guides:

Module Catalog - Complete list of all CFF modules organized by category
Design Principles - The Zen of Fabric, common interfaces, and naming conventions
Factory Patterns - Configuration-driven resource creation using YAML
Cursed Knowledge - Edge cases, gotchas, and advanced patterns
Configuration - Tool setup, environment variables, and provider configuration

Common Patterns

IAM Interface

Most modules support consistent IAM patterns:

iam = {
  "roles/viewer" = ["user:user@example.com"]
  "roles/editor" = ["group:group@example.com"]
}

No Random Suffixes

Use explicit prefix instead of random suffixes:

module "project" {
  source = "github.com/GoogleCloudPlatform/cloud-foundation-fabric//modules/project?ref=v53.0.0"
  name   = "application"
  prefix = "prod"  # Creates: prod-application
}

Key Files

| File | Purpose | |------|---------| | CURSED_KNOWLEDGE.md | Edge cases and gotchas | | FACTORIES.md | Factory patterns documentation | | CONTRIBUTING.md | Development guidelines | | GEMINI.md | AI assistant context | | CHANGELOG.md | Release history |

External References

Repository: https://github.com/GoogleCloudPlatform/cloud-foundation-fabric
Modules: https://github.com/GoogleCloudPlatform/cloud-foundation-fabric/tree/master/modules
FAST Documentation: https://github.com/GoogleCloudPlatform/cloud-foundation-fabric/tree/master/fast
Blueprints: https://github.com/GoogleCloudPlatform/cloud-foundation-fabric/tree/master/blueprints