Azure Kubernetes Service (AKS) düğüm havuzu sürümlerini geri alma (önizleme)

Azure Kubernetes Service (AKS)'deki düğüm havuzu sürüm geri alma özelliği, Kubernetes yükseltmeleri sonrasında beklenmeyen davranışlarla başa çıkmanıza olanak tanır. Sorun oluşursa düğüm havuzlarını önceki Kubernetes sürümüne ve düğüm görüntüsü birleşimine geri alabilir, iş sürekliliğini sağlayabilir ve kapalı kalma süresini en aza indirebilirsiniz. Bu makalede geri alma özelliğinin ne zaman ve nasıl kullanılacağı, özellikleri ve sınırlamaları ve geri alma sonrası eylemleri için en iyi yöntemler açıklanmaktadır.

Önkoşullar

  • Azure CLI sürüm 2.64.0 veya üzeri. komutunu kullanarak az --version sürümünüzü bulun. Yüklemeniz veya yükseltmeniz gerekiyorsa bkz. Azure CLI yükleme.
  • aks-preview Azure CLI uzantısı yüklendi ve en son sürüme güncelleştirildi.
  • API sürümü 2025-08-02-preview veya üstü.

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

Ö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:

aks-preview uzantısını yüklemek veya güncelleştirmek için az extension add ve az extension update komutlarını kullanın.

# Install the aks-preview extension
az extension add --name aks-preview

# Update the aks-preview extension
az extension update --name aks-preview

Desteklenen özellikler, düğüm havuzu sürümü geri alma işlemi için

Düğüm havuzu sürümü geri alma özelliği aşağıdaki özellikleri destekler:

Özellik Description
Sürümü geri döndür Hem Kubernetes hem de düğüm görüntüsü sürümlerini önceki durumlarına geri yükler.
El ile tetikleyici, otomatik yürütme Geri alma el ile başlatma gerektirir, ancak tetiklendiğinde sistem, daha fazla müdahale olmadan geri alma işleminin tamamını otomatik olarak işler.
Düğüm havuzu uyumluluğu Hem sanal makine (VM) havuzları hem de Sanal Makine Ölçek Kümeleri (VMSS) tabanlı düğüm havuzları dahil olmak üzere tüm düğüm havuzu türlerinde çalışır.
İşletim sistemi desteği Ubuntu, Azure Linux ve Windows havuzları dahil olmak üzere tüm işletim sistemi (OS) stok tutma birimleri (SKU) ile uyumludur.
Basitleştirilmiş işlem Anlık görüntü yönetimi gerekmez.

Düğüm havuzu geri alma sınırlamaları ve dikkat edilecek hususlar

Düğüm havuzu geri alma özelliğini kullanırken aşağıdaki sınırlamaları göz önünde bulundurun:

  • Yalnızca sürüm değişiklikleriyle sınırlıdır. Diğer düğüm havuzu değişiklikleri geri döndürülemez.
  • Geri alma sırasında eşzamanlı işlemlere izin verilmez.
  • Yapılandırıldıysa, geri almadan önce küme otomatik yükseltmesini devre dışı bırakmanız gerekir.
  • Yükseltme tamamlandıktan sonra yalnızca yedi gün boyunca kullanılabilir.
  • Birden çok sürüme geri dönmek için ardışık geri alma işlemleri gerçekleştirilemiyor.
  • Geri alma, işletim sistemi SKU değişikliklerini geri almayı desteklemez. Düğüm havuzunuzun işletim sistemi SKU'sunu (örneğin, Ubuntu'dan Azure Linux'a) değiştirdiyseniz, geri alma işlemi farklı bir işletim sistemi SKU'sunun üyesi olan ve reddedilen önceki düğüm görüntüsü sürümünü geri yüklemeyi dener. İşletim sistemi SKU değişikliğini geri almak için az aks nodepool update --os-sku komutunu kullanın yerine.

Düğüm havuzu geri alma kullanırken aşağıdaki noktaları göz önünde bulundurun:

Güvenlik etkileri İşlemle ilgili dikkat edilmesi gerekenler
* Güvenlik açığına maruz kalma: Geri almak, güvenlik düzeltme eklerini ve güncelleştirmeleri daha yeni sürümden kaldırır. Bu nedenle, sorunları çözerken yalnızca geçici olarak geri alma kullanmanızı ve ardından mümkün olan en kısa sürede yeniden yükseltme yapmanızı öneririz. * Hizmet kesintisi: Geri alma işlemi geçici iş yükü kesintilerine neden olabilir.
* Kaynak kullanılabilirliği: Geri alma işlemi için yeterli kapasite olduğundan emin olun.
* Test gereksinimleri: Yükseltmeleri yeniden denemeden önce temel sorunları düzeltmeyi planlayın.

