ComputeClass

metadata

required

object

A field that identifies the compute class.

metadata.name

optional

string

The name of the compute class.

spec

required

object

The compute class specification, which defines how the compute class works.

spec.activeMigration

optional

object ( activeMigration )

A specification that lets you choose whether GKE automatically replaces existing nodes that are lower in a compute class priority list with new nodes that are higher in that priority list.

spec.autoscalingPolicy

optional

object ( autoscalingPolicy )

A specification that lets you fine-tune the timing and thresholds that cause GKE to remove underused nodes and consolidate workloads on other nodes.

spec.nodePoolAutoCreation

optional

object( nodePoolAutoCreation )

A specification that lets you choose whether GKE can create and delete node pools in Standard mode clusters based on the compute class priority rules. Requires node auto-provisioning to be enabled on the cluster.

spec.nodePoolGroup

optional

object( nodePoolGroup )

Requires GKE version 1.32.2-gke.1359000 or later

A specification that lets you group multiple node pools into a single logical unit called a collection . This grouping lets you apply shared configurations, such as a Service Level Objective (SLO), across all node pools within the collection.

spec.nodePoolConfig

optional

object( nodePoolConfig )

Requires GKE version 1.31.4-gke.1072000 or later

A specification that lets you configure certain parameters of node pools that are used by the compute class. For auto-provisioned node pools, these settings are automatically applied to newly created node pools and their nodes. Existing node pools are used only when their settings match this field.

spec.priorities[]

required

object ( priorities )

Requires GKE version 1.30.3-gke.1451000 or later

A list of priority rules that defines how GKE configures nodes during scaling operations. When a cluster needs to scale up, GKE tries to create nodes that match the first priority rule in this field. If GKE can't create those nodes, it attempts the next rule. The process repeats until GKE successfully creates nodes or exhausts all of the rules in the list.

priorityDefaults

optional

object ( priorityDefaults )

Requires GKE version 1.32.1-gke.1729000 or later

A specification that sets default values for specific fields that are omitted in entries in the spec.priorities[] field. The default values that you specify in the priorityDefaults field apply only if the corresponding field isn't set in a specific priority rule.

The values in the priorityDefaults field don't apply to spec.priorities.nodepools[] fields.

spec.whenUnsatisfiable

optional

string

A specification that lets you define what GKE does if none of the rules in the spec.priorities[] field can be met. Supported values are as follows:

• ScaleUpAnyway : create a new node that uses the default cluster node configuration. In GKE versions earlier than 1.33, this is the default behavior.
• DoNotScaleUp : leave the Pod in the Pending status until GKE can create a node that meets the criteria a priority rule. In GKE version 1.33 and later, this is the default behavior.

count

required

integer

The number of GPUs to attach to each node. The value must be at least 1 .

driverVersion

optional

string

Requires GKE version 1.31.1-gke.1858000 or later

The NVIDIA driver version to install. The supported values are as follows:

• default : install the default driver version for the node GKE version. If you omit this field, this is the default value.
• latest : install the latest driver version for the node GKE version.

gpu.type

required

string

The GPU type to attach to each node, such as nvidia-l4 .

cpuCfsQuota

optional

boolean

Enables CPU Completely Fair Scheduler (CFS) quota enforcement for containers that specify CPU limits. The following values are supported:

• true : enable CPU CFS quota enforcement. The kubelet uses the kernel CFS quota mechanism to enforce Pod CPU limits. Pods might move to different CPU cores depending on CPU throttling and core availability.
• false : disable CPU CFS quota enforcement. Pod CPU limits are ignored, which might be useful if Pods are sensitive to CPU limits. However, disabling CPU CFS quota enforcement increases the risk of a Pod consuming more CPU resources than intended.

The default value is true .

cpuCfsQuotaPeriod

optional

string

Sets the value, in microseconds, of the CFS quota period . This period defines how often the kernel reallocates CPU resources to each control group (cgroup). You can use this value to tune CPU throttling behavior.

