Öğretici: Azure Kubernetes Hizmeti’nde (AKS) Kubernetes’i yükseltme

Bu öğretici için Azure CLI 2.0.53 veya sonraki bir sürümünü çalıştırmanız gerekir. Sürümü bulmak için az --version komutunu çalıştırın. Yüklemeniz veya yükseltmeniz gerekirse, bkz. Azure CLI yükleme.

Bu öğretici için 5.9.0 Azure PowerShell sürümünü çalıştırmayı gerektirir. Sürümü bulmak için Get-InstalledModule -Name Az komutunu çalıştırın. Yüklemeniz veya yükseltmeniz gerekirse bkz. Azure PowerShell yükleme.

Bir kümeyi yükseltmeden önce, az aks get-upgrades komutunu kullanarak hangi Kubernetes sürümlerinin yükseltme için kullanılabilir olduğunu öğrenin:

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

Aşağıdaki örnekte, geçerli sürüm 1.18.10'dür ve kullanılabilir sürümler yükseltmeleri altında gösterilir.

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

Bir kümeyi yükseltmeden önce, hangi Kubernetes sürümünü ve hangi bölgede yerdiğini belirlemek için Get-AzAksCluster cmdlet'ini kullanın:

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

Aşağıdaki örnekte geçerli sürüm 1.19.9'dür:

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

AKS kümenizin bulunduğu bölgede hangi Kubernetes yükseltme yayınlarını kullanabileceğinizi belirlemek için Get-AzAksVersion cmdlet'ini kullanın:

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

Kullanılabilir sürümler OrchestratorVersion altında gösterilir.

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

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

AKS kümesini yükseltmek için az aks upgrade komutunu kullanın.

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

Aşağıdaki yoğun örnek çıktı, 1.19.1 sürümüne yükseltmenin sonucu gösterir. kubernetesVersion'un artık 1.19.1 raporuna sahip olduğunu fark edin:

{
  "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"
}

AKS kümesi yükseltmek için Set-AzAksCluster cmdlet'ini kullanın.

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

Aşağıdaki yoğun örnek çıktı, 1.19.9 sürümüne yükseltmenin sonucu gösterir. kubernetesVersion'ın artık 1.20.2 raporuna sahip olduğunu fark edin:

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

az aks show komutunu aşağıdaki şekilde kullanarak yükseltmenin başarılı olup olmadığını doğrulayabilirsiniz:

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

Aşağıdaki örnek çıktı, AKS kümesinde KubernetesVersion 1.19.1 çalıştırmasını gösterir:

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

Get-AzAksCluster cmdlet'ini kullanarak yükseltmenin başarılı olduğunu onaylayın:

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

Aşağıdaki örnek çıktı, AKS kümesinde KubernetesVersion 1.20.2 çalıştırmasını gösterir:

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

Bu öğretici serinin son bölümü olduğu için AKS kümesi silmek istiyor olabilir. Kubernetes düğümleri Azure sanal makinelerinde (VM) çalıştığından kümeyi kullanmasanız dahi ücret tahsil edilmeye devam eder. az group delete komutunu kullanarak kaynak grubunu, kapsayıcı hizmetini ve ilgili tüm kaynakları kaldırabilirsiniz.

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

Bu öğretici serinin son bölümü olduğu için AKS kümesi silmek istiyor olabilir. Kubernetes düğümleri Azure sanal makinelerinde (VM) çalıştığından kümeyi kullanmasanız dahi ücret tahsil edilmeye devam eder. Remove-AzResourceGroup cmdlet'ini kullanarak kaynak grubunu, kapsayıcı hizmetini ve tüm ilgili kaynakları kaldırın.

Remove-AzResourceGroup -Name myResourceGroup