You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/aks/planned-maintenance.md
+6-16Lines changed: 6 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ This article shows you how to use planned maintenance to schedule and control cl
17
17
Regular maintenance is performed on your AKS cluster automatically. There are two types of maintenance operations:
18
18
19
19
**AKS-initiated maintenance* involves the weekly releases that AKS performs to keep your cluster up to date with the latest features and fixes.
20
-
**User-initiated maintenance* includes [cluster automatic upgrades][aks-upgrade] and [node operating system (OS) automatic security updates][node-image-auto-upgrade].
20
+
**User-initiated maintenance* includes [cluster auto-upgrades][aks-upgrade] and [node operating system (OS) automatic security updates][node-image-auto-upgrade].
21
21
22
22
When you use the feature of planned maintenance in AKS, you can run both types of maintenance in a cadence of your choice to minimize workload impact.
23
23
@@ -40,8 +40,8 @@ Three schedule configuration types are available for planned maintenance:
40
40
*`default` is a basic configuration for controlling AKS releases. The releases can take up to two weeks to roll out to all regions from the initial time of shipping, because of Azure safe deployment practices.
41
41
42
42
Choose `default` to schedule these updates in a manner that's least disruptive for you. You can monitor the status of an ongoing AKS release by region with the [weekly release tracker][release-tracker].
43
-
*`aksManagedAutoUpgradeSchedule` controls when to perform cluster upgrades scheduled by your designated automatic upgrade channel. You can configure more finely controlled cadence and recurrence settings with this configuration compared to the `default` configuration. For more information on cluster automatic upgrades, see [Automatically upgrade an Azure Kubernetes Service cluster][aks-upgrade].
44
-
*`aksManagedNodeOSUpgradeSchedule` controls when to perform the node OS security patching scheduled by your node OS automatic upgrade channel. You can configure more finely controlled cadence and recurrence settings with this configuration compared to the `default` configuration. For more information on node OS automatic upgrade channels, see [Automatically patch and update AKS cluster node images][node-image-auto-upgrade].
43
+
*`aksManagedAutoUpgradeSchedule` controls when to perform cluster upgrades scheduled by your designated auto-upgrade channel. You can configure more finely controlled cadence and recurrence settings with this configuration compared to the `default` configuration. For more information on cluster auto-upgrade, see [Automatically upgrade an Azure Kubernetes Service cluster][aks-upgrade].
44
+
*`aksManagedNodeOSUpgradeSchedule` controls when to perform the node OS security patching scheduled by your node OS auto-upgrade channel. You can configure more finely controlled cadence and recurrence settings with this configuration compared to the `default` configuration. For more information on node OS auto-upgrade channels, see [Automatically patch and update AKS cluster node images][node-image-auto-upgrade].
45
45
46
46
We recommend using `aksManagedAutoUpgradeSchedule` for all cluster upgrade scenarios and `aksManagedNodeOSUpgradeSchedule` for all node OS security patching scenarios.
47
47
@@ -50,7 +50,7 @@ The `default` option is meant exclusively for AKS weekly releases. You can switc
50
50
## Create a maintenance window
51
51
52
52
> [!NOTE]
53
-
> When you're using automatic upgrades, to ensure proper functionality, use a maintenance window with a duration of four hours or more.
53
+
> When you're using auto-upgrade, to ensure proper functionality, use a maintenance window with a duration of four hours or more.
54
54
55
55
Planned maintenance windows are specified in Coordinated Universal Time (UTC).
56
56
@@ -412,7 +412,7 @@ az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluste
412
412
413
413
* I configured a maintenance window, but the upgrade didn't happen. Why?
414
414
415
-
An AKS automatic upgrade needs a certain amount of time to take the maintenance window into consideration. We recommend at least 24 hours between the creation or update of a maintenance configuration and the scheduled start time.
415
+
AKS auto-upgrade needs a certain amount of time to take the maintenance window into consideration. We recommend at least 24 hours between the creation or update of a maintenance configuration and the scheduled start time.
416
416
417
417
Also, ensure that your cluster is started when the planned maintenance window starts. If the cluster is stopped, its control plane is deallocated and no operations can be performed.
418
418
@@ -424,7 +424,7 @@ az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluste
424
424
425
425
We recommend setting the [node OS security updates][node-image-auto-upgrade] schedule to a weekly cadence if you're using the `NodeImage` channel, because a new node image is shipped every week. You can also opt in for the `SecurityPatch` channel to receive daily security updates.
426
426
427
-
Set the [automatic upgrade][auto-upgrade] schedule to a monthly cadence to stay current with the Kubernetes N-2 [support policy][aks-support-policy].
427
+
Set the [auto-upgrade][auto-upgrade] schedule to a monthly cadence to stay current with the Kubernetes N-2 [support policy][aks-support-policy].
428
428
429
429
For a detailed discussion of upgrade best practices and other considerations, see [AKS patch and upgrade guidance][upgrade-operators-guide].
430
430
@@ -433,20 +433,10 @@ az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluste
433
433
* To get started with upgrading your AKS cluster, see [Upgrade options for AKS clusters][aks-upgrade].
0 commit comments