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

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.88.0 veya üzeri. az --version komutunu kullanarak sürümünüzü bulun. Yüklemeniz veya yükseltmeniz gerekiyorsa bkz. Azure CLI yükleme. aks-preview uzantısı gerekli değildir.
• API sürümü 2026-04-01 veya üstü.

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.
• Geri almadan önce Kubernetes otomatik yükseltme kanalını devre dışı bırakmanız gerekir. Düğüm işletim sistemi yükseltme kanalı etkinleştirilirse Kubernetes sürümü geri alma işlemi devam edebilir, ancak önceki düğüm görüntüsü geri yüklenmeyebilir. Hem Kubernetes sürümünü hem de düğüm görüntüsünü geri almanız gerektiğinde düğüm işletim sistemi yükseltme kanalını devre dışı bırakın.
• 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.

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.
• Geri alma, düğüm havuzundaki düğümlerin yerini alır ve iş yüklerini geçici olarak kesintiye uğratabilir. Başlamadan önce, iş yüklerinizin yeterli kapasiteye sahip olduğunu ve Pod KesintiSi Bütçelerinizin gerekli düğüm kesintilerine izin verdiğini doğrulayın.
• REST API'yi kullanırken, son kullanılan sürümleri almak için önce Agent Pools - Get Upgrade Profile API'sini çağırabilirsiniz. Geri alma isteğinizde hedef sürümü belirtmek için bu bilgileri kullanın.

Azure CLI geri alma komutu, N-1 olarak da bilinen en son kaydedilen sürümü otomatik olarak seçer. Bu komutu kullanarak isteğe bağlı olarak herhangi bir Kubernetes veya düğüm görüntüsü sürümü seçemezsiniz ve birden çok önceki sürüm arasında ilerlemek için art arda geri alma işlemleri gerçekleştiremezsiniz.

1. Kümenin otomatik yükseltme yapılandırmasını gözden geçirin.

   az aks show \
       --name myAKSCluster \
       --resource-group myResourceGroup \
       --query autoUpgradeProfile
   

   Geri almadan önce Kubernetes otomatik yükseltme kanalını devre dışı bırakın. Önceki düğüm görüntüsünü geri yüklemeniz gerekiyorsa düğüm işletim sistemi yükseltme kanalını da devre dışı bırakın.

2. az aks nodepool get-rollback-versions komutunu kullanarak kullanılabilir geri alma hedefini gözden geçirin.

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

   Komut sürüm döndürmezse düğüm havuzunun uygun bir geri alma hedefi yoktur. Düğüm havuzunun önceki yedi gün içinde yükseltilmiş olması ve kaydedilen Kubernetes sürümünün AKS tarafından desteklenmeye devam etmesi gerekir.

3. az aks nodepool rollback komutunu kullanarak düğüm havuzunu geri alın.

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

4. Geri alma işlemi tamamlandıktan sonra Kubernetes sürümünü, düğüm görüntüsü sürümünü ve sağlama durumunu doğrulayın.

   az aks nodepool show \
       --name myNodePool \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster \
       --query '{provisioningState:provisioningState,kubernetesVersion:currentOrchestratorVersion,nodeImageVersion:nodeImageVersion}'
   

   Başarılı bir geri alma işlemi, provisioningState için Succeeded döndürür ve kaydedilen Kubernetes ile düğüm görüntüsü sürümlerini gösterir.

Geri alma işleminden önce kümenin otomatik yükseltme ayarlarını değiştirdiyseniz, yükseltme sorununu araştırıp çözdükten sonra istenen ayarları geri yükleyin.

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:

• Kümenizdeki etkinlik günlüklerini arayın.
• Kümenizde yükseltmeyle ilgili belirli olayları arayın.
• Azure Event Grid ile AKS olaylarına abone olun.
• Otomatik yükseltme kanalına aboneyseniz, yükseltme bildirimleri için AKS İletişim Yöneticisi'ni kullanabilirsiniz.

Düğüm havuzu geri alma sorunlarını giderme

Aşağıdaki tablo, yaygın geri alma sorunlarını ve bunların nasıl çözüleceğini açıklar:

Sorun	Neden ve çözüm
Geri alma sürümleri döndürülmüyor.	Düğüm havuzunun kayıtlı yükseltmesi olmayabilir, yedi günlük geri alma penceresinin süresi dolmuş olabilir veya önceki Kubernetes sürümü artık desteklenmeyebilir. Düğüm havuzunun yükseltme geçmişini ve AKS Kubernetes sürüm destek ilkesini denetleyin.
AKS, başka bir işlemin devam ettiğini bildirir.	Geri almayı yeniden denemeden önce geçerli küme veya düğüm havuzu işleminin tamamlanmasını bekleyin. İşlemi durdurmanız gerekiyorsa az aks nodepool operation-abort komutunu kullanın.
Kubernetes sürümü geri alınır, ancak düğüm görüntüsü geri alınmaz.	Düğüm işletim sistemi yükseltme kanalı etkin olabilir. Önceki düğüm görüntüsünü geri yüklemeniz gerektiğinde kanalı devre dışı bırakın.
AKS, önceki düğüm görüntüsü sürümünü reddeder.	Düğüm havuzunun işletim sistemi SKU'su kaydedilen sürümden bu yana değişmiş olabilir. Geri alma, işletim sistemi SKU değişikliklerini geri almayı desteklemez. Bunun yerine işletim sistemi SKU'sunu geri almak için az aks nodepool update --os-sku kullanın.
AKS, önceki Kubernetes sürümünü desteklemez.	Kaydedilen sürüm artık desteklenmeyebilir. AKS Kubernetes sürüm destek ilkesini denetleyin.

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.

Aynı nedenle, platform tarafından başlatılan yükseltmeyi geri alamazsınız. AKS bir kümeyi desteklenmeyen bir sürümden başka bir sürüme yükselttiğinde, önceki sürüm artık kullanılamaz.

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

Evet, geri alma işlemi gerçekleştirmeden önce Kubernetes otomatik yükseltme kanalını devre dışı bırakmanız gerekir. Yalnızca düğüm işletim sistemi yükseltme kanalını etkinleştirirseniz Kubernetes sürümü geri alma işlemi devam edebilir, ancak önceki düğüm görüntüsü geri yüklenmeyebilir. Hem Kubernetes sürümünü hem de düğüm görüntüsünü geri almanız gerektiğinde düğüm işletim sistemi yükseltme kanalını devre dışı bırakın.

Küme Azure Kubernetes Fleet Manager otomatik yükseltme profilindeki bir güncelleştirme grubuna dahil edilirse, geri alma işlemini gerçekleştirmeden önce kümeyi güncelleştirme grubundan da 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:

• Azure Kubernetes Service (AKS) üzerinde mavi-yeşil düğüm havuzu yükseltmelerini yapılandırın
• Azure Kubernetes Service (AKS) düğüm havuzları için sıralı yükseltmeleri yapılandırın
• Azure Kubernetes Service (AKS) düğüm işletim sistemi görüntüleri için Otomatik Yükseltme