The value must be between 1ms and 1s . The default value is 100ms .

cpuManagerPolicy

optional

string

Controls the kubelet CPU management policy. Some Pods are more sensitive to CPU limits. In these Pods, the latency of CPU reassignment during CFS quota enforcement might impact performance. The kubelet CPU Manager feature provides exclusive CPU access to specific Pods. The kubelet doesn't enforce CPU limits for those Pods even if CPU CFS quota enforcement is enabled.

The following values are supported:

• none : disables the CPU Manager feature. The kubelet assigns CPUs to Pods based on the CFS quota settings.
• static : provides containers that meet all of the following criteria with access to exclusive CPUs on the node:
  • The Pod has the Guaranteed Quality-of-Service (QoS) class.
  • The container has integer values in the requests.cpu field.

The default value is none .

For more information, see the Kubernetes documentation about policies for assigning CPUs to Pods .

podPidsLimit

optional

integer

Sets the maximum number of process IDs (PIDs) that each Pod can use. This setting controls the maximum number of processes and threads that can run simultaneously in a Pod. The value must be between 1024 and 4194304 . The default value is 4096 .

containerLogMaxSize

optional

string

Requires GKE version 1.33.4-gke.1036000 or later

Defines the maximum size of the container log file before it is rotated. Specified as a positive number and a unit suffix, such as 100Ki , 10Mi . Valid units are Ki , Mi , and Gi . The value must be between 10Mi and 500Mi , inclusive. The total container log size ( containerLogMaxSize * containerLogMaxFiles ) cannot exceed 1% of the total storage of the node. The default value is 10Mi .

containerLogMaxFiles

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Defines the maximum number of container log files that can be present for a container. The integer must be between 2 and 10 , inclusive. The default value is 5 .

imageGcLowThresholdPercent

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Defines the percentage of disk usage before which image garbage collection is never run. Lowest disk usage to garbage collect to. The percentage is calculated by dividing this field value by 100. The integer must be between 10 and 85 , inclusive, and lower than imageGcHighThresholdPercent . The default value is 80 .

imageGcHighThresholdPercent

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Defines the percentage of disk usage after which image garbage collection is always run. The percentage is calculated by dividing this field value by 100. The integer must be between 10 and 85 , inclusive, and higher than imageGcLowThresholdPercent . The default value is 85 .

imageMinimumGcAge

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Defines the minimum age for an unused image before it is garbage collected. Specified as a sequence of decimal numbers, each with an optional fraction and a unit suffix, such as 300s , 1.5m . Valid time units are ns , us (or µs ), ms , s , m , and h . The value cannot be greater than 2m . The default value is 2m .

imageMaximumGcAge

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Defines the maximum age an image can be unused before it is garbage collected. Specified as a sequence of decimal numbers, each with an optional fraction and a unit suffix, such as 300s , 1.5m , and 2h45m . Valid time units are ns , us (or µs ), ms , s , m , and h . The value must be a positive duration. The default value is none .

allowedUnsafeSysctls

optional

[]string

Requires GKE version 1.33.4-gke.1036000 or later

Defines a comma-separated allowlist of unsafe sysctls or sysctl patterns which can be set on the Pods. The allowed sysctl groups are kernel.shm* , kernel.msg* , kernel.sem , fs.mqueue.* , and net.* .

imageType

optional

string

Requires GKE version 1.32.4-gke.1198000 or later

Choose an image type for the node pools. Image type specifies the base OS that the nodes in the node pool run on. If you omit this field, the default value is cos_containerd .

serviceAccount

optional

string

Requires GKE version 1.31.4-gke.1072000 or later

Specifies the Google Cloud service account used by the nodes within node pools that are managed by the compute class.

workloadType

optional

string

Requires GKE version 1.32.2-gke.1359000 or later

Specifies the workload type for the node pools. Workload type defines the SLO for the workload. The following values are supported:

