docs: clarified wording around the NodePoolUpdateStrategy default beh…

…avior (#340) * docs: clarified wording around the NodePoolUpdateStrategy default behavior docs: add references for available node image types PiperOrigin-RevId: 505182579 Source-Link: googleapis/googleapis@c062caf Source-Link: googleapis/googleapis-gen@ea6906f Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWE2OTA2ZjExYWY1MjQzZDZiNDEwNWFmMGFmODU0ZTg3OGIwYTFlNyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * docs: clarified wording around the NodePoolUpdateStrategy default behavior docs: add references for available node image types PiperOrigin-RevId: 505186848 Source-Link: googleapis/googleapis@d6e9adb Source-Link: googleapis/googleapis-gen@fa221b6 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmEyMjFiNmEzYzk0NWNhN2VjMDYzYjcyYWU5ZWNhOTQwZWQzZGZkZCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Jan 28, 2023 · 019cf5e · 019cf5e
1 parent 9034751
commit 019cf5e
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 6 deletions.
diff --git a/packages/google-cloud-container/google/cloud/container_v1/types/cluster_service.py b/packages/google-cloud-container/google/cloud/container_v1/types/cluster_service.py
@@ -240,7 +240,9 @@ class NodePoolUpdateStrategy(proto.Enum):
 
     Values:
         NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED (0):
-            Default value.
+            Default value if unset. GKE internally
+            defaults the update strategy to SURGE for
+            unspecified strategies.
         BLUE_GREEN (2):
             blue-green upgrade.
         SURGE (3):
@@ -523,7 +525,9 @@ class NodeConfig(proto.Message):
         image_type (str):
             The image type to use for this node. Note
             that for a given image type, the latest version
-            of it will be used.
+            of it will be used. Please see
+            https://cloud.google.com/kubernetes-engine/docs/concepts/node-images
+            for available image types.
         labels (MutableMapping[str, str]):
             The map of Kubernetes labels (key/value
             pairs) to be applied to each node. These will
@@ -3584,7 +3588,9 @@ class UpdateNodePoolRequest(proto.Message):
             master version
         image_type (str):
             Required. The desired image type for the node
-            pool.
+            pool. Please see
+            https://cloud.google.com/kubernetes-engine/docs/concepts/node-images
+            for available image types.
         name (str):
             The name (project, location, cluster, node pool) of the node
             pool to update. Specified in the format
@@ -5885,6 +5891,9 @@ class AutoprovisioningNodePoolDefaults(proto.Message):
             https://cloud.google.com/compute/docs/disks/customer-managed-encryption
         image_type (str):
             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.
     """
 
     oauth_scopes: MutableSequence[str] = proto.RepeatedField(

diff --git a/packages/google-cloud-container/google/cloud/container_v1beta1/types/cluster_service.py b/packages/google-cloud-container/google/cloud/container_v1beta1/types/cluster_service.py
@@ -233,7 +233,9 @@ class NodePoolUpdateStrategy(proto.Enum):
 
     Values:
         NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED (0):
-            Default value.
+            Default value if unset. GKE internally
+            defaults the update strategy to SURGE for
+            unspecified strategies.
         BLUE_GREEN (2):
             blue-green upgrade.
         SURGE (3):
@@ -520,7 +522,9 @@ class NodeConfig(proto.Message):
         image_type (str):
             The image type to use for this node. Note
             that for a given image type, the latest version
-            of it will be used.
+            of it will be used. Please see
+            https://cloud.google.com/kubernetes-engine/docs/concepts/node-images
+            for available image types.
         labels (MutableMapping[str, str]):
             The map of Kubernetes labels (key/value
             pairs) to be applied to each node. These will
@@ -4083,7 +4087,9 @@ class UpdateNodePoolRequest(proto.Message):
             master version
         image_type (str):
             Required. The desired image type for the node
-            pool.
+            pool. Please see
+            https://cloud.google.com/kubernetes-engine/docs/concepts/node-images
+            for available image types.
         locations (MutableSequence[str]):
             The desired list of Google Compute Engine
             `zones <https://cloud.google.com/compute/docs/zones#available>`__
@@ -6468,6 +6474,9 @@ class AutoprovisioningNodePoolDefaults(proto.Message):
             https://cloud.google.com/compute/docs/disks/customer-managed-encryption
         image_type (str):
             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.
     """
 
     oauth_scopes: MutableSequence[str] = proto.RepeatedField(