Skip to content

Commit c224fb7

Browse files
committed
incorporating feedback
1 parent 96ec938 commit c224fb7

File tree

1 file changed

+6
-16
lines changed

1 file changed

+6
-16
lines changed

articles/aks/planned-maintenance.md

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This article shows you how to use planned maintenance to schedule and control cl
1717
Regular maintenance is performed on your AKS cluster automatically. There are two types of maintenance operations:
1818

1919
* *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].
2121

2222
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.
2323

@@ -40,8 +40,8 @@ Three schedule configuration types are available for planned maintenance:
4040
* `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.
4141

4242
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].
4545

4646
We recommend using `aksManagedAutoUpgradeSchedule` for all cluster upgrade scenarios and `aksManagedNodeOSUpgradeSchedule` for all node OS security patching scenarios.
4747

@@ -50,7 +50,7 @@ The `default` option is meant exclusively for AKS weekly releases. You can switc
5050
## Create a maintenance window
5151

5252
> [!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.
5454
5555
Planned maintenance windows are specified in Coordinated Universal Time (UTC).
5656

@@ -412,7 +412,7 @@ az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluste
412412

413413
* I configured a maintenance window, but the upgrade didn't happen. Why?
414414

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.
416416

417417
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.
418418

@@ -424,7 +424,7 @@ az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluste
424424

425425
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.
426426

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].
428428

429429
For a detailed discussion of upgrade best practices and other considerations, see [AKS patch and upgrade guidance][upgrade-operators-guide].
430430

@@ -433,20 +433,10 @@ az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluste
433433
* To get started with upgrading your AKS cluster, see [Upgrade options for AKS clusters][aks-upgrade].
434434

435435
<!-- LINKS - Internal -->
436-
[plan-aks-design]: /azure/architecture/reference-architectures/containers/aks-start-here?toc=/azure/aks/toc.json&bc=/azure/aks/breadcrumb/toc.json
437-
[aks-support-policies]: support-policies.md
438-
[aks-faq]: faq.md
439-
[az-extension-add]: /cli/azure/extension#az_extension_add
440-
[az-extension-update]: /cli/azure/extension#az_extension_update
441-
[az-feature-list]: /cli/azure/feature#az_feature_list
442-
[az-feature-register]: /cli/azure/feature#az_feature_register
443-
[az-aks-install-cli]: /cli/azure/aks#az_aks_install_cli
444-
[az-provider-register]: /cli/azure/provider#az_provider_register
445436
[aks-upgrade]: upgrade-cluster.md
446437
[release-tracker]: release-tracker.md
447438
[auto-upgrade]: auto-upgrade-cluster.md
448439
[node-image-auto-upgrade]: auto-upgrade-node-image.md
449-
[pm-weekly]: ./aks-planned-maintenance-weekly-releases.md
450440
[monitor-aks]: monitor-aks-reference.md
451441
[aks-eventgrid]:quickstart-event-grid.md
452442
[aks-support-policy]:support-policies.md

0 commit comments

Comments
 (0)