Geri alma neden kullanılır?

Geri alma, üretim ortamları için kritik bir kurtarma mekanizması sağlar:

  • İş sürekliliği: Yükseltmeler beklenmeyen sorunlara neden olduğunda kapalı kalma süresini en aza indirin
  • Risk azaltma: Bilinen iyi yapılandırmaları karmaşık kurtarma yordamları olmadan hızla geri yükleme
  • Basitleştirilmiş kurtarma: El ile müdahaleden veya yedeklerden kümeleri yeniden derlemekten kaçının

Ne zaman düğüm havuzu geri alma kullanılır?

Aşağıdaki senaryolarda kurtarma seçeneğiniz olarak geri almayı göz önünde bulundurun:

  • Yükseltme hataları oluşur: Altyapı sorunları, kaynak kısıtlamaları veya uyumluluk sorunları başarılı yükseltmeleri engeller.
  • Uygulama sonu: İş yükleri, daha yeni Kubernetes sürümleriyle kritik hatalarla veya veri bozulmasıyla karşılaşır.
  • Performans düşüşleri: Yeni sürümler kabul edilemez gecikme süresine, aktarım hızı sorunlarına veya kaynak tüketimine neden olur.
  • Test açıkları ortaya çıkıyor: Üretim öncesi test sırasında yakalanmamış olan üretimde ortaya çıkan sorunlar.

Düğüm havuzu geri döndürme iş akışı

Aşağıdaki diyagramda düğüm havuzu geri alma iş akışı gösterilmektedir.

Düğüm havuzu geri yükleme iş akışını gösteren diyagram.

Geri alma işlemi, bir düğüm havuzundaki tüm düğümleri önceki sürüm durumlarına geri yükler. İş akışının önemli yönleri şunlardır:

  • Tümü veya hiç yaklaşımı: Geri alma işleminin başarıyla tamamlanması için tüm düğümlerin önceki sürüme başarıyla geri döndürülebilmesi gerekir. Herhangi bir düğüm geri almayı başaramazsa, yükseltme işlemine benzer şekilde kümenin durumunu net bir şekilde iletmek amacıyla tüm operasyon başarısız olur.
  • Progress izleme: İşlem geçmişi için Azure Etkinlik Günlüğü'nü ve anlık güncellemeler için İşlem Durumu API'sini kullanarak geriye alma durumunu izleyin.

Bir düğüm havuzu sürümünü geri yükleme

Önemli

Düğüm havuzu sürümünü geri çekerken aşağıdaki bilgileri göz önünde bulundurun:

  • Eski sürümlerde uzun süreli kalmak, güvenlik risklerini artırır ve sürüm dengesizliği sınırlamaları nedeniyle yükseltmeleri engelleyebilir. Geri alma işlemini kalıcı bir çözüm olarak değil geçici bir kurtarma mekanizması olarak değerlendirin.
  • REST API'yi kullanırken, son kullanılan sürümleri almak için önce Yükseltme Profili Al API'sini çağırabilirsiniz. Geri alma isteğinizde hedef sürümü belirtmek için bu bilgileri kullanın.

  • komutunu kullanarak düğüm havuzu sürümünü geri alma az aks nodepool rollback . Aşağıdaki örnek, myNodePool adlı kaynak grubunun içindeki myAKSCluster adlı AKS kümesinde myResourceGroup adlı düğüm havuzunu geri alır.

    az aks nodepool rollback --name myNodePool --resource-group myResourceGroup --cluster-name myAKSCluster

Düğüm havuzu geri alma işlemi durumunu izleme

Düğüm havuzu geri alma işleminin durumunu izlemek ve başarılı bir geri alma işlemini doğrulamak için aşağıdaki yöntemleri kullanabilirsiniz:

Geri alma sonrası en iyi uygulamalar

