AKS'de işletim sistemi (OS) sürümlerini yükseltme

Bu makalede, Azure Kubernetes Service (AKS) düğümler için kullanılabilen işletim sistemi sürümleri ve işletim sistemi sürümünüzü test edip yükseltmeye yönelik en iyi yöntemler açıklanmaktadır.

Önemli

10 Aralık 2026 itibarıyla Azure Kubernetes Service (AKS), AKS için OS Guard özellikli Azure Linux'u (önizleme) artık desteklemez. Bu noktada AKS artık OS Guard düğüm görüntüleriyle yeni Azure Linux üretmez veya güvenlik düzeltme ekleri sağlamaz ve artık OS Guard ile Azure Linux ile yeni düğüm havuzları oluşturamıyabilirsiniz. 10 Mart 2027'de AKS, OS Guard düğüm görüntüleriyle tüm mevcut Azure Linux'u kaldırır ve bu da ölçeklendirme ve düzeltme (yeniden oluşturma ve yeniden dağıtma) işlemlerinin başarısız olmasına neden olur. Kesintiyi önlemek için Azure Container Linux'a (ACL) geçin. Bu kullanımdan kaldırılma hakkında daha fazla bilgi için kullanımdan kaldırılma GitHub sorununa ve Azure Güncelleştirmeleri kullanımdan kaldırılma duyurusuna bakın. Duyurular ve güncelleştirmeler hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Önemli

March 17, 2027 tarihinden itibaren Azure Kubernetes Service (AKS) artık Ubuntu 20.04 için güvenlik güncelleştirmelerini desteklemez veya sağlamaz. Mevcut düğüm görüntüleri silinir ve Ubuntu 20.04 çalıştıran düğüm havuzlarını ölçeklendiremezsiniz. Düğüm havuzlarınızı Kubernetes sürüm 1.35+ sürümüne yükselterek desteklenen bir Ubuntu sürümüne geçin. Bu sonlandırma hakkında daha fazla bilgi için bkz. Kullanımdan Kaldırma GitHub sorunu ve Azure Güncelleştirmeleri sonlandırma duyurusu. Duyurular ve güncelleştirmeler hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Önemli

June 30, 2027 tarihinden itibaren Azure Kubernetes Service (AKS) artık Ubuntu 22.04 için güvenlik güncelleştirmelerini desteklemez veya sağlamaz. Kesintileri önlemek için bu tarihe kadar Ubuntu 24.04 veya sonraki bir sürüme geçin . Şimdi ve 30 Haziran 2027 tarihleri arasında AKS'de Ubuntu 22.04'ü kesinti olmadan kullanmaya devam edebilirsiniz. 30 Haziran 2027'ye kadar geçiş yapmazsanız yeni düğüm havuzları oluşturamazsınız, AKS yeni düğüm görüntüleri oluşturmaz ve mevcut düğüm havuzları için artık güvenlik düzeltme ekleri almazsınız. Kubernetes sürüm 1.33 veya üzeri ile uzun süreli desteği (LTS) etkinleştirmek istiyorsanız, önce düğüm havuzlarınızı Ubuntu 24.04'e güncelleştirin. 30 Nisan 2028'de AKS, Ubuntu 22.04 düğüm görüntülerini ve mevcut kodu kaldıracak ve ölçeklendirme ve düzeltme işlemlerinin başarısız olmasına neden olacak. Güvenlik açıkları, başarısız düğüm görüntüsü yükseltmeleri ve ölçeklendirme hataları gibi hizmet kesintilerini önlemek için 30 Haziran 2027'ye kadar Ubuntu 24.04 veya sonraki bir sürüme geçin . Geçiş seçenekleriniz şunlardır:

  • Varsayılan İşletim Sistemi SKU'su (OSSku): kullanıyorsanız UbuntuKubernetes sürümünüzü 1.35 veya sonraki bir sürüme yükselttiğinizde otomatik olarak Ubuntu 24.04'e geçiş yaparsınız.
  • Sürümlü OSSku: kullanıyorsanız Ubuntu2204, Kubernetes 1.35 veya üzeri için OSSku'nuzu Ubuntu olarak ya da Kubernetes 1.32 veya üzeri için Ubuntu2404 olarak güncelleyin.

