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/node-pool-snapshot.md
+3-39Lines changed: 3 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Snapshot Azure Kubernetes Service (AKS) node pools (preview)
2
+
title: Snapshot Azure Kubernetes Service (AKS) node pools
3
3
description: Learn how to snapshot AKS cluster node pools and create clusters and node pools from a snapshot.
4
4
ms.service: container-service
5
5
ms.topic: article
@@ -9,58 +9,22 @@ author: palma21
9
9
10
10
---
11
11
12
-
# Azure Kubernetes Service (AKS) node pool snapshot (preview)
12
+
# Azure Kubernetes Service (AKS) node pool snapshot
13
13
14
14
AKS releases a new node image weekly and every new cluster, new node pool, or upgrade cluster will always receive the latest image that can make it hard to maintain your environments consistent and to have repeatable environments.
15
15
16
16
Node pool snapshots allow you to take a configuration snapshot of your node pool and then create new node pools or new clusters based of that snapshot for as long as that configuration and kubernetes version is supported. For more information on the supportability windows, see [Supported Kubernetes versions in AKS][supported-versions].
17
17
18
18
The snapshot is an Azure resource that will contain the configuration information from the source node pool such as the node image version, kubernetes version, OS type, and OS SKU. You can then reference this snapshot resource and the respective values of its configuration to create any new node pool or cluster based off of it.
19
19
20
-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
21
-
22
20
## Before you begin
23
21
24
22
This article assumes that you have an existing AKS cluster. If you need an AKS cluster, see the AKS quickstart [using the Azure CLI][aks-quickstart-cli] or [using the Azure portal][aks-quickstart-portal].
25
23
26
24
### Limitations
27
25
28
26
- Any node pool or cluster created from a snapshot must use a VM from the same virtual machine family as the snapshot, for example, you can't create a new N-Series node pool based of a snapshot captured from a D-Series node pool because the node images in those cases are structurally different.
29
-
- During preview, snapshots must be created and used in the same region as the source node pool.
30
-
31
-
### Install aks-preview CLI extension
32
-
33
-
You also need the *aks-preview* Azure CLI extension version 0.5.40 or later. Install the *aks-preview* Azure CLI extension by using the [az extension add][az-extension-add] command. Or install any available updates by using the [az extension update][az-extension-update] command.
34
-
35
-
```azurecli-interactive
36
-
# Install the aks-preview extension
37
-
az extension add --name aks-preview
38
-
39
-
# Update the extension to make sure you have the latest version installed
40
-
az extension update --name aks-preview
41
-
```
42
-
43
-
### Register the `SnapshotPreview` preview feature
44
-
45
-
To use the feature, you must also enable the `SnapshotPreview` feature flag on your subscription.
46
-
47
-
Register the `SnapshotPreview` feature flag by using the [az feature register][az-feature-register] command, as shown in the following example:
48
-
49
-
```azurecli-interactive
50
-
az feature register --namespace "Microsoft.ContainerService" --name "SnapshotPreview"
51
-
```
52
-
53
-
It takes a few minutes for the status to show *Registered*. Verify the registration status by using the [az feature list][az-feature-list] command:
54
-
55
-
```azurecli-interactive
56
-
az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/SnapshotPreview')].{Name:name,State:properties.state}"
57
-
```
58
-
59
-
When ready, refresh the registration of the *Microsoft.ContainerService* resource provider by using the [az provider register][az-provider-register] command:
60
-
61
-
```azurecli-interactive
62
-
az provider register --namespace Microsoft.ContainerService
63
-
```
27
+
- Snapshots must be created and used in the same region as the source node pool.
0 commit comments