Düğüm kümenizi başarıyla geri döndürdükten sonra kararlılık ve güvenlik sağlamak için aşağıdaki en iyi yöntemleri kullanın:

  • Kök nedeni araştırın: Başka bir yükseltme denemeden önce yükseltmenin neden başarısız olduğunu belirleyin. Uygulama günlüklerini, kaynak ölçümlerini ve uyumluluk gereksinimlerini gözden geçirin.
  • Üretim dışı test: Üretimi yeniden yükseltmeden önce sorunları yeniden oluşturmak ve çözmek için geliştirme veya hazırlama ortamındaki daha yeni sürümü doğrulayın.
  • Yeniden yükseltmenizi planlayın: Süresiz olarak geri alınan sürümde kalmayın. Güvenlik düzeltme eklerini ve desteğini korumak için yeniden yükseltme zamanlayın:
    • Kritik güvenlik sorunları için: Düzeltmeler doğrulandıktan sonra günler içinde yeniden yükseltme.
    • Uygulama uyumluluğu sorunları için: Kod ayarlamalarından sonra haftalar içinde yeniden yükseltme.
    • Önerilen maksimum süre: Güvenlik açıklarının birikmemesi için 30 gündür.

Sık sorulan sorular (SSS)

Düğüm havuzu geri alma sırasında başka işlemler gerçekleştirebilir miyim?

Hayır, diğer işlemleri başlatmadan önce geri alma işlemi tamamlanmalıdır. Farklı işlemler gerçekleştirmek için önce geri alma işlemini iptal edin.

Düğüm havuzu geri alma işlemi hem Kubernetes sürümünü hem de düğüm görüntüsünü geri mi döndürüyor?

Evet, geri alma işlemi en son kullanılan Kubernetes sürümüne ve buna karşılık gelen düğüm görüntüsüne geri döner. Her iki bileşen de değişirse, sistem önceki Kubernetes sürümünü bu sürüm için son uyumlu düğüm görüntüsüyle geri yükler.

Düğüm havuzu sürümünü değiştirmeden yalnızca düğüm görüntüsünü geri alabilir miyim?

Evet, son yedi gün içinde (düğüm havuzu sürümünü yükseltmeden) yalnızca bir düğüm görüntüsü güncelleştirmesi gerçekleştirdiyseniz, geri alma işlemi aynı Kubernetes sürümünü korurken önceki sanal sabit disk (VHD) görüntüsünü geri yükler.

Destekten çıkmış bir sürüme geri dönebilir miyim?

Hayır, AKS tarafından artık desteklenmeyen bir Kubernetes sürümüne geri dönemezsiniz. Örneğin düğüm havuzunuz 1.27.9 sürümündeyse (artık destekten çıktıysa) ve 1.28.5 sürümüne yükselttiyseniz, artık desteklenen sürüm listesinde olmadığından 1.27.9 sürümüne geri dönemezsiniz. Sürüm kullanılabilirliğini doğrulamak için aks Kubernetes sürüm destek ilkesini her zaman denetleyin.

Düğüm havuzunu geri alma işlemi gerçekleştirmeden önce otomatik yükseltmeyi devre dışı bırakmam gerekiyor mu?

Evet, kümenizde otomatik sürüm etkinleştirilmişse geri alma işlemi gerçekleştirmeden önce kümeyi devre dışı bırakmanız gerekir. Ayrıca, küme Azure Kubernetes Fleet Manager otomatik güncelleştirme profilindeki bir update grubuna dahil edilirse geri alma işlemini gerçekleştirmeden önce kümeyi güncelleştirme grubundan kaldırmanız gerekir. Aksi takdirde, geri alma tamamlandıktan sonra otomatik yükseltme işlemi düğüm havuzunuzu otomatik olarak yeniden yükseltebilir.

İşletim sistemi SKU'sunu (örneğin, Ubuntu'dan Azure Linux'a) değiştirdikten sonra eski duruma geri dönebilir miyim?

Hayır. Düğüm havuzu geri alma, sürüm değişiklikleriyle sınırlıdır ve işletim sistemi SKU değişikliklerini geri döndürmez. Bir işletim sistemi SKU'sundan diğerine (örneğin, Ubuntu'dan Azure Linux'a) geçirildikten sonra, önceki düğüm görüntüsü sürümü eski işletim sistemi SKU'sunundır ve geçerli yapılandırmayla uyumsuzdur. Geri alma işlemi önceki görüntü sürümünü aşağıdakine benzer bir hatayla reddeder:

NodeImageVersion 'AKSUbuntu-2204gen2containerd-202602.13.5' is not accepted. NodeImageVersion can only be current version 'AKSAzureLinux-V3gen2-202602.13.5' or 'latest'

İşletim sistemi SKU'sunu geri döndürmek için az aks nodepool update komutunu --os-sku parametresiyle kullanın. Daha fazla bilgi için bkz. İşletim sistemi sürümünüzü geri alma.

İlgili içerik

AKS'deki düğüm havuzu yükseltmeleri hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın:

  • Last updated on