Bu kullanımdan kaldırma hakkında daha fazla bilgi için, bakınız Kullanımdan kaldırma GitHub sorunu ve Azure Güncelleştirmeleri gönderisi. Duyurular ve güncelleştirmeler hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Önemli

November 30, 2025 tarihinden itibaren Azure Kubernetes Service (AKS) artık Azure Linux 2.0 için güvenlik güncelleştirmelerini desteklemez veya sağlamaz. Azure Linux 2.0 düğüm görüntüsü, 202512.06.0 sürümünde dondurulmuştur. 31 Ekim 2026'dan itibaren düğüm görüntüleri kaldırılacak ve düğüm havuzlarınızı ölçeklendiremeyeceksiniz. düğüm havuzlarınızı desteklenen bir Kubernetes sürümüne yükselterek veya osSku AzureLinux3 ile desteklenen bir Azure Linux sürümüne geçin. Daha fazla bilgi için Emeklilik GitHub sorunu ve Azure Güncelleştirmeleri kullanımdan kaldırma duyurusu'na bakınız. Duyurular ve güncelleştirmeler hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Desteklenen işletim sistemi sürümleri

Her düğüm görüntüsü , işletim sistemi SKU'su kullanarak belirtebileceğiniz bir işletim sistemi sürümüne karşılık gelir. Kümeler ve düğüm havuzları oluştururken aşağıdaki parametreleri belirtebilirsiniz:

  • --os-type: Linux veya Windows dahil olmak üzere işletim sistemi türü. Küme düzeyinde oluşturma veya güncelleştirme sırasında Windows işletim sistemi türünü belirtemezsiniz.
  • --os-sku: İşletim sistemi sürümünü veya işletim sistemi değişkenlerini belirtmek için kullanılır. Küme düzeyinde oluşturma veya güncelleştirme sırasında Windows işletim sistemi SKU'su belirtemezsiniz. Windows düğüm havuzları için düğüm havuzu eklerken işletim sistemi SKU'su belirtin. Desteklenen işletim sistemi SKU seçenekleri hakkında daha fazla bilgi için bkz. AKS CLI veya API Azure.
  • --kubernetes-version: Düğüm havuzu veya küme oluşturmak için kullanılacak Kubernetes sürümü.

En iyi yöntem kılavuzu

Varsayılan işletim sistemi sürümü en son doğrulanmış sürümdür.

  • Ubuntu için --os-type Linux ve --os-sku Ubuntu belirterek kümeler ve düğüm havuzları oluşturmanızı öneririz. Bu, Kubernetes sürümünüz temelinde sizi otomatik olarak en son varsayılan Ubuntu sürümüne güncelleştirir.
  • Azure Linux için --os-type Linux ve --os-sku AzureLinux belirtirken kümeler ve düğüm havuzları oluşturmanızı öneririz. Bu, Kubernetes sürümünüz temelinde sizi otomatik olarak en son varsayılan Azure Linux sürümüne güncelleştirir.
  • Azure Container Linux (ACL) için --os-type Linux ve --os-sku AzureContainerLinux belirtirken kümeler ve düğüm havuzları oluşturmanızı öneririz. Bu, Kubernetes sürümünüz temelinde sizi otomatik olarak en son varsayılan ACL sürümüne güncelleştirir.
  • Windows için, --os-type Windows, --os-sku Windows2025 ve --enable-fips-image belirterek düğüm havuzları oluşturun (Windows Server 2025, FIPS etkin bir imaj gerektirir). Yayınlandığında düğüm havuzlarını bir sonraki işletim sistemi sürümüne el ile güncelleştirmeniz gerekir.
