docs: clarified wording around the NodePoolUpdateStrategy default behavior

Google APIs · copybara-github · commit c062caf55972 · 2023-01-27T12:28:46.000-08:00
docs: add references for available node image types

PiperOrigin-RevId: 505182579
diff --git a/google/container/v1/cluster_service.proto b/google/container/v1/cluster_service.proto
@@ -684,7 +684,9 @@ message NodeConfig {
   map<string, string> metadata = 4;
 
   // The image type to use for this node. Note that for a given image type,
-  // the latest version of it will be used.
+  // the latest version of it will be used. Please see
+  // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for
+  // available image types.
   string image_type = 5;
 
   // The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -2299,7 +2301,9 @@ message UpdateNodePoolRequest {
   // - "-": picks the Kubernetes master version
   string node_version = 5 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The desired image type for the node pool.
+  // Required. The desired image type for the node pool. Please see
+  // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for
+  // available image types.
   string image_type = 6 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool) of the node pool to
@@ -3527,7 +3531,9 @@ message AutoprovisioningNodePoolDefaults {
   // https://cloud.google.com/compute/docs/disks/customer-managed-encryption
   string boot_disk_kms_key = 9;
 
-  // The image type to use for NAP created node.
+  // The image type to use for NAP created node. Please see
+  // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for
+  // available image types.
   string image_type = 10;
 }
 
@@ -4596,7 +4602,8 @@ enum DatapathProvider {
 
 // Strategy used for node pool update.
 enum NodePoolUpdateStrategy {
-  // Default value.
+  // Default value if unset. GKE internally defaults the update strategy to
+  // SURGE for unspecified strategies.
   NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED = 0;
 
   // blue-green upgrade.
