From cdc919ff596e263f2cc55a9780d2f74633da1ced Mon Sep 17 00:00:00 2001
From: Google APIs <noreply@google.com>
Date: Wed, 27 May 2026 20:37:10 -0700
Subject: [PATCH] feat: add custom node image configuration feat: add GKE agent
 sandbox configuration docs: various documentation improvements

PiperOrigin-RevId: 922506661
---
 .../container/v1beta1/cluster_service.proto   | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/google/container/v1beta1/cluster_service.proto b/google/container/v1beta1/cluster_service.proto
index dc8c5b5554..f938180d76 100644
--- a/google/container/v1beta1/cluster_service.proto
+++ b/google/container/v1beta1/cluster_service.proto
@@ -797,6 +797,9 @@ message LinuxNodeConfig {
   // net.core.wmem_max
   // net.core.optmem_max
   // net.core.somaxconn
+  // net.ipv4.neigh.default.gc_thresh1
+  // net.ipv4.neigh.default.gc_thresh2
+  // net.ipv4.neigh.default.gc_thresh3
   // net.ipv4.tcp_rmem
   // net.ipv4.tcp_wmem
   // net.ipv4.tcp_tw_reuse
@@ -812,6 +815,8 @@ message LinuxNodeConfig {
   // net.netfilter.nf_conntrack_tcp_timeout_time_wait
   // net.netfilter.nf_conntrack_tcp_timeout_established
   // net.netfilter.nf_conntrack_acct
+  // kernel.keys.maxkeys
+  // kernel.keys.maxbytes
   // kernel.shmmni
   // kernel.shmmax
   // kernel.shmall
@@ -1424,6 +1429,10 @@ message NodeConfig {
   // for available image types.
   string image_type = 5;
 
+  // The node image configuration to use for this node pool.  Note that this is
+  // only applicable for node pools using image_type=CUSTOM.
+  CustomImageConfig node_image_config = 90;
+
   // The Kubernetes labels (key/value pairs) to apply to each node. The values
   // in this field are added to the set of default labels Kubernetes applies to
   // nodes.
@@ -1851,6 +1860,18 @@ message ShieldedInstanceConfig {
   bool enable_integrity_monitoring = 2;
 }
 
+// CustomImageConfig contains the information r
+message CustomImageConfig {
+  // The name of the image to use for this node.
+  string image = 1;
+
+  // The name of the image family to use for this node.
+  string image_family = 2;
+
+  // The project containing the image to use for this node.
+  string image_project = 3;
+}
+
 // SandboxConfig contains configurations of the sandbox to use for the node.
 message SandboxConfig {
   // Possible types of sandboxes.
@@ -4074,6 +4095,14 @@ message ClusterUpdate {
   // The desired GCFS config for the cluster.
   GcfsConfig desired_gcfs_config = 109;
 
+  // The desired name of the image to use for this node.
+  // This is used to create clusters using a custom image.
+  string desired_image = 44;
+
+  // The project containing the desired image to use for this node.
+  // This is used to create clusters using a custom image.
+  string desired_image_project = 45;
+
   // Configuration of etcd encryption.
   DatabaseEncryption desired_database_encryption = 46;
 
@@ -4771,6 +4800,14 @@ message UpdateNodePoolRequest {
   // for available image types.
   string image_type = 6 [(google.api.field_behavior) = REQUIRED];
 
+  // The desired name of the image name to use for this node.
+  // This is used to create clusters using a custom image.
+  string image = 10;
+
+  // The project containing the desired image to use for this node pool.
+  // This is used to create clusters using a custom image.
+  string image_project = 11;
+
   // The desired list of Google Compute Engine
   // [zones](https://cloud.google.com/compute/docs/zones#available)
   // in which the node pool's nodes should be located. Changing the locations
@@ -6888,6 +6925,10 @@ message NetworkConfig {
   // [ClusterUpdate.desired_default_enable_private_nodes][google.container.v1beta1.ClusterUpdate.desired_default_enable_private_nodes]
   optional bool default_enable_private_nodes = 22;
 
+  // Optional. DataplaneV2Config specifies the DPv2 configuration.
+  optional DataplaneV2Config dataplane_v2_config = 23
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Disable L4 load balancer VPC firewalls to enable firewall policies.
   optional bool disable_l4_lb_firewall_reconciliation = 24;
 }
@@ -8183,6 +8224,25 @@ enum DatapathProvider {
   ADVANCED_DATAPATH = 2;
 }
 
+// DataplaneV2Config is the configuration for DPv2.
+message DataplaneV2Config {
+  // Options on how to scale the cluster.
+  enum ScalabilityMode {
+    // Default value.
+    SCALABILITY_MODE_UNSPECIFIED = 0;
+
+    // Disables the scale optimized mode for DPv2.
+    DISABLED = 3;
+
+    // Enables the scale optimized mode for DPv2.
+    SCALE_OPTIMIZED = 4;
+  }
+
+  // Optional. Scalability mode for the cluster.
+  optional ScalabilityMode scalability_mode = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
 // PodAutoscaling is used for configuration of parameters
 // for workload autoscaling.
 message PodAutoscaling {