{
  "slug": "gcloud-container-node-pools-create-adds-subnetwork-31113ceb86fc",
  "title": "gcloud container node-pools create adds --subnetwork",
  "tools": [
    "gcloud"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-28T00:00:00.000Z",
  "announced_at": "2026-01-21T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When creating a node pool on a cluster with multiple available subnets, pass `--subnetwork` to choose one. The subnet must already be assigned to the cluster.",
    "examples": [
      "gcloud container node-pools create <POOL_NAME> --cluster=<CLUSTER_NAME> --location=<LOCATION> --subnetwork=<SUBNET_NAME>"
    ],
    "gotchas": [
      "POOL_NAME (required): Name of the new node pool.",
      "--cluster: Cluster to add the node pool to.",
      "--location: Cluster region or zone.",
      "--subnetwork: Name or full resource path of the subnet to use; the subnet must already be assigned to the cluster.",
      "Prerequisite: Install and initialize the gcloud CLI; set a default compute region or zone, or supply the cluster location.",
      "Prerequisite: For additional subnets, the cluster must be VPC-native and run GKE 1.30.3-gke.1211000 or later. The selected subnet must already be assigned to the cluster."
    ]
  },
  "why_it_matters": "Choose a subnetwork when creating a Kubernetes Engine node pool.",
  "sources": [
    "https://docs.cloud.google.com/sdk/docs/release-notes#56600_2026-04-28",
    "https://docs.cloud.google.com/kubernetes-engine/docs/how-to/multi-subnet-cluster",
    "https://docs.cloud.google.com/sdk/gcloud/reference/container/node-pools/create",
    "https://docs.cloud.google.com/sdk/docs/release-notes#55300_2026-01-21"
  ],
  "rank": 0.91029,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "cloud-20261008",
    "verdict_id": "cloud-20261008:cloud-20261008-15fb0502273a622e-19:gate",
    "evidence_hash": "91d2fe441548084694e5bfd1fd58ba3c328d369b1db6275b25227f8c62119e14"
  },
  "review": {
    "draft_hash": "2b87f9589f410680319d53247f9962588c6bdc50c3446e7105a87b77311626c4",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "cloud-20261008:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.91 >= 0.9; 2 needed) and Jev gave 0.65 (>= 0.6 needed)."
  }
}