İşletim sistemi türü İşletim Sistemi SKU'su Desteklenen Kubernetes sürümleri Varsayılan sürüm oluşturma
Linux Ubuntu Bu işletim sistemi SKU'su tüm Kubernetes sürümlerinde desteklenir. Bu işletim sistemi SKU'suna ait sürüm, Kubernetes sürümünüze bağlı olarak değişir. Ubuntu 22.04, Kubernetes sürüm 1.25 ile 1.34 arasında varsayılandır. Ubuntu 24.04, Kubernetes 1.35+ sürümleri için varsayılandır.
Linux Ubuntu2604 Bu işletim sistemi SKU'su Kubernetes sürüm 1.36 ve sonraki sürümlerde önizlemede desteklenir. Kubernetes sürümünüzü yükseltmeden yeni işletim sistemi sürümüne geçmek istiyorsanız, sürümlü işletim sistemi SKU'sunu öneririz. Ubuntu2604Preview özellik bayrağını gerektirir.
Linux Ubuntu2404 Bu işletim sistemi SKU'su yalnızca Kubernetes 1.32 ile 1.38 arasında desteklenecektir. Kubernetes sürümünüzü yükseltmeden yeni işletim sistemi sürümüne geçmek istiyorsanız, sürümlü işletim sistemi SKU'sunu öneririz. Kubernetes 1.35+ sürümlerinde kullanıldığında --os-sku Ubuntu Ubuntu 24.04 varsayılandır.
Linux Ubuntu2204 Bu işletim sistemi SKU'su Kubernetes sürüm 1.25 ile 1.36 arasında desteklenir. Ubuntu 22.04 sürümüne geri dönmeniz gerekiyorsa, belirtilmiş sürüm numaralı bu işletim sistemi SKU'sunu öneriyoruz. Ubuntu 22.04, Kubernetes 1.25 ile 1.35 arası sürümlerde kullanıldığında --os-sku Ubuntu varsayılandır.
Linux AzureLinux Bu işletim sistemi SKU'su tüm Kubernetes sürümlerinde desteklenir. Bu işletim sistemi SKU'suna ait sürüm, Kubernetes sürümünüze bağlı olarak değişir. Azure Linux 2.0, Kubernetes sürüm 1.27 ile 1.31 arasında varsayılandır. Azure Linux 3.0, Kubernetes sürüm 1.32+ için varsayılandır. AKS 1.31'de AzureLinuxV3Preview özellik bayrağı etkinleştirildiğinde, --os-sku AzureLinux varsayılan olarak 3.0'dır.
Linux AzureLinux3 Bu işletim sistemi SKU'su Kubernetes 1.28 ile 1.36 arasında desteklenir. Kubernetes sürümünüzü yükseltmeden yeni işletim sistemi sürümünü test etmek istiyorsanız bu işletim sistemi SKU'su önerilir. Bu işletim sistemi SKU'sundan Azure Linux 2.0'dan Azure Linux 3.0'a geçiş yapmak için de kullanabilirsiniz.
Linux AzureLinuxOSGuard Bu işletim sistemi SKU'su Kubernetes 1.32 ve üzeri sürümlerde desteklenir. OS Guard sürümlerine sahip Azure Linux, düğüm görüntüsü yükseltmeleri aracılığıyla yükseltilir. Daha fazla bilgi için AKS için OS Guard ile Azure Linux bölümüne bakın.
Linux Düz araba Bu işletim sistemi SKU'su tüm Kubernetes sürümlerinde desteklenir. Flatcar sürümleri düğüm imaj yükseltmeleri aracılığıyla yükseltilir. Daha fazla bilgi için bkz. AKS için Flatcar Container Linux.
Linux AzureContainerLinux Bu işletim sistemi SKU'su Kubernetes 1.34 ve üzeri sürümlerde desteklenir. Azure Container Linux sürümleri düğüm görüntüsü yükseltmeleri aracılığıyla yükseltilir.
Windows Windows2022 1,23 - 1,36 Kubernetes sürüm 1.25 ile 1.35 arasında Windows işletim sistemi türü için varsayılandır.
Windows Windows2025 1.32 ve üzeri Kubernetes sürüm 1.36 ve sonraki sürümlerde Windows işletim sistemi türü için varsayılandır. FIPS özellikli bir görüntü (--enable-fips-image) gerektirir.