• HIGH_AVAILABILITY : for availability-focused workloads like serving, which require most of the infrastructure to be running at all times
• HIGH_THROUGHPUT : for batch or training jobs that need all underlying infrastructure running to make progress. This value can be set only when nodePoolGroup is also specified.

nodeLabels

optional

map

Requires GKE version 1.33.2-gke.1111000 or later

Specifies the node labels, which add user-defined Kubernetes labels to all nodes in the new node pool. These labels are applied to the Kubernetes API node object and can be used in nodeSelectors for Pod scheduling.

Kubernetes node labels are different from GKE labels.

For more information, see the comparison of GKE nodepool labels and Kubernetes labels.

  
 nodeLabels 
 : 
  
 { 
  
 'example-nodelabel-key' 
 : 
  
 'example-nodelabel-value' 
 , 
  
 'example-nodelabel-key-2' 
 : 
  
 'example-nodelabel-value-2' 
 , 
  
 } 
  

confidentialNodeType

optional

string

Requires GKE version 1.33.3-gke.1392000 or later

Defines the type of technology used by the confidential node. If using this, must specify machineFamily or machineType in each priority.

The following values are supported:

• SEV : AMD Secure Encrypted Virtualization.
• SEV_SNP : AMD Secure Encrypted Virtualization - Secure Nested Paging.
• TDX : Intel Trust Domain eXtension

affinity

required

string

The type of reservation to consume when creating nodes. The following values are supported:

• Specific : consume only specific named reservations. If the specified reservation doesn't have any capacity, GKE moves on to the next priority rule in the compute class. If you use this value, the specific[] field is required.
• AnyBestEffort : consume any reservation that matches the requirements of the priority rule. If any available reservation doesn't have capacity, GKE tries to provision an on-demand node with the priority rule configuration.
• None : prevent GKE from consuming reservations when it creates nodes for that priority rule.

specific

optional*

object( specific )

The parameters for consuming specific reservations. If you set the affinity field to Specific , this field is required. If you set the affinity field to any other value, you can't specify the specific field.

diskImageName

required

string

The name of the disk image.

mode

optional

string

The mode in which the secondary boot disk should be used. The following values are supported:

• CONTAINER_IMAGE_CACHE : use the disk as a container image cache.
• MODE_UNSPECIFIED : don't use a specific mode. If you omit this field, this is the default value.

project

optional

string

The project ID of the Google Cloud project that the disk image belongs to. If you omit this field, the default value is the project ID of the cluster project.

bootDiskKMSKey

optional

string

The path to the Cloud KMS key to use to encrypt the boot disk.

bootDiskSize

optional

integer

The size, in GiB, of the boot disk for each node. The minimum value is 10 .

bootDiskType

optional

string

The type of disk to attach to the node. The value that you specify must be supported by the machine series or the machine type in your priority rule. The following values are supported:

• pd-balanced : balanced Persistent Disk.
• pd-standard : standard Persistent Disk.
• pd-ssd : performance (SSD) Persistent Disk.
• hyperdisk-balanced : Hyperdisk Balanced.

For details about the disk types that specific machine series support, see the Machine series comparison table . Filter the table properties for "Hyperdisk" and "PD".

localSSDCount

optional

integer

The number of Local SSDs to attach to each node. If you specify this field, the minimum value is 1 .

secondaryBootDisks[]

optional

[]object( secondaryBootDisks )

Requires GKE version 1.31.2-gke.1105000 or later

The configuration of secondary boot disks that are used to preload nodes with data, such as ML models or container images.

kernel.shmmni

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The system-wide maximum number of shared memory segments. The value must be between 4096 and 32768 .

kernel.shmmax

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The total amount of shared memory pages that can be used on the system at one time. The value must be between 0 and 18446744073692774399 .

kernel.shmall

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The maximum size (in bytes) of a single shared memory segment allowed by the kernel. The value must be between 0 and 18446744073692774399 .

net.core.netdev_max_backlog

optional

integer

