Skip to content

Commit d894efb

Browse files
committed
kd final edits
1 parent b19e76e commit d894efb

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

articles/storage/container-storage/container-storage-aks-quickstart.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -52,10 +52,10 @@ When you create a resource group, you're prompted to specify a location. This lo
5252
- The storage location of your resource group metadata.
5353
- Where your resources will run in Azure if you don't specify another region during resource creation.
5454

55-
Create a resource group using the `az group create` command. Replace `<resource-group-name>` with the name of the resource group you want to create, and replace `<location>` with an Azure region such as *eastus*, *westus2*, *westus3*, or *westeurope*. See this [list of Azure regions](container-storage-introduction.md#regional-availability) where Azure Container Storage is available.
55+
Create a resource group using the `az group create` command. Replace `<resource-group>` with the name of the resource group you want to create, and replace `<location>` with an Azure region such as *eastus*, *westus2*, *westus3*, or *westeurope*. See this [list of Azure regions](container-storage-introduction.md#regional-availability) where Azure Container Storage is available.
5656

5757
```azurecli-interactive
58-
az group create --name <resource-group-name> --location <location>
58+
az group create --name <resource-group> --location <location>
5959
```
6060

6161
If the resource group was created successfully, you'll see output similar to this:
@@ -113,14 +113,14 @@ You'll specify the VM type when you create the cluster in the next section. Foll
113113

114114
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).
115115

116-
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. Replace `<storage-pool-type>` with `azureDisk`, `ephemeralDisk`, or `elasticSan`. If you select `ephemeralDisk`, you can also specify `--storage-pool-option`, and the values can be `NVMe` or `Temp`.
116+
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>` with your own values, and specify which VM type you want to use. Replace `<storage-pool-type>` with `azureDisk`, `ephemeralDisk`, or `elasticSan`. If you select `ephemeralDisk`, you can also specify `--storage-pool-option`, and the values can be `NVMe` or `Temp`.
117117

118118
Running this command will enable Azure Container Storage on the system node pool\* with three Linux VMs. By default, the system node pool is named `nodepool1`. If you want to enable Azure Container Storage on other node pools, see [Install Azure Container Storage on specific node pools](#install-azure-container-storage-on-specific-node-pools). If you want to specify additional storage pool parameters with this command, see [this table](container-storage-faq.md#storage-pool-parameters).
119119

120120
\*If there are any existing node pools with the `acstor.azure.com/io-engine:acstor` label then Azure Container Storage will be installed there by default. Otherwise, it's installed on the system node pool.
121121

122122
```azurecli-interactive
123-
az aks create -n <cluster-name> -g <resource-group-name> --node-vm-size Standard_D4s_v3 --node-count 3 --enable-azure-container-storage <storage-pool-type>
123+
az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_D4s_v3 --node-count 3 --enable-azure-container-storage <storage-pool-type>
124124
```
125125

126126
The deployment will take 10-15 minutes. When it completes, you'll have an AKS cluster with Azure Container Storage installed, the components for your chosen storage pool type enabled, and a default storage pool. If you want to enable additional storage pool types to create additional storage pools, see [Enable additional storage pool types](#enable-additional-storage-pool-types).
@@ -146,7 +146,7 @@ If the `Message` doesn't say `StoragePool is ready`, then your storage pool is s
146146

147147
## Install Azure Container Storage on an existing AKS cluster
148148

149-
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`.
149+
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>` with your own values. Replace `<storage-pool-type>` with `azureDisk`, `ephemeraldisk`, or `elasticSan`.
150150

151151
Running this command will enable Azure Container Storage on the system node pool, which by default is named `nodepool1`\*. If you want to enable it on other node pools, see [Install Azure Container Storage on specific node pools](#install-azure-container-storage-on-specific-node-pools). If you want to specify additional storage pool parameters, see [this table](container-storage-faq.md#storage-pool-parameters).
152152

@@ -156,7 +156,7 @@ Running this command will enable Azure Container Storage on the system node pool
156156
> **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 node pool, 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.
157157
158158
```azurecli-interactive
159-
az aks update -n <cluster-name> -g <resource-group-name> --enable-azure-container-storage <storage-pool-type>
159+
az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type>
160160
```
161161

162162
The deployment will take 10-15 minutes to complete.
@@ -165,26 +165,26 @@ The deployment will take 10-15 minutes to complete.
165165

166166
If you want to install Azure Container Storage on specific node pools, follow these instructions. The node pools must contain at least three Linux VMs each.
167167

168-
1. Run the following command to view the list of available node pools. Replace `<resource-group-name>` and `<cluster-name>` with your own values.
168+
1. Run the following command to view the list of available node pools. Replace `<resource-group>` and `<cluster-name>` with your own values.
169169

170170
```azurecli-interactive
171-
az aks nodepool list --resource-group <resource-group-name> --cluster-name <cluster-name>
171+
az aks nodepool list --resource-group <resource-group> --cluster-name <cluster-name>
172172
```
173173

174-
2. Run the following command to install Azure Container Storage on specific node pools. Replace `<cluster-name>` and `<resource-group-name>` with your own values. Replace `<storage-pool-type>` with `azureDisk`, `ephemeraldisk`, or `elasticSan`. If you select `ephemeralDisk`, you can also specify --storage-pool-option, and the values can be `NVMe` or `Temp`.
174+
2. Run the following command to install Azure Container Storage on specific node pools. Replace `<cluster-name>` and `<resource-group>` with your own values. Replace `<storage-pool-type>` with `azureDisk`, `ephemeraldisk`, or `elasticSan`. If you select `ephemeralDisk`, you can also specify --storage-pool-option, and the values can be `NVMe` or `Temp`.
175175

176176
```azurecli-interactive
177-
az aks update -n <cluster-name> -g <resource-group-name> --enable-azure-container-storage <storage-pool-type> --azure-container-storage-nodepools <comma separated values of nodepool names>
177+
az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type> --azure-container-storage-nodepools <comma separated values of nodepool names>
178178
```
179179

180180
## Enable additional storage pool types
181181

182-
If you want to enable a storage pool type that wasn't originally enabled during installation of Azure Container Storage, run the following command. Replace `<resource-group-name>` and `<cluster-name>`, and with your own values. For `<storage-pool-type>`, specify `azureDisk`, `ephemeralDisk`, or `elasticSan`.
182+
If you want to enable a storage pool type that wasn't originally enabled during installation of Azure Container Storage, run the following command. Replace `<cluster-name>` and `<resource-group>` with your own values. For `<storage-pool-type>`, specify `azureDisk`, `ephemeralDisk`, or `elasticSan`.
183183

184184
If you want to specify additional storage pool parameters with this command, see [this table](container-storage-faq.md#storage-pool-parameters).
185185

186186
```azurecli-interactive
187-
az aks update -n <cluster-name> -g <resource-group-name> --enable-azure-container-storage <storage-pool-type>
187+
az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type>
188188
```
189189

190190
If the new storage pool type that you've enabled takes up more resources than the storage pool type that's already enabled, the [resource consumption](#resource-consumption) will change to the maximum amount.
@@ -194,10 +194,10 @@ If the new storage pool type that you've enabled takes up more resources than th
194194
195195
## Disable storage pool types
196196

197-
If you're no longer using a specific storage pool type and want to disable it to free up resources in your node pool, run the following command. Replace `<resource-group-name>`, `<cluster-name>`, and `<storage-pool-type>` with your own values.
197+
If you're no longer using a specific storage pool type and want to disable it to free up resources in your node pool, run the following command. Replace `<cluster-name>` and `<resource-group>` with your own values. For `<storage-pool-type>`, specify `azureDisk`, `ephemeralDisk`, or `elasticSan`.
198198

199199
```azurecli-interactive
200-
az aks update -n <cluster-name> -g <resource-group-name> --disable-azure-container-storage <storage-pool-type>
200+
az aks update -n <cluster-name> -g <resource-group> --disable-azure-container-storage <storage-pool-type>
201201
```
202202

203203
> [!NOTE]

0 commit comments

Comments
 (0)