Skip to content

Commit c5f4bb2

Browse files
Merge pull request #210252 from justindavies/arm64-ga
Remove ARM64 preview tags
2 parents e4a59b1 + 9f36b9a commit c5f4bb2

File tree

1 file changed

+15
-44
lines changed

1 file changed

+15
-44
lines changed

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

Lines changed: 15 additions & 44 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.
@@ -120,44 +120,9 @@ The following example output shows that *mynodepool* has been successfully creat
120120
> [!TIP]
121121
> 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.
122122
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
132124

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.
161126

162127
Use `az aks nodepool add` command to add an ARM64 node pool.
163128

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

419385
```azurecli-interactive
420386
az aks create -g MyRG --cluster-name MyMC --capacityReservationGroup myCRG
421387
```
388+
422389
Deleting a node pool command will implicitly dissociate a node pool from any associated capacity reservation group, before that node pool is deleted.
423390

424391
```azurecli-interactive
425392
az aks nodepool delete -g MyRG --cluster-name MyMC -n myAP
426393
```
394+
427395
Deleting a cluster command implicitly dissociates all node pools in a cluster from their associated capacity reservation groups.
428396

429397
```azurecli-interactive
@@ -802,16 +770,16 @@ az group delete --name myResourceGroup2 --yes --no-wait
802770

803771
## Next steps
804772

805-
Learn more about [system node pools][use-system-pool].
773+
* Learn more about [system node pools][use-system-pool].
806774

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

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

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.
812780

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

823791
<!-- 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
824795
[aks-quickstart-windows-cli]: ./learn/quick-windows-container-deploy-cli.md
825796
[az-aks-get-credentials]: /cli/azure/aks#az_aks_get_credentials
826797
[az-aks-create]: /cli/azure/aks#az_aks_create

0 commit comments

Comments
 (0)