重设 Azure Kubernetes 服务 (AKS) 中的节点池大小

2025-08-04

由于部署数增加或运行更大的工作负载，可能需要更改虚拟机规模集计划或重设 AKS 实例的大小。但是，根据 AKS 的支持策略：

AKS 代理节点在 Azure 门户中显示为常规 Azure IaaS 资源。但是这些虚拟机被部署到自定义的 Azure 资源组（通常前缀为 MC_*）中。不能使用 IaaS API 或资源对这些节点进行任何直接的自定义。非通过 AKS API 执行的任何自定义更改都无法在升级、缩放、更新或重启后保留。

这种缺少持久性的情况也适用于重设大小操作，因此，不支持以此方式重设 AKS 实例的大小。本操作指南将介绍解决这种情况的建议方法。

重要

此方法特定于基于虚拟机规模集的 AKS 群集。使用虚拟机可用性集时，每个群集只能有一个节点池。

示例资源

假设你想要将名为 nodepool1 的现有节点池的大小从 SKU 大小 Standard_DS2_v2 重设为 Standard_DS3_v2。若要完成此任务，需要使用 Standard_DS3_v2 创建新的节点池，将工作负载从 nodepool1 移动到新的节点池，并删除 nodepool1。本示例将调用此新的节点池 mynodepool。

群集的 Azure 门户页的屏幕截图，其中已导航到“设置”>“节点池”。将显示一个名为“节点池 1”的节点池。

kubectl get nodes

NAME                                STATUS   ROLES   AGE   VERSION
aks-nodepool1-31721111-vmss000000   Ready    agent   10d   v1.21.9
aks-nodepool1-31721111-vmss000001   Ready    agent   10d   v1.21.9
aks-nodepool1-31721111-vmss000002   Ready    agent   10d   v1.21.9

kubectl get pods -o wide -A

NAMESPACE     NAME                                  READY   STATUS    RESTARTS   AGE     IP           NODE                                NOMINATED NODE   READINESS GATES
default       sampleapp2-74b4b974ff-676sz           1/1     Running   0          93m     10.244.1.6   aks-nodepool1-31721111-vmss000002   <none>           <none>
default       sampleapp2-76b6c4c59b-pfgbh           1/1     Running   0          94m     10.244.1.5   aks-nodepool1-31721111-vmss000002   <none>           <none>
kube-system   azure-ip-masq-agent-4n66k             1/1     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002   <none>           <none>
kube-system   azure-ip-masq-agent-9p4c8             1/1     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000   <none>           <none>
kube-system   azure-ip-masq-agent-nb7mx             1/1     Running   0          10d     10.240.0.5   aks-nodepool1-31721111-vmss000001   <none>           <none>
kube-system   coredns-845757d86-dtvvs               1/1     Running   0          10d     10.244.0.2   aks-nodepool1-31721111-vmss000000   <none>           <none>
kube-system   coredns-845757d86-x27pp               1/1     Running   0          10d     10.244.2.3   aks-nodepool1-31721111-vmss000001   <none>           <none>
kube-system   coredns-autoscaler-5f85dc856b-nfrmh   1/1     Running   0          10d     10.244.2.4   aks-nodepool1-31721111-vmss000001   <none>           <none>
kube-system   csi-azuredisk-node-9nfzt              3/3     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000   <none>           <none>
kube-system   csi-azuredisk-node-bblsb              3/3     Running   0          10d     10.240.0.5   aks-nodepool1-31721111-vmss000001   <none>           <none>
kube-system   csi-azuredisk-node-tjhj4              3/3     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002   <none>           <none>
kube-system   csi-azurefile-node-9pcr8              3/3     Running   0          3d10h   10.240.0.6   aks-nodepool1-31721111-vmss000002   <none>           <none>
kube-system   csi-azurefile-node-bh2pc              3/3     Running   0          3d10h   10.240.0.5   aks-nodepool1-31721111-vmss000001   <none>           <none>
kube-system   csi-azurefile-node-h75gq              3/3     Running   0          3d10h   10.240.0.4   aks-nodepool1-31721111-vmss000000   <none>           <none>
kube-system   konnectivity-agent-6cd55c69cf-ngdlb   1/1     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002   <none>           <none>
kube-system   konnectivity-agent-6cd55c69cf-rvvqt   1/1     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000   <none>           <none>
kube-system   kube-proxy-4wzx7                      1/1     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000   <none>           <none>
kube-system   kube-proxy-g5tvr                      1/1     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002   <none>           <none>
kube-system   kube-proxy-mrv54                      1/1     Running   0          10d     10.240.0.5   aks-nodepool1-31721111-vmss000001   <none>           <none>
kube-system   metrics-server-774f99dbf4-h52hn       1/1     Running   1          3d10h   10.244.1.3   aks-nodepool1-31721111-vmss000002   <none>           <none>

