Självstudie: Uppgradera Kubernetes i Azure Kubernetes Service (AKS)

I den här självstudien måste du köra Azure CLI version 2.0.53 eller senare. Kör az --version för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

Den här självstudien kräver att du kör Azure PowerShell version 5.9.0 eller senare. Kör Get-InstalledModule -Name Az för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Install Azure PowerShell (Installera Azure PowerShell).

Innan du uppgraderar ett kluster använder du kommandot az aks get-upgrades för att kontrollera vilka Kubernetes-versioner som är tillgängliga för uppgradering:

az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster

I följande exempel är den aktuella versionen 1.18.10 och de tillgängliga versionerna visas under uppgraderingar.

{
  "agentPoolProfiles": null,
  "controlPlaneProfile": {
    "kubernetesVersion": "1.18.10",
    ...
    "upgrades": [
      {
        "isPreview": null,
        "kubernetesVersion": "1.19.1"
      },
      {
        "isPreview": null,
        "kubernetesVersion": "1.19.3"
      }
    ]
  },
  ...
}

Innan du uppgraderar ett kluster använder du cmdleten Get-AzAksCluster för att avgöra vilken Kubernetes-version du kör och vilken region det finns i:

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, KubernetesVersion, Location

I följande exempel är den aktuella versionen 1.19.9:

Name         KubernetesVersion Location
----         ----------------- --------
myAKSCluster 1.19.9            eastus

Använd cmdleten Get-AzAksVersion för att avgöra vilka Kubernetes-uppgraderingsversioner som är tillgängliga i den region där ditt AKS-kluster finns:

Get-AzAksVersion -Location eastus | Where-Object OrchestratorVersion -gt 1.19.9

De tillgängliga versionerna visas under OrchestratorVersion.

OrchestratorType    : Kubernetes
OrchestratorVersion : 1.20.2
DefaultProperty     :
IsPreview           :
Upgrades            : {Microsoft.Azure.Commands.Aks.Models.PSOrchestratorProfile}

OrchestratorType    : Kubernetes
OrchestratorVersion : 1.20.5
DefaultProperty     :
IsPreview           :
Upgrades            : {}

Använd kommandot az aks upgrade för att uppgradera AKS-klustret.

az aks upgrade \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --kubernetes-version KUBERNETES_VERSION

Följande komprimerade exempelutdata visar resultatet av uppgraderingen till 1.19.1. Observera att kubernetesVersion nu rapporterar 1.19.1:

{
  "agentPoolProfiles": [
    {
      "count": 3,
      "maxPods": 110,
      "name": "nodepool1",
      "osType": "Linux",
      "storageProfile": "ManagedDisks",
      "vmSize": "Standard_DS1_v2",
    }
  ],
  "dnsPrefix": "myAKSClust-myResourceGroup-19da35",
  "enableRbac": false,
  "fqdn": "myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.19.1",
  "location": "eastus",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
}

Använd cmdleten Set-AzAksCluster för att uppgradera AKS-klustret.

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion <KUBERNETES_VERSION>

Följande komprimerade exempelutdata visar resultatet av uppgraderingen till 1.19.9. Observera att kubernetesVersion nu rapporterar 1.20.2:

ProvisioningState       : Succeeded
MaxAgentPools           : 100
KubernetesVersion       : 1.20.2
PrivateFQDN             :
AgentPoolProfiles       : {default}
Name                    : myAKSCluster
Type                    : Microsoft.ContainerService/ManagedClusters
Location                : eastus
Tags                    : {}

Bekräfta att uppgraderingen lyckades genom att köra kommandot az aks show på följande sätt:

az aks show --resource-group myResourceGroup --name myAKSCluster --output table

Följande exempelutdata visar att AKS-klustret kör KubernetesVersion 1.19.1:

Name          Location    ResourceGroup    KubernetesVersion    ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  -------------------  ----------------------------------------------------------------
myAKSCluster  eastus      myResourceGroup  1.19.1               Succeeded            myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io

Bekräfta att uppgraderingen lyckades med hjälp av cmdleten Get-AzAksCluster enligt följande:

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, Location, KubernetesVersion, ProvisioningState

Följande exempelutdata visar att AKS-klustret kör KubernetesVersion 1.20.2:

Name         Location KubernetesVersion ProvisioningState
----         -------- ----------------- -----------------
myAKSCluster eastus   1.20.2            Succeeded

Eftersom den här självstudien är den sista delen i serien kan du ta bort AKS-klustret. Då Kubernetes-noderna körs på virtuella Azure-datorer fortsätter de att debiteras även om du inte använder klustret. Använd kommandot az group delete för att ta bort resursgruppen, containertjänsten och alla relaterade resurser.

az group delete --name myResourceGroup --yes --no-wait

Eftersom den här självstudien är den sista delen i serien kan du ta bort AKS-klustret. Då Kubernetes-noderna körs på virtuella Azure-datorer fortsätter de att debiteras även om du inte använder klustret. Använd cmdleten Remove-AzResourceGroup för att ta bort resursgruppen, containertjänsten och alla relaterade resurser.

Remove-AzResourceGroup -Name myResourceGroup