Kubernetes Node Pool
KubernetesNodePool
Defines a group of nodes within a GKE cluster that share the same configuration.
Translates this manifest into cluster node pools, managing autoscaling boundaries, machine types, and node lifecycle parameters.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | |
| kind | string | |
| metadata | map | |
| spec | Spec |
Spec
Contains the user-defined configuration for the Kubernetes node pool. Enumerates compute specifications including machine family, disk geometries, autoscaling bounds, and security parameters like secure boot.
| Property | Type | Description |
|---|---|---|
| description | string | This description is optional but will drastically improve the understand of the AI assistant about the structural elements of the organization |
| machineType | string | The machine type for the nodes in this node pool (e.g., e2-standard-4). Extracted into the core machine type configuration for the corresponding node pool. |
| minCount | int64 | The minimum number of nodes in the node pool. Used for autoscaling. Dictates the lower bound of cluster autoscaling for this node pool. |
| maxCount | int64 | The maximum number of nodes in the node pool. Used for autoscaling. Dictates the upper bound of cluster autoscaling for this node pool. |
| maxSurge | int64 | The maximum number of nodes that can be created beyond the current size during an upgrade. Used to configure the maximum surge during rolling upgrades. |
| maxUnavailable | int64 | The maximum number of nodes that can be simultaneously unavailable during an upgrade. Used to configure the maximum unavailability during rolling upgrades. |
| diskSizeGb | int64 | The size of the boot disk for each node in gigabytes. Translates into the persistent disk geometry dimensioned for nodes. |
| diskType | string | The type of boot disk for each node. Sets the underlying storage hardware variant (e.g. pd-standard, pd-ssd) for the node pool. |
| imageType | string | The image type to use for the nodes (e.g., COS_CONTAINERD). Specifies the OS image architecture running on nodes. |
| autoRepair | bool | If true, GKE will automatically repair nodes in this pool. Dictates whether the platform will automatically detect and repair unhealthy nodes. |
| autoUpgrade | bool | If true, GKE will automatically upgrade the nodes in this pool. Dictates whether the platform orchestrates autonomous node version upgrades. |
| enableSecureBoot | bool | If true, nodes in this pool will be created with secure boot enabled. Translates into configuring shielded instances and secure boot verification for node hosts. |
| preemptible | bool | If true, the node pool will be created using preemptible VMs, which are cheaper but may be terminated at any time. Dictates whether the node pool provisions ephemeral spot/preemptible instances. |
| initialNodeCount | int64 | The number of nodes to create in this node pool when the cluster is first created. Establishes the baseline cluster size at the moment of initial provisioning. |