Yeni bir işletim sistemi sürümüne geçiş

AKS'de yeni bir işletim sistemi sürümü yayınlandığında, başlangıçta önizlemede desteklenir. Birkaç ay boyunca önizlemede test ettikten sonra AKS, yeni işletim sistemi sürümünü genel kullanıma (GA) getirir ve ardından varsayılan işletim sistemi SKU'sunu (Ubuntu veya AzureLinux) en son GA işletim sistemi sürümüne güncelleştirir. Bu varsayılan güncelleştirme yeni bir Kubernetes sürüm sürümüyle gerçekleşir.

Üretim dışı iş yüklerinizi önizleme sürümünde kullanıma sunulduğunda yeni işletim sistemi sürümüyle test etmenizi öneririz. Önizleme işlevlerine erişmek için önizleme uzantısının yüklü olduğundan emin olun. komutunu kullanarak uzantıyı az extension add --name aks-preview yükleyebilirsiniz.

Yeni bir işletim sistemi sürümüne geçmenin iki yolu vardır:

  • Varsayılan işletim sistemi SKU'su: veya Ubuntugibi AzureLinux varsayılan bir işletim sistemi SKU'su kullanıyorsanız Kubernetes sürümünüzü yükselttiğinizde otomatik olarak en son GA sürümünü alırsınız. Yeni bir işletim sistemi sürümüne geçirmek için el ile değişiklik yapılması gerekmez. İşletim sistemi SKU'sunu Ubuntu kullanan kümeler ve düğüm havuzları, Kubernetes sürümünü 1.35 veya üzeri bir sürüme yükseltirken otomatik olarak Ubuntu 24.04'e geçirir.
  • Sürümlenmiş işletim sistemi SKU'su: , Ubuntu2404, AzureLinux3veya Windows2025gibi Ubuntu2604sürüme sahip bir işletim sistemi SKU'su kullanıyorsanız, engellenen Kubernetes yükseltmelerini önlemek için yeni bir işletim sistemi sürümüne el ile geçiş yapmanız gerekir. Linux işletim sistemi kullanıyorsanız, mevcut düğüm havuzundaki işletim sistemi SKU'sunu yerinde geçiş yapmak üzere güncelleştirebilirsiniz. Windows için yerinde geçiş yalnızca Windows Server 2022'den Windows Server 2025'e desteklenir.

Mevcut bir düğüm havuzunda işletim sistemi SKU'sunu güncelleme

Mevcut bir düğüm havuzundaki os-sku öğesini az aks nodepool update komutunu kullanarak güncelleyin. Önizlemede kullanılabilen yeni bir işletim sistemi sürümü olduğu durumlarda, bu işlevsellik Kubernetes sürümünüzü yükseltmenize gerek kalmadan düğüm havuzunuzu yeni işletim sistemi sürümüne geçirmenizi sağlar.

Uyarı

Aşağıdaki Windows değerleri, düğüm havuzu güncelleme komutunda desteklenmez. Windows Server 2022'den Windows Server 2025'e geçişler desteklenir.

  • --os-sku Windows2022

Bunun yerine, kümenize kullanmak istediğiniz karşılık gelen --os-sku düğüm havuzlarını eklemeniz gerekir.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu \
    --name $NODE_POOL_NAME

komutunu kullanarak az aks nodepool update desteklenen herhangi bir Linux os-skuarasında geçiş yapabilirsiniz. Hedef işletim sisteminde Kubernetes sürümünüz, VM boyutunuz veya FIPS etkinleştirmeniz için desteklenen bir düğüm görüntüsü yoksa komut başarısız olabilir.

Ubuntu 26.04'e geçiş (önizleme)

