Ändra storleken på nodpooler i Azure Kubernetes Service (AKS)

Artikel
12/18/2024

Om du har ett ökande antal distributioner eller om du vill köra en större arbetsbelastning kan du ändra planen för VM-skalningsuppsättningen eller storleken på AKS-instanserna. Enligt supportprinciper för AKS:

AKS-agentnoder visas i Azure Portal som vanliga Azure IaaS-resurser. Men dessa virtuella datorer distribueras till en anpassad Azure-resursgrupp (vanligtvis prefix med MC_*). Du kan inte göra några direkta anpassningar till dessa noder med hjälp av IaaS-API:er eller resurser. Eventuella anpassade ändringar som inte görs via AKS-API:et bevaras inte genom en uppgradering, skalning, uppdatering eller omstart.

Den här bristen på beständighet gäller även för storleksändringsåtgärden. Därför stöds inte storleksändring av AKS-instanser på det här sättet. I den här guiden får du lära dig den rekommenderade metoden för att hantera det här scenariot.

Viktigt!

Den här metoden är specifik för VM-skalningsuppsättningsbaserade AKS-kluster. När du använder tillgänglighetsuppsättningar för virtuella datorer är du begränsad till endast en nodpool per kluster.

Exempelresurser

Anta att du vill ändra storlek på en befintlig nodpool med namnet nodepool1, från SKU-storlek Standard_DS2_v2 till Standard_DS3_v2. För att utföra den här uppgiften måste du skapa en ny nodpool med hjälp av Standard_DS3_v2, flytta arbetsbelastningar från nodepool1 till den nya nodpoolen och ta bort nodepool1. I det här exemplet anropar vi den nya nodpoolen mynodepool.

Skärmbild av sidan Azure Portal för klustret och navigerat till Inställningar > Nodpooler. En nodpool med namnet nodpool 1 visas.

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>

När du ändrar storlek bör du överväga alla arbetsbelastningskrav, till exempel tillgänglighetszoner, och konfigurera nodpoolen i enlighet med detta. Du kan behöva ändra följande kommando så att det passar dina behov. En fullständig lista över konfigurationsalternativen finns på az aks nodepool add referenssidan.

az aks nodepool add Använd kommandot för att skapa en ny nodpool med namnet mynodepool med tre noder med hjälp av vm-SKUStandard_DS3_v2:n:

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

Kommentar

Varje AKS-kluster måste innehålla minst en systemnodpool med minst en nod. I exemplet ovan använder vi en --mode av System, eftersom klustret antas ha endast en nodpool, vilket kräver att en System nodpool ersätter den. Nodpoolens läge kan uppdateras när som helst.

Efter några minuter har den nya nodpoolen skapats:

Skärmbild av sidan Azure Portal för klustret och navigerat till Inställningar > Nodpooler. Två nodpooler med namnet nodpool 1 och min nodpool visas.

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

Använd cmdleten New-AzAksNodePool för att skapa en ny nodpool med namnet mynodepool med tre noder med hjälp av VM Standard_DS3_v2 SKU:

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

Efter några minuter har den nya nodpoolen skapats:

Skärmbild av sidan Azure Portal för klustret och navigerat till Inställningar > Nodpooler. Två nodpooler med namnet nodpool 1 och min nodpool visas.

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

Kommentar

Varje AKS-kluster måste innehålla minst en systemnodpool med minst en nod. I exemplet nedan uppdaterar vi nodpoolens läge till System, eftersom klustret antas ha endast en nodpool, vilket kräver att en System nodpool ersätter den. Nodpoolens läge kan uppdateras när som helst.

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

Spärra de befintliga noderna

Avspärrning markerar angivna noder som oplanerade och förhindrar att fler poddar läggs till i noderna.

Hämta först namnen på de noder som du vill spärra med kubectl get nodes. Dina utdata bör se ut ungefär så här:

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

Ange sedan önskade noder i en blankstegsavgränsad lista med hjälp av 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

Töm de befintliga noderna

Viktigt!

Om du vill tömma noder och avlägsna poddar som körs kontrollerar du att alla PodDisruptionBudgets (PDB) tillåter att minst en poddreplik flyttas i taget. Annars misslyckas avlopps-/vräkningsåtgärden. Om du vill kontrollera detta kan du köra kubectl get pdb -A och kontrollera att ALLOWED DISRUPTIONS det är minst en eller flera.

Tömning av noder gör att poddar som körs på dem avlägsnas och återskapas på de andra, schemaläggningsbara noderna.

Om du vill tömma noder använder du kubectl drain <node-names> --ignore-daemonsets --delete-emptydir-dataigen med en blankstegsavgränsad lista med nodnamn:

Viktigt!

Användning --delete-emptydir-data krävs för att avlägsna AKS-skapade coredns och metrics-server poddar. Om den här flaggan inte används förväntas ett fel. Mer information finns i dokumentationen om emptydir.

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

När avloppsåtgärden är klar körs alla andra poddar än de som styrs av daemonuppsättningar i den nya nodpoolen:

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>

Felsökning

Du kan se ett fel som liknar följande:

Fel vid borttagning av poddar/[podname] -n [namnområde] (försök igen efter 5:er): Det går inte att ta bort podden eftersom det skulle bryta mot poddens avbrottsbudget.

Som standard har klustret AKS_managed poddavbrottsbudgetar (till exempel coredns-pdb eller konnectivity-agent) med en MinAvailable på 1. Om det till exempel finns två coredns poddar som körs, medan en av dem återskapas och inte är tillgänglig, kan den andra inte påverkas på grund av poddens avbrottsbudget. Detta löser sig när den första coredns podden har schemalagts och körts, vilket gör att den andra podden kan avlägsnas och återskapas korrekt.

Dricks

Överväg att tömma noder en i taget för en smidigare borttagningsupplevelse och för att undvika begränsning. Mer information finns i:

Ta bort den befintliga nodpoolen

Azure CLI
Azure PowerShell

Om du vill ta bort den befintliga nodpoolen använder du Azure Portal eller az aks nodepool delete kommandot:

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

Om du vill ta bort den befintliga nodpoolen använder du Azure Portal eller cmdletenRemove-AzAksNodePool:

Viktigt!

När du tar bort en nodpool utför AKS inte avspärrning och tömning. Utför en avspärrning och tömning på alla noder i nodpoolen innan du tar bort för att minimera störningarna i de omplanerade poddar som för närvarande körs på den nodpool som du ska ta bort.

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

Efter slutförandet är det slutliga resultatet att AKS-klustret har en enda, ny nodpool med den nya, önskade SKU-storleken och alla program och poddar som körs korrekt:

Skärmbild av sidan Azure Portal för klustret och navigerat till Inställningar > Nodpooler. En nodpool med namnet min nodpool visas.

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

Nästa steg

När du har storleksanpassat en nodpool genom avspärrning och tömning kan du läsa mer om hur du använder flera nodpooler.

Dela via

Ändra storleken på nodpooler i Azure Kubernetes Service (AKS)

Exempelresurser

Skapa en ny nodpool med önskad SKU

Spärra de befintliga noderna

Töm de befintliga noderna

Felsökning

Ta bort den befintliga nodpoolen

Nästa steg

Ytterligare resurser