重设大小时，请务必考虑所有工作负荷要求（例如可用性区域）并相应地配置节点池。可能需要修改以下命令才能最好地满足你的需求。有关配置选项的完整列表，请参阅 az aks nodepool add 参考页。

使用 az aks nodepool add 命令，通过 Standard_DS3_v2 VM SKU 创建名为 mynodepool 的新节点池，该池包含三个节点：

az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name mynodepool \
    --node-count 3 \
    --node-vm-size Standard_DS3_v2 \
    --mode System \
    --no-wait

注意

每个 AKS 群集必须至少包含一个系统节点池，该池至少包含一个节点。在以上示例中，我们使用的 --mode 是 System，因为假定群集只有一个节点池，因此需要一个 System 节点池来替换它。节点池的模式可以随时更新。

几分钟后，已创建了新的节点池：

群集的 Azure 门户页的屏幕截图，其中已导航到“设置”>“节点池”。将显示两个节点池，分别名为“节点池 1”和“我的节点池”。

kubectl get nodes

NAME                                 STATUS   ROLES   AGE   VERSION
aks-mynodepool-20823458-vmss000000   Ready    agent   23m   v1.21.9
aks-mynodepool-20823458-vmss000001   Ready    agent   23m   v1.21.9
aks-mynodepool-20823458-vmss000002   Ready    agent   23m   v1.21.9
aks-nodepool1-31721111-vmss000000    Ready    agent   10d   v1.21.9
aks-nodepool1-31721111-vmss000001    Ready    agent   10d   v1.21.9
aks-nodepool1-31721111-vmss000002    Ready    agent   10d   v1.21.9

重设大小时，请务必考虑所有工作负荷要求（例如可用性区域）并相应地配置节点池。可能需要修改以下命令才能最好地满足你的需求。有关配置选项的完整列表，请参阅 New-AzAksNodePool 参考页。

使用 New-AzAksNodePool cmdlet，通过 Standard_DS3_v2 VM SKU 创建名为 mynodepool 的新节点池，该池包含三个节点：

$params = @{
    ResourceGroupName = 'myResourceGroup'
    ClusterName       = 'myAKSCluster'
    Name              = 'mynodepool'
    Count             = 3
    VMSize            = 'Standard_DS3_v2'
}
New-AzAksNodePool @params

几分钟后，已创建了新的节点池：

群集的 Azure 门户页的屏幕截图，其中已导航到“设置”>“节点池”。将显示两个节点池，分别名为“节点池 1”和“我的节点池”。

kubectl get nodes

NAME                                 STATUS   ROLES   AGE   VERSION
aks-mynodepool-20823458-vmss000000   Ready    agent   23m   v1.21.9
aks-mynodepool-20823458-vmss000001   Ready    agent   23m   v1.21.9
aks-mynodepool-20823458-vmss000002   Ready    agent   23m   v1.21.9
aks-nodepool1-31721111-vmss000000    Ready    agent   10d   v1.21.9
aks-nodepool1-31721111-vmss000001    Ready    agent   10d   v1.21.9
aks-nodepool1-31721111-vmss000002    Ready    agent   10d   v1.21.9

注意

每个 AKS 群集必须至少包含一个系统节点池，该池至少包含一个节点。在以下示例中，我们将节点池的模式更新为 System，因为假定群集只有一个节点池，因此需要一个 System 节点池来替换它。节点池的模式可以随时更新。

$myAKSCluster = Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster
($myAKSCluster.AgentPoolProfiles | Where-Object Name -eq 'mynodepool').Mode = 'System'
$myAKSCluster | Set-AzAksCluster

封锁现有节点

封锁将指定的节点标记为不可调度，并阻止将任何其他 Pod 添加到节点。

首先，获取要使用 kubectl get nodes 来封锁的节点的名称。输出应如下所示：

NAME                                STATUS   ROLES   AGE     VERSION
aks-nodepool1-31721111-vmss000000   Ready    agent   7d21h   v1.21.9
aks-nodepool1-31721111-vmss000001   Ready    agent   7d21h   v1.21.9
aks-nodepool1-31721111-vmss000002   Ready    agent   7d21h   v1.21.9

接下来，使用 kubectl cordon <node-names> 在以空格分隔的列表中指定所需的节点：

