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-multiple-node-pools.md
+15-44Lines changed: 15 additions & 44 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.date: 05/16/2022
12
12
In Azure Kubernetes Service (AKS), nodes of the same configuration are grouped together into *node pools*. These node pools contain the underlying VMs that run your applications. The initial number of nodes and their size (SKU) is defined when you create an AKS cluster, which creates a [system node pool][use-system-pool]. To support applications that have different compute or storage demands, you can create additional *user node pools*. System node pools serve the primary purpose of hosting critical system pods such as CoreDNS and tunnelfront. User node pools serve the primary purpose of hosting your application pods. However, application pods can be scheduled on system node pools if you wish to only have one pool in your AKS cluster. User node pools are where you place your application-specific pods. For example, use these additional user node pools to provide GPUs for compute-intensive applications, or access to high-performance SSD storage.
13
13
14
14
> [!NOTE]
15
-
> This feature enables higher control over how to create and manage multiple node pools. As a result, separate commands are required for create/update/delete. Previously cluster operations through `az aks create` or `az aks update` used the managedCluster API and were the only option to change your control plane and a single node pool. This feature exposes a separate operation set for agent pools through the agentPool API and require use of the `az aks nodepool` command set to execute operations on an individual node pool.
15
+
> This feature enables higher control over how to create and manage multiple node pools. As a result, separate commands are required for create/update/delete. Previously cluster operations through `az aks create` or `az aks update` used the managedCluster API and were the only options to change your control plane and a single node pool. This feature exposes a separate operation set for agent pools through the agentPool API and require use of the `az aks nodepool` command set to execute operations on an individual node pool.
16
16
17
17
This article shows you how to create and manage multiple node pools in an AKS cluster.
18
18
@@ -36,7 +36,7 @@ The following limitations apply when you create and manage AKS clusters that sup
36
36
37
37
## Create an AKS cluster
38
38
39
-
> [!Important]
39
+
> [!IMPORTANT]
40
40
> If you run a single system node pool for your AKS cluster in a production environment, we recommend you use at least three nodes for the node pool.
41
41
42
42
To get started, create an AKS cluster with a single node pool. The following example uses the [az group create][az-group-create] command to create a resource group named *myResourceGroup* in the *eastus* region. An AKS cluster named *myAKSCluster* is then created using the [az aks create][az-aks-create] command.
@@ -120,44 +120,9 @@ The following example output shows that *mynodepool* has been successfully creat
120
120
> [!TIP]
121
121
> If no *VmSize* is specified when you add a node pool, the default size is *Standard_D2s_v3* for Windows node pools and *Standard_DS2_v2* for Linux node pools. If no *OrchestratorVersion* is specified, it defaults to the same version as the control plane.
122
122
123
-
### Add an ARM64 node pool (preview)
124
-
125
-
The ARM64 processor provides low power compute for your Kubernetes workloads. To create an ARM64 node pool, you will need to choose an [ARM capable instance SKU][arm-sku-vm].
126
-
127
-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
128
-
129
-
#### Install the `aks-preview` Azure CLI
130
-
131
-
You also need the *aks-preview* Azure CLI extension version 0.5.23 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.
123
+
### Add an ARM64 node pool
132
124
133
-
```azurecli-interactive
134
-
# Install the aks-preview extension
135
-
az extension add --name aks-preview
136
-
# Update the extension to make sure you have the latest version installed
137
-
az extension update --name aks-preview
138
-
```
139
-
140
-
#### Register the `AKSARM64Preview` preview feature
141
-
142
-
To use the feature, you must also enable the `AKSARM64Preview` feature flag on your subscription.
143
-
144
-
Register the `AKSARM64Preview` feature flag by using the [az feature register][az-feature-register] command, as shown in the following example:
145
-
146
-
```azurecli-interactive
147
-
az feature register --namespace "Microsoft.ContainerService" --name "AKSARM64Preview"
148
-
```
149
-
150
-
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:
151
-
152
-
```azurecli-interactive
153
-
az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/AKSARM64Preview')].{Name:name,State:properties.state}"
154
-
```
155
-
156
-
When ready, refresh the registration of the *Microsoft.ContainerService* resource provider by using the [az provider register][az-provider-register] command:
157
-
158
-
```azurecli-interactive
159
-
az provider register --namespace Microsoft.ContainerService
160
-
```
125
+
The ARM64 processor provides low power compute for your Kubernetes workloads. To create an ARM64 node pool, you will need to choose a [Dpsv5][arm-sku-vm1], [Dplsv5][arm-sku-vm2] or [Epsv5][arm-sku-vm3] series Virtual Machine.
161
126
162
127
Use `az aks nodepool add` command to add an ARM64 node pool.
163
128
@@ -414,16 +379,19 @@ Associating a node pool with an existing capacity reservation group can be done
414
379
```azurecli-interactive
415
380
az aks nodepool add -g MyRG --cluster-name MyMC -n myAP --capacityReservationGroup myCRG
416
381
```
382
+
417
383
Associating a system node pool with an existing capacity reservation group can be done using [az aks create][az-aks-create] command. If the capacity reservation group specified doesn't exist, then a warning is issued and the cluster gets created without any capacity reservation group association.
418
384
419
385
```azurecli-interactive
420
386
az aks create -g MyRG --cluster-name MyMC --capacityReservationGroup myCRG
421
387
```
388
+
422
389
Deleting a node pool command will implicitly dissociate a node pool from any associated capacity reservation group, before that node pool is deleted.
423
390
424
391
```azurecli-interactive
425
392
az aks nodepool delete -g MyRG --cluster-name MyMC -n myAP
426
393
```
394
+
427
395
Deleting a cluster command implicitly dissociates all node pools in a cluster from their associated capacity reservation groups.
428
396
429
397
```azurecli-interactive
@@ -802,16 +770,16 @@ az group delete --name myResourceGroup2 --yes --no-wait
802
770
803
771
## Next steps
804
772
805
-
Learn more about [system node pools][use-system-pool].
773
+
* Learn more about [system node pools][use-system-pool].
806
774
807
-
In this article, you learned how to create and manage multiple node pools in an AKS cluster. For more information about how to control pods across node pools, see [Best practices for advanced scheduler features in AKS][operator-best-practices-advanced-scheduler].
775
+
* In this article, you learned how to create and manage multiple node pools in an AKS cluster. For more information about how to control pods across node pools, see [Best practices for advanced scheduler features in AKS][operator-best-practices-advanced-scheduler].
808
776
809
-
To create and use Windows Server container node pools, see [Create a Windows Server container in AKS][aks-quickstart-windows-cli].
777
+
* To create and use Windows Server container node pools, see [Create a Windows Server container in AKS][aks-quickstart-windows-cli].
810
778
811
-
Use [proximity placement groups][reduce-latency-ppg] to reduce latency for your AKS applications.
779
+
* Use [proximity placement groups][reduce-latency-ppg] to reduce latency for your AKS applications.
0 commit comments