# googlecloudplatform/cloud-foundation-fabric architecture

> Architecture diagram of the GitHub repository googlecloudplatform/cloud-foundation-fabric, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/cloud-foundation-fabric
- Repository: https://github.com/googlecloudplatform/cloud-foundation-fabric

## Overview

Cloud Foundation Fabric is a Terraform toolkit for Google Cloud: FAST provides an organization-scale landing-zone design and reference implementation, while reusable modules cover foundational, networking, compute, data, AI, development, security, and serverless infrastructure. Engineers configure FAST stages or compose modules to provision cloud foundations. The repository also includes a Fabric importer for bringing existing infrastructure under management and a SecOps anonymization pipeline template. The graph preserves these documented product branches; importer-script relationships are limited where excerpts do not show calls.

Main entry points: [`fast`](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast) (FAST toolkit), [`modules`](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules) (Module catalog), [`skills/fabric-importer`](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/skills/fabric-importer) (Importer workflow), [`fast/project-templates/secops-anonymization-pipeline/source/main.py`](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/fast/project-templates/secops-anonymization-pipeline/source/main.py) (SecOps pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fast["FAST landing zone"]
  node_fast_toolkit["FAST toolkit"]
  node_org_setup["Organization setup"]
  node_vpc_sc["VPC Service Controls"]
  node_fast_network["Networking"]
  node_project_factory["Project factory"]
  node_security["Security"]
  node_secops_dev["SecOps development"]
end

subgraph group_modules["Terraform modules"]
  node_module_catalog["Module catalog"]
  node_foundations["Foundation modules"]
  node_network_modules["Networking modules"]
  node_compute_modules["Compute modules"]
  node_data_modules["Data modules"]
  node_ai_modules["AI modules"]
  node_security_modules["Security modules"]
end

subgraph group_importer["Fabric importer"]
  node_importer_skill["Importer workflow"]
  node_state_manifest["State manifest"]
  node_inventory["Resource inventory<br/>[inventory.py]"]
  node_coverage["Coverage reconciliation<br/>[coverage.py]"]
  node_plan_verify["Plan verification<br/>[verify_plan.py]"]
  node_integrity["Gate integrity<br/>[integrity.py]"]
end

subgraph group_templates["Project templates"]
  node_secops_template["SecOps pipeline<br/>[main.py]"]
  node_pipeline_utils["Pipeline utilities<br/>[utils.py]"]
end

node_engineer(("Cloud engineer"))
node_gcp{{"Google Cloud"}}
node_chronicle{{"Google SecOps"}}

node_engineer -->|"configures"| node_fast_toolkit
node_fast_toolkit -->|"provisions"| node_org_setup
node_fast_toolkit -->|"provisions"| node_vpc_sc
node_fast_toolkit -->|"provisions"| node_fast_network
node_fast_toolkit -->|"provisions"| node_project_factory
node_fast_toolkit -->|"provisions"| node_security
node_fast_toolkit -.->|"provisions"| node_secops_dev
node_engineer -->|"composes"| node_module_catalog
node_module_catalog -->|"includes"| node_foundations
node_module_catalog -->|"includes"| node_network_modules
node_module_catalog -->|"includes"| node_compute_modules
node_module_catalog -->|"includes"| node_data_modules
node_module_catalog -->|"includes"| node_ai_modules
node_module_catalog -->|"includes"| node_security_modules
node_engineer -->|"imports infrastructure"| node_importer_skill
node_importer_skill -->|"generates manifest"| node_state_manifest
node_importer_skill -.->|"builds inventory"| node_inventory
node_importer_skill -.->|"checks coverage"| node_coverage
node_importer_skill -.->|"verifies plans"| node_plan_verify
node_integrity -->|"hashes source"| node_inventory
node_integrity -->|"hashes source"| node_coverage
node_integrity -->|"hashes source"| node_plan_verify
node_engineer -->|"deploys template"| node_secops_template
node_secops_template -->|"uses utilities"| node_pipeline_utils
node_secops_template -.->|"processes cloud data"| node_gcp
node_secops_template -.->|"exports and imports logs"| node_chronicle

click node_fast_toolkit "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast"
click node_org_setup "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/0-org-setup"
click node_vpc_sc "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/1-vpcsc"
click node_fast_network "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/2-networking"
click node_project_factory "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/2-project-factory"
click node_security "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/2-security"
click node_secops_dev "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/3-secops-dev"
click node_module_catalog "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules"
click node_foundations "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/organization"
click node_network_modules "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/net-vpc"
click node_compute_modules "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/compute-vm"
click node_data_modules "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/bigquery-dataset"
click node_ai_modules "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/ai-applications"
click node_security_modules "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/kms"
click node_importer_skill "https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/skills/fabric-importer"
click node_state_manifest "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/manifest_from_state.py"
click node_inventory "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/inventory.py"
click node_coverage "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/coverage.py"
click node_plan_verify "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/verify_plan.py"
click node_integrity "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/integrity.py"
click node_secops_template "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/fast/project-templates/secops-anonymization-pipeline/source/main.py"
click node_pipeline_utils "https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/fast/project-templates/secops-anonymization-pipeline/source/shared/utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_fast_toolkit,node_org_setup,node_vpc_sc,node_fast_network,node_project_factory,node_security,node_secops_dev toneBlue
class node_module_catalog,node_foundations,node_network_modules,node_compute_modules,node_data_modules,node_ai_modules,node_security_modules toneAmber
class node_importer_skill,node_state_manifest,node_inventory,node_coverage,node_plan_verify,node_integrity toneMint
class node_secops_template,node_pipeline_utils toneRose
class node_engineer,node_gcp,node_chronicle toneIndigo
```

## Components

### FAST landing zone

- [FAST toolkit](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast): `fast`
- [Organization setup](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/0-org-setup): `fast/stages/0-org-setup`
- [VPC Service Controls](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/1-vpcsc): `fast/stages/1-vpcsc`
- [Networking](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/2-networking): `fast/stages/2-networking`
- [Project factory](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/2-project-factory): `fast/stages/2-project-factory`
- [Security](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/2-security): `fast/stages/2-security`
- [SecOps development](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/fast/stages/3-secops-dev): `fast/stages/3-secops-dev`

### Terraform modules

- [Module catalog](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules): `modules`
- [Foundation modules](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/organization): `modules/organization`
- [Networking modules](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/net-vpc): `modules/net-vpc`
- [Compute modules](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/compute-vm): `modules/compute-vm`
- [Data modules](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/bigquery-dataset): `modules/bigquery-dataset`
- [AI modules](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/ai-applications): `modules/ai-applications`
- [Security modules](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/modules/kms): `modules/kms`

### Fabric importer

- [Importer workflow](https://github.com/googlecloudplatform/cloud-foundation-fabric/tree/master/skills/fabric-importer): `skills/fabric-importer`
- [State manifest](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/manifest_from_state.py): `skills/fabric-importer/scripts/manifest_from_state.py`
- [Resource inventory](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/inventory.py): `skills/fabric-importer/scripts/inventory.py`
- [Coverage reconciliation](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/coverage.py): `skills/fabric-importer/scripts/coverage.py`
- [Plan verification](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/verify_plan.py): `skills/fabric-importer/scripts/verify_plan.py`
- [Gate integrity](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/skills/fabric-importer/scripts/integrity.py): `skills/fabric-importer/scripts/integrity.py`

### Project templates

- [SecOps pipeline](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/fast/project-templates/secops-anonymization-pipeline/source/main.py): `fast/project-templates/secops-anonymization-pipeline/source/main.py`
- [Pipeline utilities](https://github.com/googlecloudplatform/cloud-foundation-fabric/blob/master/fast/project-templates/secops-anonymization-pipeline/source/shared/utils.py): `fast/project-templates/secops-anonymization-pipeline/source/shared/utils.py`

### Other components

- **Cloud engineer**
- **Google Cloud**
- **Google SecOps**

## Connections

- Cloud engineer → FAST toolkit: configures (evidence: `README.md`)
- FAST toolkit → Organization setup: provisions (evidence: `README.md`)
- FAST toolkit → VPC Service Controls: provisions (evidence: `README.md`)
- FAST toolkit → Networking: provisions (evidence: `README.md`)
- FAST toolkit → Project factory: provisions (evidence: `README.md`)
- FAST toolkit → Security: provisions (evidence: `README.md`)
- FAST toolkit → SecOps development: provisions
- Cloud engineer → Module catalog: composes (evidence: `README.md`)
- Module catalog → Foundation modules: includes (evidence: `README.md`)
- Module catalog → Networking modules: includes (evidence: `README.md`)
- Module catalog → Compute modules: includes (evidence: `README.md`)
- Module catalog → Data modules: includes (evidence: `README.md`)
- Module catalog → AI modules: includes (evidence: `README.md`)
- Module catalog → Security modules: includes (evidence: `README.md`)
- Cloud engineer → Importer workflow: imports infrastructure (evidence: `skills/fabric-importer/scripts/manifest_from_state.py`)
- Importer workflow → State manifest: generates manifest (evidence: `skills/fabric-importer/scripts/manifest_from_state.py`)
- Importer workflow → Resource inventory: builds inventory (evidence: `skills/fabric-importer/scripts/inventory.py`)
- Importer workflow → Coverage reconciliation: checks coverage (evidence: `skills/fabric-importer/scripts/coverage.py`)
- Importer workflow → Plan verification: verifies plans (evidence: `skills/fabric-importer/scripts/verify_plan.py`)
- Gate integrity → Resource inventory: hashes source (evidence: `skills/fabric-importer/scripts/integrity.py`)
- Gate integrity → Coverage reconciliation: hashes source (evidence: `skills/fabric-importer/scripts/integrity.py`)
- Gate integrity → Plan verification: hashes source (evidence: `skills/fabric-importer/scripts/integrity.py`)
- Cloud engineer → SecOps pipeline: deploys template (evidence: `README.md`)
- SecOps pipeline → Pipeline utilities: uses utilities (evidence: `fast/project-templates/secops-anonymization-pipeline/source/main.py`)
- SecOps pipeline → Google Cloud: processes cloud data
- SecOps pipeline → Google SecOps: exports and imports logs