kubectl cordon aks-nodepool1-31721111-vmss000000 aks-nodepool1-31721111-vmss000001 aks-nodepool1-31721111-vmss000002

node/aks-nodepool1-31721111-vmss000000 cordoned
node/aks-nodepool1-31721111-vmss000001 cordoned
node/aks-nodepool1-31721111-vmss000002 cordoned

排出现有节点

重要

为了成功排出节点并收回正在运行的 Pod，请确保任何 PodDisruptionBudgets (PDB) 都允许一次至少移动一个 Pod 副本。否则，排出/收回操作将失败。若要对此进行检查，可以运行 kubectl get pdb -A 并验证 ALLOWED DISRUPTIONS 是否至少为 1 或更高。

排出节点将导致在这些节点上运行的 Pod 被收回并在其他可调度节点上重新创建。

要排出节点，请使用 kubectl drain <node-names> --ignore-daemonsets --delete-emptydir-data，同样使用以空格分隔的节点名称列表：

重要

需要使用 --delete-emptydir-data 才能收回 AKS 创建的 coredns 和 metrics-server Pod。如果未使用此标志，则会出现错误。有关详细信息，请参阅 emptydir 上的文档。

kubectl drain aks-nodepool1-31721111-vmss000000 aks-nodepool1-31721111-vmss000001 aks-nodepool1-31721111-vmss000002 --ignore-daemonsets --delete-emptydir-data

排出操作完成后，除守护程序集控制的 Pod 外的所有 Pod 都运行在新的节点池上：

kubectl get pods -o wide -A

NAMESPACE     NAME                                  READY   STATUS    RESTARTS   AGE     IP           NODE                                 NOMINATED NODE   READINESS GATES
default       sampleapp2-74b4b974ff-676sz           1/1     Running   0          15m     10.244.4.5   aks-mynodepool-20823458-vmss000002   <none>           <none>
default       sampleapp2-76b6c4c59b-rhmzq           1/1     Running   0          16m     10.244.4.3   aks-mynodepool-20823458-vmss000002   <none>           <none>
kube-system   azure-ip-masq-agent-4n66k             1/1     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002    <none>           <none>
kube-system   azure-ip-masq-agent-9p4c8             1/1     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000    <none>           <none>
kube-system   azure-ip-masq-agent-nb7mx             1/1     Running   0          10d     10.240.0.5   aks-nodepool1-31721111-vmss000001    <none>           <none>
kube-system   azure-ip-masq-agent-sxn96             1/1     Running   0          49m     10.240.0.9   aks-mynodepool-20823458-vmss000002   <none>           <none>
kube-system   azure-ip-masq-agent-tsq98             1/1     Running   0          49m     10.240.0.8   aks-mynodepool-20823458-vmss000001   <none>           <none>
kube-system   azure-ip-masq-agent-xzrdl             1/1     Running   0          49m     10.240.0.7   aks-mynodepool-20823458-vmss000000   <none>           <none>
kube-system   coredns-845757d86-d2pkc               1/1     Running   0          17m     10.244.3.2   aks-mynodepool-20823458-vmss000000   <none>           <none>
kube-system   coredns-845757d86-f8g9s               1/1     Running   0          17m     10.244.5.2   aks-mynodepool-20823458-vmss000001   <none>           <none>
kube-system   coredns-autoscaler-5f85dc856b-f8xh2   1/1     Running   0          17m     10.244.4.2   aks-mynodepool-20823458-vmss000002   <none>           <none>
kube-system   csi-azuredisk-node-7md2w              3/3     Running   0          49m     10.240.0.7   aks-mynodepool-20823458-vmss000000   <none>           <none>
kube-system   csi-azuredisk-node-9nfzt              3/3     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000    <none>           <none>
kube-system   csi-azuredisk-node-bblsb              3/3     Running   0          10d     10.240.0.5   aks-nodepool1-31721111-vmss000001    <none>           <none>
kube-system   csi-azuredisk-node-lcmtz              3/3     Running   0          49m     10.240.0.9   aks-mynodepool-20823458-vmss000002   <none>           <none>
kube-system   csi-azuredisk-node-mmncr              3/3     Running   0          49m     10.240.0.8   aks-mynodepool-20823458-vmss000001   <none>           <none>
kube-system   csi-azuredisk-node-tjhj4              3/3     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002    <none>           <none>
kube-system   csi-azurefile-node-29w6z              3/3     Running   0          49m     10.240.0.9   aks-mynodepool-20823458-vmss000002   <none>           <none>
kube-system   csi-azurefile-node-4nrx7              3/3     Running   0          49m     10.240.0.7   aks-mynodepool-20823458-vmss000000   <none>           <none>
kube-system   csi-azurefile-node-9pcr8              3/3     Running   0          3d11h   10.240.0.6   aks-nodepool1-31721111-vmss000002    <none>           <none>
kube-system   csi-azurefile-node-bh2pc              3/3     Running   0          3d11h   10.240.0.5   aks-nodepool1-31721111-vmss000001    <none>           <none>
kube-system   csi-azurefile-node-gqqnv              3/3     Running   0          49m     10.240.0.8   aks-mynodepool-20823458-vmss000001   <none>           <none>
kube-system   csi-azurefile-node-h75gq              3/3     Running   0          3d11h   10.240.0.4   aks-nodepool1-31721111-vmss000000    <none>           <none>
kube-system   konnectivity-agent-6cd55c69cf-2bbp5   1/1     Running   0          17m     10.240.0.7   aks-mynodepool-20823458-vmss000000   <none>           <none>
kube-system   konnectivity-agent-6cd55c69cf-7xzxj   1/1     Running   0          16m     10.240.0.8   aks-mynodepool-20823458-vmss000001   <none>           <none>
kube-system   kube-proxy-4wzx7                      1/1     Running   0          10d     10.240.0.4   aks-nodepool1-31721111-vmss000000    <none>           <none>
kube-system   kube-proxy-7h8r5                      1/1     Running   0          49m     10.240.0.7   aks-mynodepool-20823458-vmss000000   <none>           <none>
kube-system   kube-proxy-g5tvr                      1/1     Running   0          10d     10.240.0.6   aks-nodepool1-31721111-vmss000002    <none>           <none>
kube-system   kube-proxy-mrv54                      1/1     Running   0          10d     10.240.0.5   aks-nodepool1-31721111-vmss000001    <none>           <none>
kube-system   kube-proxy-nqmnj                      1/1     Running   0          49m     10.240.0.9   aks-mynodepool-20823458-vmss000002   <none>           <none>
kube-system   kube-proxy-zn77s                      1/1     Running   0          49m     10.240.0.8   aks-mynodepool-20823458-vmss000001   <none>           <none>
kube-system   metrics-server-774f99dbf4-2x6x8       1/1     Running   0          16m     10.244.4.4   aks-mynodepool-20823458-vmss000002   <none>           <none>

