Kurz: Upgrade Kubernetes ve službě Azure Kubernetes Service (AKS)

Tento kurz vyžaduje použití Azure CLI verze 2.0.53 nebo novější. Verzi zjistíte spuštěním příkazu az --version. Pokud potřebujete instalaci nebo upgrade, přečtěte si téma Instalace Azure CLI.

Tento kurz vyžaduje použití verze Azure PowerShell 5.9.0 nebo novější. Verzi zjistíte spuštěním příkazu Get-InstalledModule -Name Az. Pokud potřebujete provést instalaci nebo upgrade, přečtěte si téma Instalace Azure PowerShellu.

Před upgradem clusteru pomocí příkazu az aks get-upgrades zkontrolujte, které vydané verze Kubernetes jsou pro upgrade k dispozici:

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

V následujícím příkladu je aktuální verze 1.18.10 a dostupné verze se zobrazují v části upgrady.

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

Před upgradem clusteru pomocí rutiny Get-AzAksCluster zjistěte, jakou verzi Kubernetes používáte a v jaké oblasti se nachází:

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

V následujícím příkladu je aktuální verze 1.19.9:

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

Pomocí rutiny Get-AzAksVersion určete, které verze upgradu Kubernetes jsou dostupné v oblasti, ve které se nachází váš cluster AKS:

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

Dostupné verze se zobrazují v části 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            : {}

Cluster AKS můžete upgradovat pomocí příkazu az aks upgrade.

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

Následující zkrácený příklad výstupu ukazuje výsledek upgradu na verzi 1.19.1. Všimněte si, že kubernetesVersion teď hlásí 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"
}

K upgradu clusteru AKS použijte rutinu Set-AzAksCluster.

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

Následující zkrácený příklad výstupu ukazuje výsledek upgradu na verzi 1.19.9. Všimněte si, že kubernetesVersion teď hlásí 1.20.2:

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

Následujícím způsobem ověřte úspěšné provedení upgradu pomocí příkazu az aks show:

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

Následující příklad výstupu ukazuje, že cluster AKS používá 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

Pomocí rutiny Get-AzAksCluster následujícím způsobem ověřte, že upgrade byl úspěšný:

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

Následující příklad výstupu ukazuje, že cluster AKS používá KubernetesVersion 1.20.2:

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

Vzhledem k tomu, že tento kurz je poslední částí série, možná budete chtít odstranit cluster AKS. Jelikož uzly prostředí Kubernetes běží na virtuálních počítačích v Azure, účtují se za ně poplatky, i když cluster nevyužíváte. Pomocí příkazu az group delete odeberete skupinu prostředků, službu kontejneru a všechny související prostředky.

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

Vzhledem k tomu, že tento kurz je poslední částí série, možná budete chtít odstranit cluster AKS. Jelikož uzly prostředí Kubernetes běží na virtuálních počítačích v Azure, účtují se za ně poplatky, i když cluster nevyužíváte. Pomocí rutiny Remove-AzResourceGroup odeberte skupinu prostředků, službu kontejneru a všechny související prostředky.

Remove-AzResourceGroup -Name myResourceGroup