Aracılığıyla paylaş

Azure Kubernetes Service (AKS) kümesini yükseltme

  • Makale

Şunlar için geçerlidir: Azure Stack HCI, sürüm 23H2

Uygulama ve küme yaşam döngüsünü yönetmenin bir parçası olarak Kubernetes'in en son kullanılabilir sürümüne yükseltmek isteyebilirsiniz. Yükseltme, Kubernetes'in daha yeni bir sürümüne geçmeyi, işletim sistemi (OS) sürüm güncelleştirmelerini (düzeltme eki uygulama) veya her ikisini de içerir. AKS Arc, bir iş yükü kümesindeki düğümleri en son işletim sistemi ve çalışma zamanı güncelleştirmeleriyle yükseltmeyi (veya düzeltme eki uygulama) destekler.

Tüm yükseltmeler, iş yüklerinin kesintisiz kullanılabilirliğini sağlamak için sürekli ve sıralı bir şekilde yürütülür. Kümeye daha yeni bir derlemeye sahip yeni bir Kubernetes çalışan düğümü getirildiğinde, kaynaklar eski düğümden yeni düğüme taşınır. Bu başarıyla tamamlandıktan sonra eski düğüm kullanımdan kaldırılır ve kümeden kaldırılır.

Başlamadan önce

Azure CLI kullanıyorsanız bu makale için Azure CLI 2.34.1 veya sonraki bir sürümü gerekir. Sürümü bulmak için az --version komutunu çalıştırın. CLI'yı yüklemeniz veya yükseltmeniz gerekiyorsa bkz. Azure CLI'yı yükleme.

Kullanılabilir yükseltmeleri denetleme

Aşağıdaki komutu kullanarak kümeniz için hangi Kubernetes sürümlerinin kullanılabilir olduğunu denetleyin:

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

Aşağıdaki örnek çıktıda geçerli sürüm 1.24.11 olarak gösterilir ve altında upgradeskullanılabilir sürümler listelenir:

{  
  "agentPoolProfiles": [  
    {  
      "kubernetesVersion": "1.24.11",  
      "upgrades": [  
        {  
          "kubernetesVersion": "1.25.7"  
        }  
      ]  
    }  
  ],  
  "controlPlaneProfile": {  
    "kubernetesVersion": "1.24.11",  
    "name": "aksarc-testupgrade",  
    "osType": "Linux",  
    "upgrades": [  
      {  
        "kubernetesVersion": "1.25.7"  
      }  
    ]  
  },  
  ...  
  "provisioningState": "Succeeded",  
  ...  
}

Kubernetes sürümünü yükseltme

Desteklenen bir AKS kümesini yükseltirken Kubernetes ikincil sürümlerini atlayamazsınız. Tüm yükseltmeleri ana sürüm numarasına göre sıralı olarak gerçekleştirmeniz gerekir. Örneğin, 1.24.x'ten1.25.x veya 1.25.x'ten1.26.x'e yükseltmeye izin verilir. 1.24.x ile 1.26.x'e izin verilmez.

Not

Herhangi bir düzeltme eki belirtilmezse, küme otomatik olarak belirtilen ikincil sürümün en son GA düzeltme ekine yükseltilir. Örneğin, 1.25 olarak ayarlanması--kubernetes-version, kümenin 1.25.7'ye yükseltilmesine neden olur.

Aşağıdaki komutu kullanarak kümenizi yükseltebilirsiniz:

az aksarc upgrade \
  --resource-group myResourceGroup \
  --name myAKSCluster \
  --kubernetes-version <KUBERNETES_VERSION>

Komutunu kullanarak yükseltmenin show başarılı olduğunu onaylayın:

az aksarc show --resource-group myResourceGroup --name myAKSCluster

Aşağıdaki örnek çıktı, kümenin artık 1.25.7 çalıştırdığını gösterir:

{  
"extendedLocation": {  
  "name":
"/subscriptions/<subscription>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom
location>",  
  "type": "CustomLocation"  
},  
"id": "/subscriptions/<subscription>/resourceGroups/<resource group>/providers/Microsoft.Kubernetes/connectedClusters/aksarc-testupgrade/providers/Microsoft.HybridContainerService/provisionedClusterInstances/default",  
"name": "default",  
"properties": {  
  "agentPoolProfiles": [  
    {  
    }  
  ],  
  "controlPlane": {  
    "availabilityZones": null,  
    "controlPlaneEndpoint": {  
      "hostIp": null,  
      "port": null  
    },  
    "count": 1,  
    "linuxProfile": {  
      "ssh": {  
        "publicKeys": null  
      }  
    },  
    "name": null,  
    "nodeImageVersion": null,  
    "osSku": "CBLMariner",  
    "osType": "Linux",  
    "vmSize": "Standard_A4_v2"  
  },  
  "kubernetesVersion": "1.25.7",  
...  
  "provisioningState": "Succeeded",  
  ...  
},  
....  
"type": "microsoft.hybridcontainerservice/provisionedclusterinstances"  
}

Önemli

İki veya daha fazla ikincil sürümü atlayan desteklenmeyen bir sürümden yükseltme gerçekleştirdiğinizde, yükseltme düzgün işlevselliği garanti edemez. Sürümünüz önemli ölçüde güncel değilse, bunun yerine kümenizi yeniden oluşturmanızı öneririz.

Yükseltme işlemi sırasında, hem hem de provisioningStatecurrentState göstergeler devam eden işlemi yansıtacak şekilde bir Yükseltme iletisi görüntüler. Ancak, işlem zaman aşımına uğradıysa BaşarısızprovisioningState gösterilirkencurrentState, yükseltme arka planda devam ettikçe Yükseltme gösterilmeye devam eder. Eylem gerekmez; yükseltme işlemi tamamlanana kadar devam eder.

İşletim Sistemi (OS) sürümünü güncelleştirme

Çalışan düğümlerini Kubernetes sürümünü değiştirmeden düğüm görüntüsünün daha yeni bir sürümüne güncelleştirmek, yalnızca yeni görüntünün farklı bir Kubernetes sürümü gerektirmemesi durumunda çalışır. Şu anda AKS Arc, desteklenen tüm Kubernetes sürümlerinde yalnızca düğüm görüntüsü güncelleştirmelerini desteklememektedir. Düğüm görüntüsünü güncelleştirmeniz gerekiyorsa, tüm düğüm görüntüsü güncelleştirmelerinin birleştirildiğinden emin olmak için kümeyi en son Kubernetes sürümüne yükseltmeniz gerekir.

Önemli

bayrağını node-image-only kullanmaya çalışırken, bu özelliğin henüz desteklenmediğini belirten bir ileti alırsınız.

Sonraki adımlar