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/azure-linux/tutorial-azure-linux-upgrade.md
+12-11Lines changed: 12 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Azure Linux Container Host for AKS tutorial - Upgrade Azure Linux Container Host nodes
3
-
description: In this Azure Linux Container Host for AKS tutorial, you will learn how to upgrade Azure Linux Container Host nodes.
3
+
description: In this Azure Linux Container Host for AKS tutorial, you learn how to upgrade Azure Linux Container Host nodes.
4
4
author: htaubenfeld
5
5
ms.author: htaubenfeld
6
6
ms.service: microsoft-linux
@@ -12,22 +12,23 @@ ms.date: 05/10/2023
12
12
13
13
The Azure Linux Container Host ships updates through two mechanisms: updated Azure Linux node images and automatic package updates.
14
14
15
-
As part of the application and cluster lifecycle, we recommend keeping your clusters up to date and secured by enabling upgrades for your cluster. To automatically keep your clusters up to date and secured, you can enable automatic node-image upgrades so your cluster will use the latest Azure Linux Container Host image when it scales up. Upgrading clusters can also be done manually.
15
+
As part of the application and cluster lifecycle, we recommend keeping your clusters up to date and secured by enabling upgrades for your cluster. You can enable automatic node-image upgrades to ensure your clusters use the latest Azure Linux Container Host image when it scales up. You can also manually upgrade the node-image on a cluster.
16
16
17
-
In this tutorial, part five of five, you will learn how to:
17
+
In this tutorial, part five of five, you learn how to:
18
18
19
19
> [!div class="checklist"]
20
+
>
20
21
> * Manually upgrade the node-image on a cluster.
21
22
> * Automatically upgrade an Azure Linux Container Host cluster.
22
23
> * Deploy Kured in an Azure Linux Container Host cluster.
23
24
24
25
> [!NOTE]
25
-
> Any upgrade operation, whether performed manually or automatically, will upgrade the node image version if not already on the latest. The latest version is contingent on a full AKS release, and can be determined by visiting the [AKS release tracker](../../articles/aks/release-tracker.md).
26
+
> Any upgrade operation, whether performed manually or automatically, upgrades the node image version if not already on the latest. The latest version is contingent on a full AKS release, and can be determined by visiting the [AKS release tracker](../../articles/aks/release-tracker.md).
26
27
27
28
## Prerequisites
28
29
29
-
- In previous tutorials, you created and deployed an Azure Linux Container Host cluster. To complete this tutorial, you need an existing cluster. If you haven't done this step and would like to follow along, start with [Tutorial 1: Create a cluster with the Azure Linux Container Host for AKS](./tutorial-azure-linux-create-cluster.md).
30
-
- You need the latest version of Azure CLI. Run `az --version`to find the version. If you need to install or upgrade, see [Install Azure CLI](/cli/azure/install-azure-cli).
30
+
* In previous tutorials, you created and deployed an Azure Linux Container Host cluster. To complete this tutorial, you need an existing cluster. If you haven't done this step and would like to follow along, start with [Tutorial 1: Create a cluster with the Azure Linux Container Host for AKS](./tutorial-azure-linux-create-cluster.md).
31
+
* You need the latest version of Azure CLI. Find the version using the `az --version`command. If you need to install or upgrade, see [Install Azure CLI](/cli/azure/install-azure-cli).
31
32
32
33
## Manually upgrade your cluster
33
34
@@ -45,9 +46,9 @@ az aks nodepool upgrade \
45
46
46
47
Auto-upgrade provides a set once and forget mechanism that yields tangible time and operational cost benefits. By enabling auto-upgrade, you can ensure your clusters are up to date and don't miss the latest Azure Linux Container Host features or patches from AKS and upstream Kubernetes.
47
48
48
-
Automatically completed upgrades are functionally the same as manual upgrades. The timing of upgrades is determined by the selected channel. When making changes to auto-upgrade, allow 24 hours for the changes to take effect.
49
+
Automatically completed upgrades are functionally the same as manual upgrades. The selected channel determines the timing of upgrades. When making changes to auto-upgrade, allow 24 hours for the changes to take effect.
49
50
50
-
To set the auto-upgrade channel on existing cluster, update the `--auto-upgrade-channel` parameter, similar to the following example which automatically upgrades the cluster to the latest supported patch release of a previous minor version.
51
+
To set the auto-upgrade channel on existing cluster, update the `--auto-upgrade-channel` parameter, similar to the following example, which automatically upgrades the cluster to the latest supported patch release of a previous minor version.
51
52
52
53
```azurecli-interactive
53
54
az aks update --resource-group testAzureLinuxResourceGroup --name testAzureLinuxCluster --auto-upgrade-channel stable
@@ -59,8 +60,7 @@ For more information on upgrade channels, see [Using cluster auto-upgrade](../..
59
60
60
61
Similar to setting your clusters to auto-upgrade, you can use the same set once and forget mechanism for package upgrades by enabling the node-os upgrade channel. If automatic package upgrades are enabled, the dnf-automatic systemd service runs daily and installs any updated packages that have been published.
61
62
62
-
To set the node-os upgrade channel on existing cluster, update the `--node-os-upgrade-channel` parameter, similar to the following example which automatically enables package upgrades. Note, that for some settings of [Node OS Upgrade Channel](../../articles/aks/auto-upgrade-node-image.md), `dnf-automatic` will be disabled by default.
63
-
63
+
To set the node-os upgrade channel on existing cluster, update the `--node-os-upgrade-channel` parameter, similar to the following example, which automatically enables package upgrades. Note that for some settings of [Node OS Upgrade Channel](../../articles/aks/auto-upgrade-node-image.md), `dnf-automatic` is disabled by default.
64
64
65
65
```azurecli-interactive
66
66
az aks update --resource-group testAzureLinuxResourceGroup --name testAzureLinuxCluster --node-os-upgrade-channel Unmanaged
@@ -70,7 +70,7 @@ az aks update --resource-group testAzureLinuxResourceGroup --name testAzureLinux
70
70
71
71
To protect your clusters, security updates are automatically applied to Azure Linux nodes. These updates include OS security fixes, kernel updates, and package upgrades. Some of these updates require a node reboot to complete the process. AKS doesn't automatically reboot these nodes to complete the update process.
72
72
73
-
We recommend enabling an automatic reboot daemon such as [Kured](https://kured.dev/docs/) so that your cluster can reboot nodes that have taken kernel updates. To deploy the Kured DaemonSet in an Azure Linux Container Host cluster, see [Deploy kured in an AKS cluster](../../articles/aks/node-updates-kured.md#deploy-kured-in-an-aks-cluster)
73
+
We recommend enabling an automatic reboot daemon, such as [Kured](https://kured.dev/docs/), so that your cluster can reboot nodes that have taken kernel updates. To deploy the Kured DaemonSet in an Azure Linux Container Host cluster, see [Deploy Kured in an AKS cluster](../../articles/aks/node-updates-kured.md#deploy-kured-in-an-aks-cluster).
74
74
75
75
## Clean up resources
76
76
@@ -85,6 +85,7 @@ az group delete --name testAzureLinuxCluster --yes --no-wait
85
85
In this tutorial, you upgraded your Azure Linux Container Host cluster. You learned how to:
86
86
87
87
> [!div class="checklist"]
88
+
>
88
89
> * Manually upgrade the node-image on a cluster.
89
90
> * Automatically upgrade an Azure Linux Container Host cluster.
90
91
> * Deploy kured in an Azure Linux Container Host cluster.
0 commit comments