Skip to content

Commit 9f36b9a

Browse files
author
Justin Davies
committed
Make docs team changes
1 parent a7f15bf commit 9f36b9a

File tree

1 file changed

+14
-8
lines changed

1 file changed

+14
-8
lines changed

articles/aks/use-multiple-node-pools.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.date: 05/16/2022
1212
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.
1313

1414
> [!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.
1616
1717
This article shows you how to create and manage multiple node pools in an AKS cluster.
1818

@@ -36,7 +36,7 @@ The following limitations apply when you create and manage AKS clusters that sup
3636

3737
## Create an AKS cluster
3838

39-
> [!Important]
39+
> [!IMPORTANT]
4040
> 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.
4141
4242
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.
@@ -122,7 +122,7 @@ The following example output shows that *mynodepool* has been successfully creat
122122
123123
### Add an ARM64 node pool
124124

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].
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.
126126

127127
Use `az aks nodepool add` command to add an ARM64 node pool.
128128

@@ -379,16 +379,19 @@ Associating a node pool with an existing capacity reservation group can be done
379379
```azurecli-interactive
380380
az aks nodepool add -g MyRG --cluster-name MyMC -n myAP --capacityReservationGroup myCRG
381381
```
382+
382383
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.
383384

384385
```azurecli-interactive
385386
az aks create -g MyRG --cluster-name MyMC --capacityReservationGroup myCRG
386387
```
388+
387389
Deleting a node pool command will implicitly dissociate a node pool from any associated capacity reservation group, before that node pool is deleted.
388390

389391
```azurecli-interactive
390392
az aks nodepool delete -g MyRG --cluster-name MyMC -n myAP
391393
```
394+
392395
Deleting a cluster command implicitly dissociates all node pools in a cluster from their associated capacity reservation groups.
393396

394397
```azurecli-interactive
@@ -767,16 +770,16 @@ az group delete --name myResourceGroup2 --yes --no-wait
767770

768771
## Next steps
769772

770-
Learn more about [system node pools][use-system-pool].
773+
* Learn more about [system node pools][use-system-pool].
771774

772-
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].
773776

774-
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].
775778

776-
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.
777780

778781
<!-- EXTERNAL LINKS -->
779-
[arm-vm-sku]: https://azure.microsoft.com/updates/public-preview-arm64based-azure-vms-can-deliver-up-to-50-better-priceperformance/
782+
780783
[kubernetes-drain]: https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/
781784
[kubectl-get]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#get
782785
[kubectl-taint]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#taint
@@ -786,6 +789,9 @@ Use [proximity placement groups][reduce-latency-ppg] to reduce latency for your
786789
[capacity-reservation-groups]:/azure/virtual-machines/capacity-reservation-associate-virtual-machine-scale-set
787790

788791
<!-- INTERNAL LINKS -->
792+
[arm-sku-vm1]: ../virtual-machines/dpsv5-dpdsv5-series.md
793+
[arm-sku-vm2]: ../virtual-machines/dplsv5-dpldsv5-series.md
794+
[arm-sku-vm3]: ../virtual-machines/epsv5-epdsv5-series.md
789795
[aks-quickstart-windows-cli]: ./learn/quick-windows-container-deploy-cli.md
790796
[az-aks-get-credentials]: /cli/azure/aks#az_aks_get_credentials
791797
[az-aks-create]: /cli/azure/aks#az_aks_create

0 commit comments

Comments
 (0)