Önemli

AKS önizleme özellikleri self servis ve kabul temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "mevcut olduğu şekilde" sağlanmakta olup, hizmet seviyesi anlaşmalarına ve sınırlı garantilere dahil edilmemektedir. AKS önizlemeleri, müşteri desteği ekibi tarafından maksimum çaba gösterilerek kısmen ele alınmaktadır. Bu nedenle, bu özellikler üretim kullanımı için tasarlanmamıştır. Daha fazla bilgi için aşağıdaki destek makalelerine bakın:

Ubuntu 26.04, Kubernetes sürüm 1.36 ve sonraki sürümlerde önizleme sürümünde kullanılabilir. --os-sku Ubuntu2604 belirterek Ubuntu 26.04 kullanın.

Uyarı

'a --os-sku Ubuntu2604geçiş yaparken aşağıdaki bilgileri göz önünde bulundurun:

  • Ubuntu2604Preview özellik bayrağını, bir düğüm havuzu oluşturmadan veya bir düğüm havuzunu Ubuntu 26.04'e güncelleştirmeden önce kaydedin.
  • Ubuntu 26.04, 2. Nesil VM'leri destekleyen bir VM boyutu gerektirir.
  • Ubuntu 26.04, AMD64 ve Arm64 için en düşük düğüm görüntülerini kullanır.
  • FIPS, Gizli VM ve Güvenilen Başlatma desteklenmez.
  • Azure CLI'nin 21.0.0b14 veya üzeri önizleme sürümünün yüklü ve yapılandırılmış olması gerekir. CLI sürümünüzü bulmak için komutunu çalıştırın az --version. Yüklemek veya yükseltmek için bkz. Azure CLI yükleme.

aks-preview Azure CLI uzantısını yükleme

  1. aks-preview komutunu kullanarak Azure CLI uzantısını az extension add yükleyin.

    az extension add --name aks-preview
    
  2. komutunu kullanarak en son sürümü yüklediğinizden emin olmak için uzantıyı güncelleştirin az extension update .

    az extension update --name aks-preview
    

Düğüm havuzunu oluşturmadan veya Ubuntu 26.04'e güncellemeden önce, Ubuntu2604Preview özellik bayrağını Azure aboneliğinizde kaydedin.

Özellik bayrağını Ubuntu2604Preview kaydetme

  1. Ubuntu2604Preview komutunu kullanarak az feature register özellik bayrağını kaydedin.

    az feature register \
        --namespace Microsoft.ContainerService \
        --name Ubuntu2604Preview
    

    Durumun Kayıtlı olarak gösterilmesi birkaç dakika sürer.

  2. komutunu kullanarak az feature show kayıt durumunu doğrulayın.

    az feature show \
        --namespace Microsoft.ContainerService \
        --name Ubuntu2604Preview \
        --query properties.state
    
  3. Durum Kayıtlı olarak gösterildiğinde, komutunu kullanarak az provider register kaynak sağlayıcısının kaydını yenileyin.

    az provider register --namespace Microsoft.ContainerService
    

Mevcut düğüm havuzunu Ubuntu 26.04'e güncelleştirme

Mevcut bir düğüm havuzunda az aks nodepool update komutunu kullanarak --os-sku Ubuntu2604’a güncelleyin.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu2604 \
    --name $NODE_POOL_NAME

İşletim sistemi sürümünüzü geri alma

Birden çok işletim sistemi sürümünün desteklendiği Kubernetes sürümlerinde komutunu kullanarak az aks nodepool update önceki işletim sistemi sürümüne geri dönebilirsiniz.

Aşağıdaki senaryolarda işletim sistemi sürümünüzü geri almak isteyebilirsiniz:

  • Yeni bir işletim sistemi sürümünü test ediyorsanız ve herhangi bir sorunla karşılaşırsanız.
  • Yeni işletim sistemi sürümünü varsayılan olarak destekleyen bir Kubernetes sürümüne yükselttiğiniz zaman, varsayılan Ubuntu veya AzureLinux işletim sistemi SKU'sunu geri almak isteyebilirsiniz. Bu, bir düğüm havuzu güncelleştirmesi gerektirmek yerine Kubernetes yükseltmelerinizin bir parçası olarak gelecekteki işletim sistemi sürümlerini almanıza olanak tanır.

