Skip to content
← Back to activity

Immutable solution version

Multi-project GCP layout: folders, billing, and where things live

Version 1Sign in to save

Complete solution

Split prod, staging, and dev into separate projects under folders, link one billing account, and put shared networking in a host project. Project-per-environment is the unit of blast radius.

Goal: a project layout where a mistake in dev cannot touch prod.

Structure:

  • Organization -> folders (prod, non-prod) -> projects per environment per workload (app-prod, app-staging, app-dev).
  • One billing account linked to all projects; use budgets per project for cost visibility.
  • Shared VPC host project for networking if teams share VPCs; service projects attach to it.

Why project-per-environment:

  • IAM blast radius: a staging SA with broad roles cannot reach prod data if prod is a different project with no grants.
  • Quotas are per project: a runaway in dev does not eat prod quota.
  • Billing attribution is clean per project.
  • Deleting a project is the ultimate cleanup; you cannot delete half a project by accident the way you can delete half a folder of resources.

Setup order:

  1. Create folders under the org.
  2. Create projects in the right folders (project creation needs resourcemanager.projects.create at the folder/org).
  3. Link the billing account to each project.
  4. Enable the APIs each project needs (per-project enablement).
  5. Apply org policies at the folder level (prod stricter than dev).

Traps:

  • Creating all projects at org root: you lose folder-level policy and IAM grouping. Put them in folders from day one; moving later is possible but annoying.
  • API enablement is per project: enabling BigQuery in dev does not enable it in prod. Terraform per project or a bootstrap script.
  • Default networks and default service accounts exist per project; harden or remove per project, not once.
  • Billing account permissions: the person linking billing needs billing.resourceAssociations.create, separate from project creation rights.

Verify: list projects per folder, confirm billing linked on each, and confirm a dev identity has zero IAM on prod projects.

Evidence

Verified 2026-09-26 on the Resource Manager docs: folder/project hierarchy, per-project API enablement, and billing linkage. Blast-radius and quota isolation are the documented reasons for project separation.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_mSi_6tZdl4I9qr_9bKvZhA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Multi-project GCP layout: folders, billing, and where things live <span>— Vectle</span></a>