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
- Upgrade to the latest version of the `aks-preview` cli extension by running `az extension add --upgrade --name aks-preview`
21
-
22
20
> [!IMPORTANT]
23
21
> This Quickstart will work for most use cases. The only exception is if you plan to use Azure Elastic SAN Preview as backing storage for your storage pool and you don't have owner-level access to the Azure subscription. If both these statements apply to you, use the [manual installation steps](install-container-storage-aks.md) instead.
24
22
23
+
## Getting started
24
+
25
+
- Take note of your Azure subscription ID. We recommend using a subscription on which you have an [Owner](../../role-based-access-control/built-in-roles.md#owner) role.
26
+
27
+
-[Launch Azure Cloud Shell](https://shell.azure.com), or if you're using a local installation, sign in to the Azure CLI by using the [az login](/cli/azure/reference-index#az-login) command.
28
+
29
+
- If you're using Azure Cloud Shell, you might be prompted to mount storage. Select the Azure subscription where you want to create the storage account and select **Create**.
30
+
31
+
## Install the latest AKS preview extension
32
+
33
+
Upgrade to the latest version of the `aks-preview` cli extension by running the following command.
34
+
35
+
```azurecli-interactive
36
+
az extension add --upgrade --name aks-preview
37
+
```
25
38
26
39
## Set subscription context
27
40
@@ -33,7 +46,7 @@ az account set --subscription <subscription-id>
33
46
34
47
## Register resource providers
35
48
36
-
The `Microsoft.ContainerService` and `Microsoft.KubernetesConfiguration` resource providers must be registered on your Azure subscription. To register these providers, run the following command:
49
+
The `Microsoft.ContainerService` and `Microsoft.KubernetesConfiguration` resource providers must be registered on your Azure subscription. To register these providers, run the following commands:
37
50
38
51
```azurecli-interactive
39
52
az provider register --namespace Microsoft.ContainerService --wait
@@ -57,7 +70,7 @@ az group create --name <resource-group-name> --location <location>
57
70
58
71
If the resource group was created successfully, you'll see output similar to this:
@@ -91,10 +104,10 @@ If you intend to use Azure Elastic SAN Preview or Azure Disks as backing storage
91
104
92
105
## Create a new AKS cluster and install Azure Container Storage
93
106
94
-
Run the following command to create a new AKS cluster, install Azure Container Storage, and create a storage pool. Replace `<cluster-name>` and `<resource-group-name>` with your own values, and specify which VM type you want to use. You'll need a node pool of at least three Linux VMs. Replace `<storage-pool-type>` with `azureDisk`, `ephemeraldisk`, or `elasticSan`.
95
-
96
107
If you already have an AKS cluster deployed, skip this section and go to [Install Azure Container Storage on an existing AKS cluster](#install-azure-container-storage-on-an-existing-aks-cluster).
97
108
109
+
Run the following command to create a new AKS cluster, install Azure Container Storage, and create a storage pool. Replace `<cluster-name>` and `<resource-group-name>` with your own values, and specify which VM type you want to use. You'll need a node pool of at least three Linux VMs. Replace `<storage-pool-type>` with `azureDisk`, `ephemeraldisk`, or `elasticSan`.
110
+
98
111
Optional storage pool parameters:
99
112
100
113
|**Parameter**|**Default**|
@@ -115,7 +128,7 @@ The deployment will take 10-15 minutes to complete.
115
128
If you already have an AKS cluster that meets the [VM requirements](#choose-a-vm-type-for-your-cluster), run the following command to install Azure Container Storage on the cluster and create a storage pool. Replace `<cluster-name>` and `<resource-group-name>` with your own values. Replace `<storage-pool-type>` with `azureDisk`, `ephemeraldisk`, or `elasticSan`.
116
129
117
130
> [!IMPORTANT]
118
-
> **If you created your AKS cluster using the Azure portal:** The cluster will likely have a user node pool and a system/agent node pool. Before you can install Azure Container Storage, you must update the user node pool label as described in this section. However, if your cluster consists of only a system node pool, which is the case with test/dev clusters created with the Azure portal, you'll need to first [add a new user node pool](../../aks/create-node-pools.md#add-a-node-pool) and then label it. This is because when you create an AKS cluster using the Azure portal, a taint `CriticalAddOnsOnly` is added to the agent/system nodepool, which blocks installation of Azure Container Storage on the system node pool. This taint isn't added when an AKS cluster is created using Azure CLI.
131
+
> **If you created your AKS cluster using the Azure portal:** The cluster will likely have a user node pool and a system/agent node pool. However, if your cluster consists of only a system node pool, which is the case with test/dev clusters created with the Azure portal, you'll need to first [add a new user node pool](../../aks/create-node-pools.md#add-a-node-pool) and then label it. This is because when you create an AKS cluster using the Azure portal, a taint `CriticalAddOnsOnly` is added to the system/agent nodepool, which blocks installation of Azure Container Storage on the system node pool. This taint isn't added when an AKS cluster is created using Azure CLI.
119
132
120
133
```azurecli-interactive
121
134
az aks update --n <cluster-name> --g <resource-group-name> --enable-azure-container-storage <storage-pool-type>
Copy file name to clipboardExpand all lines: articles/storage/container-storage/install-container-storage-aks.md
+5-4Lines changed: 5 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,20 +4,21 @@ description: Learn how to install Azure Container Storage Preview for use with A
4
4
author: khdownie
5
5
ms.service: azure-container-storage
6
6
ms.topic: how-to
7
-
ms.date: 10/25/2023
7
+
ms.date: 10/27/2023
8
8
ms.author: kendownie
9
9
ms.custom: devx-track-azurecli
10
10
---
11
11
12
12
# Install Azure Container Storage Preview for use with Azure Kubernetes Service
13
-
[Azure Container Storage](container-storage-introduction.md) is a cloud-based volume management, deployment, and orchestration service built natively for containers. This article shows you how to create an [Azure Kubernetes Service (AKS)](../../aks/intro-kubernetes.md) cluster and install Azure Container Storage Preview on the cluster. Alternatively, you can install Azure Container Storage Preview [using a two-step QuickStart](container-storage-aks-quickstart.md) instead of following the manual steps outlined in this article.
13
+
14
+
[Azure Container Storage](container-storage-introduction.md) is a cloud-based volume management, deployment, and orchestration service built natively for containers. This article shows you how to create an [Azure Kubernetes Service (AKS)](../../aks/intro-kubernetes.md) cluster, label the node pool, and install Azure Container Storage Preview on the cluster. Alternatively, you can install Azure Container Storage Preview [using a QuickStart](container-storage-aks-quickstart.md) instead of following the manual steps in this article.
0 commit comments