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/use-ultra-disks.md
+6-30Lines changed: 6 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,30 +18,6 @@ This feature can only be set at cluster creation or node pool creation time.
18
18
> [!IMPORTANT]
19
19
> Azure ultra disks require nodepools deployed in availability zones and regions that support these disks as well as only specific VM series. See the [**Ultra disks GA scope and limitations**](../virtual-machines/disks-enable-ultra-ssd.md#ga-scope-and-limitations).
20
20
21
-
### Register the `EnableUltraSSD` preview feature
22
-
23
-
To create an AKS cluster or a node pool that can leverage Ultra disks, you must enable the `EnableUltraSSD` feature flag on your subscription.
24
-
25
-
Register the `EnableUltraSSD` feature flag using the [az feature register][az-feature-register] command as shown in the following example:
26
-
27
-
```azurecli-interactive
28
-
az feature register --namespace "Microsoft.ContainerService" --name "EnableUltraSSD"
29
-
```
30
-
31
-
It takes a few minutes for the status to show *Registered*. You can check on the registration status using the [az feature list][az-feature-list] command:
32
-
33
-
```azurecli-interactive
34
-
az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/EnableUltraSSD')].{Name:name,State:properties.state}"
35
-
```
36
-
37
-
When ready, refresh the registration of the *Microsoft.ContainerService* resource provider using the [az provider register][az-provider-register] command:
38
-
39
-
```azurecli-interactive
40
-
az provider register --namespace Microsoft.ContainerService
41
-
```
42
-
43
-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
44
-
45
21
### Install aks-preview CLI extension
46
22
47
23
To create an AKS cluster or a node pool that can use Ultra Disks, you need the latest *aks-preview* CLI extension. Install the *aks-preview* Azure CLI extension using the [az extension add][az-extension-add] command, or install any available updates using the [az extension update][az-extension-update] command:
@@ -60,7 +36,7 @@ az extension update --name aks-preview
60
36
61
37
## Create a new cluster that can use Ultra disks
62
38
63
-
Create an AKS cluster that is able to leverage Ultra Disks by using the following CLI commands. Use the `--aks-custom-headers` flag to set the `EnableUltraSSD` feature.
39
+
Create an AKS cluster that is able to leverage Ultra Disks by using the following CLI commands. Use the `--enable-ultra-ssd` flag to set the `EnableUltraSSD` feature.
64
40
65
41
Create an Azure resource group:
66
42
@@ -73,20 +49,20 @@ Create the AKS cluster with support for Ultra Disks.
73
49
74
50
```azurecli-interactive
75
51
# Create an AKS-managed Azure AD cluster
76
-
az aks create -g MyResourceGroup -n MyManagedCluster -l westus2 --node-vm-size Standard_L8s_v2 --zones 1 2 --node-count 2 --aks-custom-headers EnableUltraSSD=true
52
+
az aks create -g MyResourceGroup -n MyManagedCluster -l westus2 --node-vm-size Standard_D2s_v3 --zones 1 2 --node-count 2 --enable-ultra-ssd
77
53
```
78
54
79
-
If you want to create clusters without ultra disk support, you can do so by omitting the custom `--aks-custom-headers` parameter.
55
+
If you want to create clusters without ultra disk support, you can do so by omitting the `--enable-ultra-ssd` parameter.
80
56
81
57
## Enable Ultra disks on an existing cluster
82
58
83
-
You can enable ultra disks on existing clusters by adding a new node pool to your cluster that support ultra disks. Configure a new node pool to use ultra disks by using the `--aks-custom-headers` flag.
59
+
You can enable ultra disks on existing clusters by adding a new node pool to your cluster that support ultra disks. Configure a new node pool to use ultra disks by using the `--enable-ultra-ssd` flag.
84
60
85
61
```azurecli
86
-
az aks nodepool add --name ultradisk --cluster-name myAKSCluster --resource-group myResourceGroup --node-vm-size Standard_L8s_v2 --zones 1 2 --node-count 2 --aks-custom-headers EnableUltraSSD=true
62
+
az aks nodepool add --name ultradisk --cluster-name myAKSCluster --resource-group myResourceGroup --node-vm-size Standard_D2s_v3 --zones 1 2 --node-count 2 --enable-ultra-ssd
87
63
```
88
64
89
-
If you want to create new node pools without support for ultra disks, you can do so by omitting the custom `--aks-custom-headers` parameter.
65
+
If you want to create new node pools without support for ultra disks, you can do so by omitting the `--enable-ultra-ssd` parameter.
90
66
91
67
## Use ultra disks dynamically with a storage class
0 commit comments