Escalado manual del número de nodos en un clúster de Azure Kubernetes Service (AKS)

Si cambian las necesidades de recursos de las aplicaciones, el rendimiento del clúster puede verse afectado debido a una capacidad baja en CPU, memoria, espacio en PID o tamaños de disco. Para solucionar estos cambios, puede escalar manualmente el clúster de AKS para ejecutar un número diferente de nodos. Durante el escalado hacia adentro, los nodos se acordonarán y vaciarán cautelosamente para minimizar las interrupciones en las aplicaciones en ejecución. Durante el escalado horizontal, AKS espera a que el clúster de Kubernetes marque los nodos en estado Listo antes de que se programen pods en ellos.

En este artículo se describe cómo aumentar o disminuir manualmente el número de nodos de un clúster de AKS.

Note

Este artículo se aplica a los clústeres estándar de AKS. Los clústeres automáticos de AKS usan el aprovisionamiento automático de nodos para administrar el escalado de nodos.

Antes de empezar

• Revise las cuotas y los límites del servicio de AKS para comprobar que el clúster se puede escalar al número deseado de nodos.

• Si el escalador automático del clúster está habilitado en el grupo de nodos, no puede cambiar manualmente el número de nodos. Puede actualizar los valores mínimo y máximo del escalador automático del clúster o deshabilitar el escalador automático del clúster en el grupo de nodos antes de escalarlo manualmente.

• El soporte de Azure Linux 2.0 finalizó el 30 de noviembre de 2025. A partir del 31 de marzo de 2026, se retiraron las imágenes de nodo de Azure Linux 2.0, y los grupos de nodos afectados ya no se pueden escalar. Migre a Azure Linux 3 antes de escalar un grupo de nodos de Linux 2.0 de Azure.

• Los nombres del grupo de nodos deben cumplir los siguientes requisitos:

  Tipo de grupo de nodos	Requisitos de nombre
  Linux	Entre 1 y 12 caracteres alfanuméricos en minúsculas. Debe comenzar con una letra minúscula.
  Windows	Entre 1 y 6 caracteres alfanuméricos en minúsculas. Debe comenzar con una letra minúscula.

Escalado de nodos de clúster en AKS

Importante

No se admite la eliminación de nodos de un grupo de nodos mediante el kubectl comando . Esta acción puede crear problemas de escalado con el clúster de AKS.

CLI de Azure

1. Obtenga el nombre, el modo y el recuento de nodos de los grupos de nodos mediante el az aks show comando . En el ejemplo siguiente se obtienen los detalles del grupo de nodos del clúster denominado myAKSCluster en el grupo de recursos myResourceGroup :

   az aks show --resource-group myResourceGroup --name myAKSCluster --query "agentPoolProfiles[].{Name:name,Mode:mode,Count:count}" --output table
   

   En la salida de ejemplo siguiente se muestra que nodepool1 es un grupo de nodos del sistema con tres nodos:

   Name       Mode    Count
   ---------  ------  -------
   nodepool1  System  3
   

2. Escale los nodos del clúster mediante el az aks scale comando . En el ejemplo siguiente se escala nodepool1 en el clúster denominado myAKSCluster a dos nodos:

   az aks scale --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-name nodepool1 --query "agentPoolProfiles[?name=='nodepool1'].{Name:name,Mode:mode,Count:count}" --output table
   

   En la salida de ejemplo siguiente se muestra que el grupo de nodos del sistema se ha escalado correctamente a dos nodos:

   Name       Mode    Count
   ---------  ------  -------
   nodepool1  System  2
   

   Los grupos de nodos del sistema deben tener al menos dos nodos. En el caso de los clústeres de producción, use al menos tres nodos en un grupo de nodos del sistema. Para obtener más información, consulte Pods de nodos del sistema y usuario.

Azure PowerShell

1. Obtenga el nombre, el modo, el recuento de nodos y el estado de aprovisionamiento de los grupos de nodos mediante el Get-AzAksCluster comando . En el ejemplo siguiente se obtienen los detalles del grupo de nodos del clúster denominado myAKSCluster en el grupo de recursos myResourceGroup :

   Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
     Select-Object -ExpandProperty AgentPoolProfiles |
     Select-Object Name, Mode, Count, ProvisioningState
   

   En la salida de ejemplo siguiente se muestra que nodepool1 es un grupo de nodos del sistema con tres nodos:

   Name                   : nodepool1
   Mode                   : System
   Count                  : 3
   ProvisioningState      : Succeeded
   

2. Escale los nodos del clúster mediante el comando Set-AzAksCluster . El -NodeName parámetro acepta el nombre del grupo de nodos. En el ejemplo siguiente se escala nodepool1 en el clúster denominado myAKSCluster a dos nodos:

   Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -NodeCount 2 -NodeName nodepool1 |
     Select-Object -ExpandProperty AgentPoolProfiles |
     Where-Object Name -eq nodepool1 |
     Select-Object Name, Mode, Count, ProvisioningState
   

   En la salida de ejemplo siguiente se muestra que el grupo de nodos del sistema se ha escalado correctamente a dos nodos:

   Name                   : nodepool1
   Mode                   : System
   Count                  : 2
   ProvisioningState      : Succeeded
   

   Los grupos de nodos del sistema deben tener al menos dos nodos. En el caso de los clústeres de producción, use al menos tres nodos en un grupo de nodos del sistema. Para obtener más información, consulte Pods de nodos del sistema y usuario.

Escalado de grupos de nodos de usuario a 0

A diferencia de los grupos de nodos del sistema que siempre requieren nodos en ejecución, los grupos de nodos de usuario pueden escalar a 0. Para obtener más información sobre las diferencias entre los grupos de nodos de usuario y del sistema, consulte Grupos de nodos de usuario y sistema.

Importante

Para escalar un grupo de nodos de usuario a 0 nodos, deshabilite el escalador automático del clúster. Para más información, consulte Deshabilitar el escalador automático de clústeres en un grupo de nodos.

CLI de Azure

Para escalar un grupo de nodos de usuario a 0, use az aks nodepool scale en lugar del comando az aks scale que se usa para el escalado general de nodos, y establezca --node-count en 0.

az aks nodepool scale --name <your node pool name> --cluster-name myAKSCluster --resource-group myResourceGroup  --node-count 0

Puede permitir, pero no forzar, el escalado automático a cero nodos en grupos de nodos de usuario de escalado automático estableciendo el --min-count parámetro de Cluster Autoscaler en 0.

Azure PowerShell

Para escalar un grupo de nodos de usuario a 0, use Update-AzAksNodePool en lugar del comando Set-AzAksCluster usado para el escalado general de nodos, y establezca -NodeCount en 0.

Update-AzAksNodePool -Name <your node pool name> -ClusterName myAKSCluster -ResourceGroupName myResourceGroup -NodeCount 0

Puede permitir, pero no forzar, el escalado automático a cero nodos en grupos de nodos de usuario con escalado automático estableciendo el parámetro -MinCount en 0:

Update-AzAksNodePool -Name <your node pool name> -ClusterName myAKSCluster -ResourceGroupName myResourceGroup -EnableAutoScaling -MinCount 0 -MaxCount <maximum node count>

Pasos siguientes

En este artículo, escaló manualmente un clúster de AKS para aumentar o disminuir el número de nodos. También puede usar el escalador automático del clúster para escalar automáticamente el clúster.