google/gke-networking
>- Plans, configures, and manages core GKE cluster networking. Covers private clusters, VPC-native configurations, DNS, node egress, Dataplane V2, and IP planning. Use when designing GKE networking layouts, configuring private clusters, setting up Dataplane V2, planning GKE IP ranges, or managing VPC- native cluster modes. Don't use for application ingress, load balancing, or service networking (use gke-service-networking instead).
npx skills add https://github.com/google/skills --skill gke-networking
This reference covers networking configuration for GKE clusters. The golden path
enforces private, VPC-native clusters with Dataplane V2.
> MCP Tools: get_cluster, update_cluster, apply_k8s_manifest,
> get_k8s_resource
Setting | Golden Path Value | Day-0/1 | Notes
-------------------------------------------------------------------- | ---------------------------------- | ------- | -----
privateClusterConfig.enablePrivateNodes | true | Day-0 | Nodes have no public IPs
masterAuthorizedNetworksConfig.privateEndpointEnforcementEnabled | true | Day-0 | Control plane only reachable via private endpoint or DNS
controlPlaneEndpointsConfig.dnsEndpointConfig.allowExternalTraffic | true | Day-0 | Allows DNS-based access from outside VPC
networkConfig.datapathProvider | ADVANCED_DATAPATH (Dataplane V2) | Day-0 | eBPF-based, built-in Network Policy
networkConfig.dnsConfig.clusterDns | CLOUD_DNS | Day-0 | Managed DNS, more reliable than kube-dns
networkConfig.enableIntraNodeVisibility | true | Day-1 | VPC Flow Logs for intra-node traffic
ipAllocationPolicy.autoIpamConfig.enabled | true | Day-0 | Automatic IP range management
ipAllocationPolicy.createSubnetwork | true | Day-0 | Auto-create dedicated subnet
defaultMaxPodsConstraint.maxPodsPerNode | 48 | Day-0 | Conservative default; 110 for high density
The golden path creates a private cluster. Users access it via:
allowExternalTraffic: true enables access viathe cluster's DNS endpoint from outside the VPC. No VPN required.
VPN/Interconnect.
masterAuthorizedNetworksConfig for IP-based access control.
# Access private cluster via DNS endpoint (golden path default)
gcloud container clusters get-credentials {cluster_name} \
--region {region} --dns-endpoint \
--quiet
# Access via private endpoint (from within VPC)
gcloud container clusters get-credentials {cluster_name} \
--region {region} --internal-ip \
--quiet
If the customer has existing network infrastructure:
gcloud container clusters create-auto {cluster_name} \
--region {region} \
--network {vpc_name} \
--subnetwork {subnet_name} \
--cluster-secondary-range-name {pod_range} \
--services-secondary-range-name {svc_range} \
--enable-private-nodes \
--enable-master-authorized-networks \
--quiet
> Day-0 Warning: VPC, subnet, and IP ranges cannot be changed after cluster
> creation.
VPC-native clusters route traffic natively using GCP Alias IP ranges. Key
benefits to cover:
for custom routes and avoiding custom route limit bottlenecks.
without complex bridging or routing tunnels.
allocation, reducing the risk of exhausting subnet IP ranges.
| Resource | Golden Path | Notes |
| ------------- | ------------ | ------------------------------------------ |
| Pod CIDR | /17 (auto) | ~32K pod IPs; size based on maxPodsPerNode |
| Service CIDR | /20 (auto) | ~4K service IPs |
| Node subnet | auto-created | /20 recommended for growth |
| Max pods/node | 48 | Each node gets a /25 pod range; set to 110 |
: : : for /24 per node :
Pod CIDR sizing rule of thumb:
maxPodsPerNode=48 -> each node uses a /25 (128 IPs) from pod CIDRmaxPodsPerNode=110 -> each node uses a /24 (256 IPs) from pod CIDRhave no public IPs) to allow private nodes to reach the internet without
public IP exposure.
maintain a consistent source IP for external allowlists or partner
firewalls.
to inspect and filter outbound traffic according to organization security
policies.
Dataplane V2 (golden path) provides built-in Network Policy enforcement — no
additional addon needed. Apply default-deny per namespace, then allow specific
flows.
> See the gke-workload-security skill for default-deny policy and the
> gke-multitenancy skill for per-team allow policies.
Take google/gke-networking from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.