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/auto-upgrade-node-image.md
+11-13Lines changed: 11 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,29 +1,27 @@
1
1
---
2
-
title: Automatically upgrade Azure Kubernetes Service (AKS) cluster node operating system images
3
-
description: Learn how to automatically upgrade Azure Kubernetes Service (AKS) cluster node operating system images.
2
+
title: Auto-Upgrade Azure Kubernetes Service (AKS) Node OS Images
3
+
description: Learn how to set up automatic upgrades on Azure Kubernetes Service (AKS) for all your cluster node operating system images.
4
4
ms.topic: article
5
5
ms.custom: build-2023, devx-track-azurecli
6
6
ms.author: nickoman
7
7
author: nickomang
8
8
ms.date: 02/03/2023
9
9
---
10
10
11
-
# Automatically upgrade Azure Kubernetes Service cluster node operating system images
12
-
13
-
AKS now supports an exclusive channel dedicated to controlling node-level OS security updates. This channel, referred to as the node OS auto-upgrade channel, can't be used for cluster-level Kubernetes version upgrades. To automatically upgrade Kubernetes versions, continue to use the cluster [auto-upgrade][Autoupgrade] channel.
14
-
11
+
# Auto-upgrade Azure Kubernetes Service cluster node OS images
12
+
AKS now supports the node OS auto-upgrade channel, an exclusive channel dedicated to controlling node-level OS security updates. This channel can't be used for cluster-level Kubernetes version upgrades.
15
13
16
14
## How does node OS auto-upgrade work with cluster auto-upgrade?
17
15
18
-
Node-level OS security updates come in at a faster cadence than Kubernetes patch or minor version updates. This is the main reason for introducing a separate, dedicated Node OS auto-upgrade channel. With this feature, you can have a flexible and customized strategy for node-level OS security updates and a separate plan for cluster-level Kubernetes version [auto-upgrades][Autoupgrade].
16
+
Node-level OS security updates are released at a faster rate than Kubernetes patch or minor version updates. The node OS auto-upgrade channel grants you flexibility and enables a customized strategy for node-level OS security updates. Then, you can choose a separate plan for cluster-level Kubernetes version [auto-upgrades][Autoupgrade].
19
17
It's highly recommended to use both cluster-level [auto-upgrades][Autoupgrade] and the node OS auto-upgrade channel together. Scheduling can be fine-tuned by applying two separate sets of [maintenance windows][planned-maintenance] - `aksManagedAutoUpgradeSchedule` for the cluster [auto-upgrade][Autoupgrade] channel and `aksManagedNodeOSUpgradeSchedule` for the node OS auto-upgrade channel.
20
18
21
-
## Using node OS auto-upgrade
19
+
## Use node OS auto-upgrade
22
20
23
21
The selected channel determines the timing of upgrades. When making changes to node OS auto-upgrade channels, allow up to 24 hours for the changes to take effect.
24
22
25
23
> [!NOTE]
26
-
> Node OS image auto-upgrade won't affect the cluster's Kubernetes version, but it only works for a cluster in a [supported version][supported].
24
+
> Node OS image auto-upgrade won't affect the cluster's Kubernetes version. It only works for a cluster in a [supported version][supported].
27
25
28
26
The following upgrade channels are available. You're allowed to choose one of these options:
29
27
@@ -46,7 +44,7 @@ To set the node os auto-upgrade channel on existing cluster, update the *node-os
46
44
az aks update --resource-group myResourceGroup --name myAKSCluster --node-os-upgrade-channel SecurityPatch
47
45
```
48
46
49
-
## Cadence and Ownership
47
+
## Update ownership and cadence
50
48
51
49
The default cadence means there's no planned maintenance window applied.
52
50
@@ -65,7 +63,7 @@ The default cadence means there's no planned maintenance window applied.
65
63
66
64
- The `NodeOsUpgradeChannelPreview` feature flag must be enabled on your subscription
67
65
68
-
### Register the 'NodeOsUpgradeChannelPreview' feature flag
66
+
### Register the 'NodeOsUpgradeChannelPreview' feature flag
69
67
70
68
Register the `NodeOsUpgradeChannelPreview` feature flag by using the [az feature register][az-feature-register] command, as shown in the following example:
71
69
@@ -95,9 +93,9 @@ az provider register --namespace Microsoft.ContainerService
95
93
> By default, any new cluster created with an API version of `06-01-2022` or later will set the node OS auto-upgrade channel value to `NodeImage`. Any existing clusters created with an API version earlier than `06-01-2022` will have the node OS auto-upgrade channel value set to `None` by default.
96
94
97
95
98
-
## Using node OS auto-upgrade with Planned Maintenance
96
+
## Node OS auto-upgrade with Planned Maintenance
99
97
100
-
If you’re using Planned Maintenance and node OS auto-upgrade, your upgrade starts during your specified maintenance window.
98
+
Planned Maintenance for the node OS auto-upgradestarts at your specified maintenance window.
101
99
102
100
> [!NOTE]
103
101
> To ensure proper functionality, use a maintenance window of four hours or more.
Copy file name to clipboardExpand all lines: articles/aks/gpu-cluster.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ This article helps you provision nodes with schedulable GPUs on new and existing
22
22
* You also need the Azure CLI version 2.0.64 or later installed and configured. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI][install-azure-cli].
23
23
24
24
> [!NOTE]
25
-
> If using an Azure Linux GPU node pool, automatic security patches aren't applied, and the default behavior for the cluster is *Unmanaged*. For more information, see [Using node OS auto-upgrade](./auto-upgrade-node-image.md#using-node-os-auto-upgrade).
25
+
> If using an Azure Linux GPU node pool, automatic security patches aren't applied, and the default behavior for the cluster is *Unmanaged*. For more information, see [auto-upgrade](./auto-upgrade-node-image.md).
26
26
27
27
## Get the credentials for your cluster
28
28
@@ -45,7 +45,7 @@ There are two ways to add the NVIDIA device plugin:
45
45
### Update your cluster to use the AKS GPU image (preview)
46
46
47
47
> [!NOTE]
48
-
> If using an Azure Linux GPU node pool, automatic security patches aren't applied, and the default behavior for the cluster is *Unmanaged*. For more information, see [Using node OS auto-upgrade](./auto-upgrade-node-image.md#using-node-os-auto-upgrade).
48
+
> If using an Azure Linux GPU node pool, automatic security patches aren't applied, and the default behavior for the cluster is *Unmanaged*. For more information, see [auto-upgrade](./auto-upgrade-node-image.md).
49
49
50
50
AKS provides a fully configured AKS image containing the [NVIDIA device plugin for Kubernetes][nvidia-github].
0 commit comments