İşletim sistemi sürümünüzü varsayılan işletim sistemi SKU'suna geri döndür.

Mevcut bir düğüm havuzundaki az aks nodepool update öğesini güncellemek için os-sku komutunu kullanabilirsiniz. Kubernetes sürümünüzde desteklenen önceki bir işletim sistemi sürümü varsa, bu işlevsellik işletim sistemi sürümünüzü geri almanızı sağlayabilir.

Uyarı

Düğüm havuzu güncelleştirme komutu için aşağıdaki değerler desteklenmez:

  • --os-sku Windows2022
  • --os-sku Windows2025

Bunun yerine, kullanmak istediğiniz karşılık geleni --os-sku kullanarak kümenize düğüm havuzları ekleyin. Windows FIPS düğüm havuzlarınız için işletim sistemi sürümünüzü yükseltme hakkında daha fazla bilgi edinmek için bkz. Windows işletim sistemi sürümünü yükseltme.

İşletim Sistemi SKU'su Varsayılan işletim sistemi sürümü
Ubuntu İşletim sistemi SKU'nuz Ubuntuolduğunda, Kubernetes sürümünüz 1.25 ile 1.34 arasındaysa Ubuntu 22.04 varsayılan işletim sistemi sürümüdür. Ubuntu 24.04, Kubernetes 1.35 ile 1.37 arasındaki Ubuntu için varsayılan değerdir.
AzureLinux İşletim sistemi SKU'nuz AzureLinux olduğunda, Azure Linux 2.0, Kubernetes 1.26 ile 1.31 arasında AzureLinux için varsayılan değerdir. Azure Linux 3.0, Kubernetes 1.32 ile 1.36 arasında AzureLinux için varsayılan değerdir.

Mevcut düğüm havuzundaki işletim sistemi SKU'sunu Ubuntu olarak güncelleyin.

Düğüm havuzunuzu işletim sistemi SKU'su Ubuntu kullanacak şekilde güncellerken, Kubernetes sürümünüze bağlı olarak varsayılan işletim sistemi sürümünü alırsınız. Bu, düğüm havuzu güncelleştirme komutu sırasında işletim sistemi sürümü değişirse otomatik bir yeniden oluşturma tetikleyebilir.

Mevcut bir düğüm havuzundaki --os-sku Ubuntu öğesini az aks nodepool update komutunu kullanarak güncelleyin.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu \
    --name $NODE_POOL_NAME

komutunu kullanarak az aks nodepool update desteklenen herhangi bir Linux os-skuarasında geçiş yapabilirsiniz. Hedef işletim sisteminde Kubernetes sürümünüz, VM boyutunuz veya FIPS etkinleştirmeniz için desteklenen bir düğüm görüntüsü yoksa komut başarısız olabilir.

İşletim sistemi SKU'nuzu mevcut bir düğüm havuzunda Azure Linux'a güncelleyin.

Düğüm havuzunuzu işletim sistemi SKU'su AzureLinux kullanacak şekilde güncellerken, Kubernetes sürümünüze bağlı olarak varsayılan işletim sistemi sürümünü alırsınız. Bu, düğüm havuzu güncelleştirme komutu sırasında işletim sistemi sürümü değişirse otomatik bir yeniden oluşturma tetikleyebilir.

Mevcut bir düğüm havuzundaki --os-sku AzureLinux öğesini az aks nodepool update komutunu kullanarak güncelleyin.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku AzureLinux \
    --name $NODE_POOL_NAME

Sonraki Adımlar

AKS'de düğüm görüntüleri, düğüm havuzu yükseltmeleri ve düğüm yapılandırmaları hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın: