feat: add Provisioning Request API

Google APIs · copybara-github · commit 04b05019710b · 2023-11-16T13:01:52.000-08:00
feat: add AutopilotConversionStatus
docs: Improve NodePool documentation

PiperOrigin-RevId: 583137228
diff --git a/google/container/v1beta1/cluster_service.proto b/google/container/v1beta1/cluster_service.proto
@@ -3776,30 +3776,31 @@ message BlueGreenSettings {
 // of Kubernetes labels applied to them, which may be used to reference them
 // during pod scheduling. They may also be resized up or down, to accommodate
 // the workload.
-// These upgrade settings control the level of parallelism and the level of
-// disruption caused by an upgrade.
-//
-// maxUnavailable controls the number of nodes that can be simultaneously
-// unavailable.
-//
-// maxSurge controls the number of additional nodes that can be added to the
-// node pool temporarily for the time of the upgrade to increase the number of
-// available nodes.
-//
-// (maxUnavailable + maxSurge) determines the level of parallelism (how many
-// nodes are being upgraded at the same time).
-//
-// Note: upgrades inevitably introduce some disruption since workloads need to
-// be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
-// this holds true. (Disruption stays within the limits of
-// PodDisruptionBudget, if it is configured.)
-//
-// Consider a hypothetical node pool with 5 nodes having maxSurge=2,
-// maxUnavailable=1. This means the upgrade process upgrades 3 nodes
-// simultaneously. It creates 2 additional (upgraded) nodes, then it brings
-// down 3 old (not yet upgraded) nodes at the same time. This ensures that
-// there are always at least 4 nodes available.
 message NodePool {
+  // These upgrade settings control the level of parallelism and the level of
+  // disruption caused by an upgrade.
+  //
+  // maxUnavailable controls the number of nodes that can be simultaneously
+  // unavailable.
+  //
+  // maxSurge controls the number of additional nodes that can be added to the
+  // node pool temporarily for the time of the upgrade to increase the number of
+  // available nodes.
+  //
+  // (maxUnavailable + maxSurge) determines the level of parallelism (how many
+  // nodes are being upgraded at the same time).
+  //
+  // Note: upgrades inevitably introduce some disruption since workloads need to
+  // be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
+  // this holds true. (Disruption stays within the limits of
+  // PodDisruptionBudget, if it is configured.)
+  //
+  // Consider a hypothetical node pool with 5 nodes having maxSurge=2,
+  // maxUnavailable=1. This means the upgrade process upgrades 3 nodes
+  // simultaneously. It creates 2 additional (upgraded) nodes, then it brings
+  // down 3 old (not yet upgraded) nodes at the same time. This ensures that
+  // there are always at least 4 nodes available.
+  //
   // These upgrade settings configure the upgrade strategy for the node pool.
   // Use strategy to switch between the strategies applied to the node pool.
   //
@@ -3956,6 +3957,14 @@ message NodePool {
     string policy_name = 3;
   }
 
+  // QueuedProvisioning defines the queued provisioning used by the node pool.
+  message QueuedProvisioning {
+    // Denotes that this nodepool is QRM specific, meaning nodes can be only
+    // obtained through queuing via the Cluster Autoscaler ProvisioningRequest
+    // API.
+    bool enabled = 1;
+  }
+
   // The name of the node pool.
   string name = 1;
 
@@ -4039,6 +4048,9 @@ message NodePool {
   // up-to-date value before proceeding.
   string etag = 110;
 
+  // Specifies the configuration of queued provisioning.
+  QueuedProvisioning queued_provisioning = 112;
+
   // Enable best effort provisioning for nodes
   BestEffortProvisioning best_effort_provisioning = 113;
 }
@@ -5475,13 +5487,32 @@ enum PrivateIPv6GoogleAccess {
 // Master is the configuration for components on master.
 message Master {}
 
+// AutopilotConversionStatus represents conversion status.
+message AutopilotConversionStatus {
+  // The current state of the conversion.
+  enum State {
+    // STATE_UNSPECIFIED indicates the state is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // DONE indicates the conversion has been completed. Old node pools will
+    // continue being deleted in the background.
+    DONE = 5;
+  }
+
+  // Output only. The current state of the conversion.
+  State state = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
 // Autopilot is the configuration for Autopilot settings on the cluster.
 message Autopilot {
   // Enable Autopilot
   bool enabled = 1;
 
   // Workload policy configuration for Autopilot.
   WorkloadPolicyConfig workload_policy_config = 2;
+
+  // ConversionStatus shows conversion status.
+  AutopilotConversionStatus conversion_status = 3;
 }
 
 // WorkloadPolicyConfig is the configuration of workload policy for autopilot