疑难解答

可能会看到以下错误：

收回 pods/[podname] -n [namespace] 时出错（将在 5 秒后重试）：无法收回 Pod，因为它违反了 Pod 的中断预算。

默认情况下，你的群集具有 AKS_managed Pod 中断预算（例如 coredns-pdb 或 konnectivity-agent），MinAvailable 为 1。例如，如果有两个 coredns Pod 正在运行，而其中一个正在重新创建并且不可用，则另一个由于 Pod 中断预算而无法受到影响。这将在调度并运行初始 coredns Pod 后自行解决，从而允许正确收回并重新创建第二个 Pod。

提示

考虑逐个排出节点，以获得更流畅的收回体验并避免限制。有关详细信息，请参阅：

删除现有节点池

Azure CLI
Azure PowerShell

若要删除现有节点池，请使用 Azure 门户或 az aks nodepool delete 命令：

az aks nodepool delete \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name nodepool1

若要删除现有节点池，请使用 Azure 门户或 Remove-AzAksNodePool cmdlet：

重要

删除节点池时，AKS 不会执行隔离和排出。若要最大程度地减少对重新计划 Pod（当前正在要删除的节点池上运行）的中断，请在删除之前对节点池中的所有节点执行隔离和排出。

$params = @{
    ResourceGroupName = 'myResourceGroup'
    ClusterName       = 'myAKSCluster'
    Name              = 'nodepool1'
    Force             = $true
}
Remove-AzAksNodePool @params

完成后，最终结果是 AKS 群集具有单个新节点池，该池具有所需的新 SKU 大小，并且所有应用程序和 Pod 都正常运行：

群集的 Azure 门户页的屏幕截图，其中已导航到“设置”>“节点池”。将显示一个名为“我的节点池”的节点池。

kubectl get nodes

NAME                                 STATUS   ROLES   AGE   VERSION
aks-mynodepool-20823458-vmss000000   Ready    agent   63m   v1.21.9
aks-mynodepool-20823458-vmss000001   Ready    agent   63m   v1.21.9
aks-mynodepool-20823458-vmss000002   Ready    agent   63m   v1.21.9

后续步骤

通过封锁和排出来重设节点池大小后，详细了解如何使用多个节点池。

Compartir a través de