Files
solution_architecture_agent/skills/google-cloud-iac-patterns/references/gke.md
Jonathan Boniface c84dbdea20 feat: the solution architecture agent on the shared Execution engine
The reference agent's subject, cloud solution architecture, as an agent in
the operating model agent's pattern: the Execution engine (from
orchestration_engine) and one Workflow in app/solution_architecture,
built for the settings and provider bundle by assembly.workflow_for.

Copied from gcp_solution_architecture_agent at 8b397cd without its own
engine: its role files, Skills, provider bundle, ADRs, vocabulary, scripts
and evaluation datasets. The image takes the engine from a named build
context and installs Terraform. It is called through the Orchestration
engine, and its files are what the operating model agent digests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 19:49:28 +01:00

3.5 KiB

Google Kubernetes Engine

A private Autopilot cluster on an existing subnet, with its node service account and Workload Identity for one workload.

  • enable_autopilot = true makes Google manage the nodes. Node pools, machine types and node counts are then not yours to set: leave out node_pool, node_config and initial_node_count.
  • A regional location gives a control plane in three zones. A zone gives one.
  • The subnet needs two secondary ranges, for Pods and Services, named in ip_allocation_policy.
  • enable_private_nodes = true gives nodes no public address; they then need Cloud NAT to pull images from outside Google.
  • master_authorized_networks_config limits who can reach the control plane. With enable_private_endpoint = true it has no public address at all.
  • Give nodes a dedicated service account with roles/container.defaultNodeServiceAccount, not the Compute Engine default account.
  • Autopilot has Workload Identity on. A Kubernetes service account acts as a Google service account through roles/iam.workloadIdentityUser, with the member serviceAccount:PROJECT.svc.id.goog[NAMESPACE/KSA].
  • deletion_protection is true unless set; take it from a variable.
variable "project_id" {
  type        = string
  description = "Project to deploy into."
}

variable "region" {
  type        = string
  description = "Region for regional resources."
}

variable "network_id" {
  type        = string
  description = "Id of the VPC the cluster is in."
}

variable "subnetwork_id" {
  type        = string
  description = "Id of the subnet for nodes. It has secondary ranges named pods and services."
}

variable "admin_cidr" {
  type        = string
  description = "Range allowed to reach the control plane."
}

variable "deletion_protection" {
  type        = bool
  description = "Whether the cluster is protected from deletion."
  default     = true
}

resource "google_service_account" "nodes" {
  project      = var.project_id
  account_id   = "gke-nodes"
  display_name = "GKE nodes"
}

resource "google_project_iam_member" "nodes_default_role" {
  project = var.project_id
  role    = "roles/container.defaultNodeServiceAccount"
  member  = "serviceAccount:${google_service_account.nodes.email}"
}

resource "google_container_cluster" "workload" {
  project             = var.project_id
  name                = "workload"
  location            = var.region
  enable_autopilot    = true
  deletion_protection = var.deletion_protection

  network    = var.network_id
  subnetwork = var.subnetwork_id

  ip_allocation_policy {
    cluster_secondary_range_name  = "pods"
    services_secondary_range_name = "services"
  }

  private_cluster_config {
    enable_private_nodes    = true
    enable_private_endpoint = false
  }

  master_authorized_networks_config {
    cidr_blocks {
      cidr_block   = var.admin_cidr
      display_name = "administrators"
    }
  }

  cluster_autoscaling {
    auto_provisioning_defaults {
      service_account = google_service_account.nodes.email
    }
  }

  release_channel {
    channel = "REGULAR"
  }

  depends_on = [google_project_iam_member.nodes_default_role]
}

resource "google_service_account" "app" {
  project      = var.project_id
  account_id   = "orders-app"
  display_name = "Orders application"
}

resource "google_service_account_iam_member" "app_workload_identity" {
  service_account_id = google_service_account.app.name
  role               = "roles/iam.workloadIdentityUser"
  member             = "serviceAccount:${var.project_id}.svc.id.goog[orders/orders-app]"
}