The maximum number of packets, queued on the INPUT side, when the interface receives packets faster than the kernel can process them. This setting is crucial for high-traffic network interfaces. Increasing this value can help to prevent packet loss under heavy load, but it also increases memory consumption. The value must be between 1 and 2147483647 .

net.core.rmem_max

optional

integer

The maximum receive socket buffer size in bytes. This setting limits the amount of data that a socket can buffer when receiving data. Increasing this value can improve performance for high-bandwidth connections by allowing the socket to handle larger bursts of data. The value must be between 2304 and 2147483647 .

net.core.rmem_default

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The default receive socket buffer size in bytes. The value must be between 2304 and 2147483647 .

net.core.wmem_default

optional

integer

The default setting, in bytes, of the socket send buffer. This value defines the initial size of the buffer allocated for sending data on a socket. The value must be between 4608 and 2147483647 .

net.core.wmem_max

optional

integer

The maximum send socket buffer size in bytes. This setting limits the amount of data that a socket can buffer when it sends data. Increasing this value can improve performance for applications that send large amounts of data. The value must be between 4608 and 2147483647 .

net.core.optmem_max

optional

integer

The maximum ancillary buffer size allowed per socket. Ancillary data is a sequence of cmsghdr structures with appended data, which are used to send and receive control information along with socket data. The value must be between 1 and 2147483647 .

net.core.somaxconn

optional

integer

The maximum size of the socket listen() backlog. This setting defines the maximum number of pending connections that can be queued for a listening socket. You might need to increase this value for busy web servers or other network services that handle a high volume of concurrent connection requests. The value must be between 128 and 2147483647 . The default value is 128 .

net.ipv4.tcp_rmem

optional

string

The minimum size, in bytes, of the receive buffer that's used by TCP sockets in moderation. Each TCP socket can use the size for receiving data, even if the total pages of UDP sockets exceed udp_mem pressure. The value in this field is a string of three integers, separated by spaces. These three integers represent the minimum, default, and maximum size of the receive buffer. For example, '4096 87380 6291456' .

net.ipv4.tcp_wmem

optional

string

The minimal size, in bytes, of send buffer that's used by TCP sockets in moderation. Each TCP socket can use the size for sending data, even if the total pages of TCP sockets exceed udp_mem pressure. The value in this field is a string of three integers, separated by spaces. These three integers represent the minimum, default, and maximum size of the receive buffer. For example, '4096 87380 6291456' . These values control how TCP socket send buffers dynamically resize for sending.

net.ipv4.tcp_tw_reuse

optional

integer

Reuse TIME-WAIT sockets for new connections when the protocol considers it safe to do so. This setting can improve performance by reducing the number of sockets in the TIME-WAIT state, but it also carries a risk of potential data corruption if it isn't used carefully. Don't change this setting unless a technical expect requests the change. The following values are supported:

• 0
• 1
• 2

net.core.busy_poll

optional

integer

The approximate time, in microseconds, to wait for packets on the device queue to do socket polls or selects . This setting is related to network performance tuning for low-latency applications. The value must be between 1024 and 2147483647 .

net.core.busy_read

optional

integer

The approximate time, in microseconds, to wait for packets on the device queue to perform read operations. This setting is used for low-latency network tuning, specifically for read operations. The value must be between 0 and 2147483647 .

net.ipv6.conf.all.disable_ipv6

optional

boolean

Globally disables IPv6 on all future and existing interfaces. Changing this value has the same effect as changing the net.ipv6.conf.default.disable_ipv6 setting and all per-interface disable_ipv6 settings to a specific value. The following values are supported:

• true : disable IPv6.
• false : enable IPv6.

net.ipv6.conf.default.disable_ipv6

optional

boolean

Disable IPv6 operations in all future network interfaces. The following values are supported:

• true : disable IPv6.
• false : enable IPv6.

net.netfilter.nf_conntrack_max

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The size of connection tracking table. The value must be between 65536 and 4194304 .

