/gke-compute-classes

ComputeClass: CRD Fields & Spec Reference

Full CRD: kubectl describe crd computeclasses.cloud.google.com.

Minimal Shape

apiVersion: cloud.google.com/v1
kind: ComputeClass
metadata: { name: my-class }
spec:
  nodePoolAutoCreation: { enabled: true }
  priorities:
  - machineFamily: n4
    minCores: 16

Top-Level Spec Fields

nodePoolConfig (node pool auto-creation Only)

Applied to pools created by the autoscaler.

• imageType: cos_containerd, ubuntu_containerd (must be lowercase).
• nodeLabels: Key-value pairs.
• taints: List of { key, value, effect }. Valid for an intentional dedication taint; keys cannot contain kubernetes.io (GKE Warden rejects it). DO NOT re-add cloud.google.com/compute-class on auto-created pools — GKE applies and auto-tolerates it. (Manual pools, by contrast, REQUIRE it as label + taint to bind.)
• serviceAccount: Identity for nodes (use custom SA with least privilege, not default).

priorities[] Fields

• machineFamily / machineType: Intent vs. strict. Prefer family.
• minCores, minMemoryGb: Lower bounds for intent-based matching.
• spot: true for Spot, false for On-Demand.
• location.zones: List of zones to attempt. Cannot combine with reservations.affinity: Specific (error: location config with specific reservations enabled) — with Specific reservations, zones come from reservations.specific[].zones and you keep only a policy-only location.locationPolicy.
• location.locationPolicy: ANY (default; packs for utilization, tends to fill one zone) or BALANCED (best-effort even node spread across zones at scale-up — infrastructure layer; still scales up if a zone is short). Balances nodes, not pods — for even pod distribution add pod topologySpreadConstraints/DoNotSchedule (workload layer).
• reservations: affinity: Specific or None.
• flexStart: { enabled: true } for DWS queued provisioning.
• gpu / tpu: Accelerator requests (count, type, topology).
• nodepools: (Standard Only) List of manual pool names to target.
• nodeSystemConfig:
  • linuxNodeConfig: sysctls (e.g., net.ipv4.tcp_tw_reuse: true, net.core.somaxconn: 4096). Never quote integer or boolean values.
  • kubeletConfig: cpuCfsQuota, podPidsLimit, etc.
• secondaryBootDisks: Attach secondary boot disks (e.g. pre-warmed container image disks) to auto-provisioned nodes for zero-delay container startup.
• bootDiskProfile: Performance profile for boot disks (e.g. BALANCED).
• ephemeralLocalSsdProfile / dedicatedLocalSsdProfile: Intent-based NVMe scratch space profiles.
• storage: Set bootDiskType, bootDiskSize, and localSSDCount specifically for this priority. Overrides cluster/nodePoolConfig defaults. This is the NODE boot disk, NOT the workload's data PV — for attached PVs use a Kubernetes StorageClass (recommend the built-in dynamic-rwo with use-allowed-disk-topology: "true" on GKE 1.35.3-gke.1290000+; see provisioning methods).

Important Schema Constraints

• Case Sensitivity: imageType must be lowercase (e.g., cos_containerd).
• Field Hallucinations: NEVER use spec.description, transparentHugepageEnabled, or shutdownGracePeriodSeconds. They do not exist in the CRD.
• YAML Formatting: ALWAYS use literal integers for fields like bootDiskSize, minCores, and somaxconn. DO NOT wrap them in quotes.
  • Correct: bootDiskSize: 50
  • Incorrect: bootDiskSize: "50"
• Storage: Use bootDiskSize, NOT bootDiskSizeGb.

whenUnsatisfiable

• DoNotScaleUp (Default): Pods stay Pending. Best for specific hardware needs.
• ScaleUpAnyway: Provisions E2 nodes on Standard with node pool auto-creation. Avoid for specialized workloads.