explaingit

sontxdev04/landing-zone-gcp

18HCLAudience · ops devopsComplexity · 4/5Setup · hard

TLDR

Landing-Zone-GCP is a set of Terraform configurations that builds a security-first Google Cloud foundation for enterprises in five independent stacks, covering folder structure, hub-and-spoke networking, access control, logging, and budget alerts, so teams can start on safe infrastructure from day one.

Mindmap

mindmap
  root((repo))
    What It Does
      GCP foundation setup
      Security guardrails first
      Five independent stacks
    Five Stacks
      Org structure projects
      Hub-spoke networking
      Security access control
      Sample workload
      Logging monitoring budgets
    Security Defaults
      No public IPs enforced
      No static service account keys
      Service account impersonation
    Tech Stack
      Terraform 1.14.6
      Google Cloud provider
      HCL
    Networking
      Custom VPCs
      Cloud NAT
      Optional VPN on-prem
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Set up a new Google Cloud organization with security policies, folder hierarchy, and networking already in place before application teams start deploying workloads.

USE CASE 2

Use the hub-and-spoke networking stack as a starting point for connecting multiple GCP projects through a shared VPC with Cloud NAT and optional VPN.

USE CASE 3

Adapt the organization policy stack to enforce custom constraints like blocking specific regions or requiring encryption across all Cloud Storage buckets.

USE CASE 4

Study the service account impersonation pattern in the security stack as a replacement for static JSON key files in enterprise GCP environments.

Tech stack

TerraformHCLGoogle Cloud

Getting it running

Difficulty · hard Time to first run · 1day+

Requires a Google Cloud organization account with billing configured and Terraform 1.14.6, five stacks must be applied in the correct sequence.

In plain English

Landing-Zone-GCP is a collection of Terraform configuration files that sets up a standardized, security-first Google Cloud environment for enterprise use. The repository is written primarily in Vietnamese but the concepts translate clearly: it creates the foundational plumbing that a company's cloud platform team would install once, then hand off to application teams who can deploy workloads without worrying about networking, access control, or cost tracking. The central idea is that most organizations make a mistake when first moving to the cloud: they create projects and deploy applications immediately, and only add governance and security policies later. This project instead builds a "landing zone," a pre-configured environment with guardrails already in place, so teams can start building on a safe foundation from day one. The infrastructure is split into five independent Terraform stacks. The first establishes the organization structure: a folder hierarchy, five projects created through a project factory, and seven organization-level policies that enforce rules such as blocking public IP addresses and prohibiting static service account keys. The second stack sets up networking using a hub-and-spoke model with two custom VPCs, shared networking for application teams, Cloud NAT for outbound internet traffic, and optional VPN connectivity to on-premises systems. The third stack handles security and access control. The fourth provides a sample application workload. The fifth manages logging, monitoring, dashboards, and budget alerts. Authentication across all five stacks relies on service account impersonation rather than static JSON keys, which reduces the risk of credential leaks. Each stack has its own state file and its own runner account, so an error in one layer cannot cascade into another. The code targets Terraform version 1.14.6 and the Google Cloud provider version 6.50.0, deployed to the Singapore region by default. The project is open source and framed as a personal reference architecture that teams can adapt to their own environments.

Copy-paste prompts

Prompt 1
I am deploying the landing-zone-gcp Terraform stacks to a new GCP organization. What is the correct order to apply all five stacks and what prerequisites do I need first?
Prompt 2
In the landing-zone-gcp networking stack, how do I add a third spoke VPC for a production environment separate from the existing ones?
Prompt 3
How do I change the landing-zone-gcp default region from Singapore to eu-west1 across all five Terraform stacks without missing any hardcoded values?
Prompt 4
Explain how service account impersonation works in this landing zone and how to grant a developer access to impersonate the correct runner account for their stack.
Open on GitHub → Explain another repo

← sontxdev04 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.