net.netfilter.nf_conntrack_buckets

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The size of hash table for connection tracking. The value must be between 65536 and 524288 . Recommend setting: nf_conntrack_max = nf_conntrack_buckets * 4

net.netfilter.nf_conntrack_tcp_timeout_close_wait

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The period for which the TCP connections can remain in the CLOSE_WAIT state, and stay in the table. The value must be between 60 and 3600 .

net.netfilter.nf_conntrack_tcp_timeout_time_wait

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The period for which the TCP connections can remain in the TIME_WAIT state, and stay in the table. The value must be between 1 and 600 .

net.netfilter.nf_conntrack_tcp_timeout_established

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The duration of dead connections before the connections are automatically deleted from connection tracking table. The value must be between 600 and 86400 .

net.netfilter.nf_conntrack_acct

optional

boolean

Requires GKE version 1.33.4-gke.1036000 or later

Whether to enable connection tracking flow accounting. The value must be true or false .

vm.max_map_count

optional

integer

Limit the number of distinct memory regions that a process can map into its address space. You might need to increase this value for applications that require a large number of shared libraries or that perform extensive memory mapping.

The value must be between 65536 and 2147483647 .

vm.dirty_background_ratio

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Percentage of system memory that can be filled with dirty pages (modified but not yet written to disk) before background kernel flusher threads begin writeback. This value should be less than vm.dirty_ratio . The value must be between 1 and 100 .

vm.dirty_expire_centisecs

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Maximum age (in hundredths of a second) that dirty data can remain in memory before kernel flusher threads write it to disk. Lower values result in faster, more frequent writebacks. The value must be between 0 and 6000 .

vm.dirty_ratio

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Percentage of system memory that can be filled with dirty pages before processes that perform writes are forced to block and write out dirty data synchronously. This value should be greater than vm.dirty_background_ratio . The value must be between 1 and 100 .

vm.dirty_writeback_centisecs

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Interval (in hundredths of a second) at which kernel flusher threads wake up to write 'old' dirty data to disk. The value must be between 0 and 1000 .

vm.overcommit_memory

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Determines the kernel's strategy for handling memory overcommitment. The following values are supported:

• 0 : Rejects allocations that are obviously too large.
• 1 : Allows overcommit until memory is exhausted.
• 2 : Prevents overcommit beyond swap space plus a percentage of RAM defined by vm.overcommit_ratio .

vm.overcommit_ratio

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Specifies the percentage of physical RAM allowed for overcommit when vm.overcommit_memory is set to 2 . The total committed address space cannot exceed swap plus this RAM percentage. The value must be between 0 and 100 .

vm.vfs_cache_pressure

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Adjusts the kernel's preference for reclaiming memory used for dentry (directory) and inode caches. The value must be between 0 and 100 .

fs.aio-max-nr

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The maximum system-wide number of asynchronous io requests. The value must be between 65536 and 4194304 .

fs.file-max

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

Maximum number of file-handles that the Linux kernel can allocate. The value must be between 104857 and 67108864 .

fs.inotify.max_user_instances

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The maximum number of inotify instances that a user can create. The value must be between 8192 and 1048576 .

fs.inotify.max_user_watches

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The maximum number of inotify watches that a user can create. The value must be between 8192 and 1048576 .

fs.nr_open

optional

integer

Requires GKE version 1.33.4-gke.1036000 or later

The maximum number of file descriptors that can be opened by a process. The value must be between 1048576 and 2147483584 .

type

string

The type of condition, which helps to organize status messages.

status

string

The status of the condition. The value is one of the following:

• True
• False
• Unknown

reason

string

A machine-readable reason why a specific condition type made its most recent transition.

message

string

A human-readable message that provides details about the most recent transition. This field might be empty.

lastTransitionTime

string

The timestamp of the most recent change to the condition.

observedGeneration

integer

A count of how many times the ComputeClass controller observed a change to the ComputeClass object. The controller attempts to reconcile the value in this field with the value in the metadata.generation field, which the Kubernetes API server updates whenever a change is made to the ComputeClass API object.