Skip to content

Commit a4f853f

Browse files
Merge pull request #266044 from sdesai345/main
Remove preview flag for node soak duration GA
2 parents 410b137 + d280f1c commit a4f853f

File tree

2 files changed

+5
-19
lines changed

2 files changed

+5
-19
lines changed

articles/aks/upgrade-aks-cluster.md

Lines changed: 2 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ During the cluster upgrade process, AKS performs the following operations:
134134
* [Cordon and drain][kubernetes-drain] one of the old nodes to minimize disruption to running applications. If you're using max surge, it [cordons and drains][kubernetes-drain] as many nodes at the same time as the number of buffer nodes specified.
135135
* For long running pods, you can configure the node drain timeout, which allows for custom wait time on the eviction of pods and graceful termination per node. If not specified, the default is 30 minutes.
136136
* When the old node is fully drained, it's reimaged to receive the new version and becomes the buffer node for the following node to be upgraded.
137-
* Optionally, you can set a duration of time to wait between draining a node and proceeding to reimage it and move on to the next node. A short interval allows you to complete other tasks, such as checking application health from a Grafana dashboard during the upgrade process. We recommend a short timeframe for the upgrade process, as close to 0 minutes as reasonably possible. Otherwise, a higher node soak time (preview) affects how long before you discover an issue. The minimum soak time value is 0 minutes, with a maximum of 30 minutes. If not specified, the default value is 0 minutes.
137+
* Optionally, you can set a duration of time to wait between draining a node and proceeding to reimage it and move on to the next node. A short interval allows you to complete other tasks, such as checking application health from a Grafana dashboard during the upgrade process. We recommend a short timeframe for the upgrade process, as close to 0 minutes as reasonably possible. Otherwise, a higher node soak time affects how long before you discover an issue. The minimum soak time value is 0 minutes, with a maximum of 30 minutes. If not specified, the default value is 0 minutes.
138138
* This process repeats until all nodes in the cluster are upgraded.
139139
* At the end of the process, the last buffer node is deleted, maintaining the existing agent node count and zone balance.
140140

@@ -245,21 +245,10 @@ At times, you may have a long running workload on a certain pod and it can't be
245245
az aks nodepool update -n mynodepool -g MyResourceGroup --cluster-name MyManagedCluster --drainTimeoutInMinutes 45
246246
```
247247
248-
#### Set node soak time value (preview)
248+
#### Set node soak time value
249249
250250
To allow for a duration of time to wait between draining a node and proceeding to reimage it and move on to the next node, you can set the soak time to a value between 0 and 30 minutes. If no node soak time value is specified, the default is 0 minutes.
251251
252-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
253-
254-
> [!NOTE]
255-
> To use node soak duration (preview), you must have the aks-preview Azure CLI extension version 0.5.173 or later installed.
256-
257-
* Enable the aks-preview Azure CLI.
258-
259-
```azurecli-interactive
260-
az extension add --name aks-preview
261-
```
262-
263252
* Set node soak time for new or existing node pools using the [`az aks nodepool add`][az-aks-nodepool-add], [`az aks nodepool update`][az-aks-nodepool-update], or [`az aks nodepool upgrade`][az-aks-nodepool-upgrade] command.
264253
265254
```azurecli-interactive

articles/aks/upgrade-cluster.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -42,16 +42,13 @@ Persistent volume claims (PVCs) backed by Azure locally redundant storage (LRS)
4242

4343
## Optimize upgrades to improve performance and minimize disruptions
4444

45-
The combination of [Planned Maintenance Window][planned-maintenance], [Max Surge](./upgrade-aks-cluster.md#customize-node-surge-upgrade), [Pod Disruption Budget][pdb-spec], [node drain timeout][drain-timeout], and [node soak time][soak-time] (preview) can significantly increase the likelihood of node upgrades completing successfully by the end of the maintenance window while also minimizing disruptions.
45+
The combination of [Planned Maintenance Window][planned-maintenance], [Max Surge](./upgrade-aks-cluster.md#customize-node-surge-upgrade), [Pod Disruption Budget][pdb-spec], [node drain timeout][drain-timeout], and [node soak time][soak-time] can significantly increase the likelihood of node upgrades completing successfully by the end of the maintenance window while also minimizing disruptions.
4646

4747
* [Planned Maintenance Window][planned-maintenance] enables service teams to schedule auto-upgrade during a predefined window, typically a low-traffic period, to minimize workload impact. We recommend a window duration of at least *four hours*.
4848
* [Max Surge](./upgrade-aks-cluster.md#customize-node-surge-upgrade) on the node pool allows requesting extra quota during the upgrade process and limits the number of nodes selected for upgrade simultaneously. A higher max surge results in a faster upgrade process. We don't recommend setting it at 100%, as it upgrades all nodes simultaneously, which can cause disruptions to running applications. We recommend a max surge quota of *33%* for production node pools.
4949
* [Pod Disruption Budget][pdb-spec] is set for service applications and limits the number of pods that can be down during voluntary disruptions, such as AKS-controlled node upgrades. It can be configured as `minAvailable` replicas, indicating the minimum number of application pods that need to be active, or `maxUnavailable` replicas, indicating the maximum number of application pods that can be terminated, ensuring high availability for the application. Refer to the guidance provided for configuring [Pod Disruption Budgets (PDBs)][pdb-concepts]. PDB values should be validated to determine the settings that work best for your specific service.
5050
* [Node drain timeout][drain-timeout] on the node pool allows you to configure the wait duration for eviction of pods and graceful termination per node during an upgrade. This option is useful when dealing with long running workloads. When the node drain timeout is specified (in minutes), AKS respects waiting on pod disruption budgets. If not specified, the default timeout is 30 minutes.
51-
* [Node soak time][soak-time] (preview) helps stagger node upgrades in a controlled manner and can minimize application downtime during an upgrade. You can specify a wait time, preferably as reasonably close to 0 minutes as possible, to check application readiness between node upgrades. If not specified, the default value is 0 minutes. Node soak time works together with the max surge and node drain timeout properties available in the node pool to deliver the right outcomes in terms of upgrade speed and application availability.
52-
53-
> [!NOTE]
54-
> To use node soak duration (preview), you must have the `aks-preview` Azure CLI extension version 0.5.173 or later installed.
51+
* [Node soak time][soak-time] helps stagger node upgrades in a controlled manner and can minimize application downtime during an upgrade. You can specify a wait time, preferably as reasonably close to 0 minutes as possible, to check application readiness between node upgrades. If not specified, the default value is 0 minutes. Node soak time works together with the max surge and node drain timeout properties available in the node pool to deliver the right outcomes in terms of upgrade speed and application availability.
5552

5653
## Next steps
5754

@@ -64,7 +61,7 @@ This article listed different upgrade options for AKS clusters. For a detailed d
6461
<!-- LINKS - internal -->
6562
[aks-tutorial-prepare-app]: ./tutorial-kubernetes-prepare-app.md
6663
[drain-timeout]: ./upgrade-aks-cluster.md#set-node-drain-timeout-value
67-
[soak-time]: ./upgrade-aks-cluster.md#set-node-soak-time-value-preview
64+
[soak-time]: ./upgrade-aks-cluster.md#set-node-soak-time-value
6865
[nodepool-upgrade]: manage-node-pools.md#upgrade-a-single-node-pool
6966
[planned-maintenance]: planned-maintenance.md
7067
[specific-nodepool]: node-image-upgrade.md#upgrade-a-specific-node-pool

0 commit comments

Comments
 (0)