Aracılığıyla paylaş

Azure Stack Hub'da AKS altyapısı için sürüm notları

  • Makale

AKS altyapısının v0.80.2 sürümü için geçerlidir.

Bu makalede, Azure Stack Hub güncelleştirmesindeki Azure Kubernetes Service (AKS) altyapısının içeriği açıklanmaktadır. Güncelleştirme, Azure Stack Hub platformunu hedefleyen AKS altyapısının en son sürümüne yönelik iyileştirmeler ve düzeltmeler içerir. Bu makale, genel Azure için AKS altyapısının sürüm bilgilerini belgelemeye yönelik değildir.

Yükseltme hususları

  • AKS altyapısı sürümünüz için doğru market öğelerini mi( AKS Base Ubuntu 20.04 Image Distro veya AKS Base Windows Server) kullanıyorsunuz? Sürümleri Yeni görüntüleri ve AKS altyapısını indirme bölümünde bulabilirsiniz.
  • Hedef küme için doğru küme belirtimini (apimodel.json) ve kaynak grubunu kullanıyor musunuz? Kümeyi ilk dağıttığınızda, bu dosya çıkış dizininizde oluşturulmuştur. Kubernetes kümesi dağıtma komut parametrelerine bakın.
  • AKS altyapısını çalıştırmak ve yükseltme işlemlerini gerçekleştirmek için güvenilir bir makine mi kullanıyorsunuz?
  • Etkin iş yükleri olan bir işletimsel kümeyi güncelleştiriyorsanız, kümenin normal yük altında olduğunu varsayarak yükseltmeyi bunları etkilemeden uygulayabilirsiniz. Ancak, kullanıcıları bu kümeye yönlendirmeniz gerekmesi durumunda bir yedekleme kümeniz olmalıdır. Bir yedekleme kümesi kesinlikle önerilir.
  • Mümkünse, ağ atlamalarını ve olası bağlantı hatalarını azaltmak için Azure Stack Hub ortamındaki bir VM'den komutunu çalıştırın.
  • Aboneliğinizin tüm işlem için yeterli kotaya sahip olduğundan emin olun. İşlem sırasında yeni VM'ler ayırır. Sonuçta elde edilen VM sayısı özgün vm ile aynı olur, ancak işlem sırasında birkaç vm daha oluşturulmasını planlayın.
  • Sistem güncelleştirmeleri veya zamanlanmış görevler planlanmıyor.
  • Üretim kümesiyle aynı değerlerle yapılandırılmış bir kümede aşamalı yükseltme ayarlayın ve üretim kümenizde bunu yapmadan önce yükseltmeyi orada test edin.

Upgrade komutunu kullanma

Komutunu Azure Stack Hub'da Kubernetes kümesini yükseltme bölümünde açıklandığı gibi kullanmanız aks-engine upgrade gerekir.

Yükseltme kesintileri

Bazen beklenmeyen faktörler küme yükseltmesini kesintiye uğratır. AKS altyapısı bir hata bildirdiğinde veya AKS altyapısı yürütme işlemine bir şey olduğunda kesinti oluşabilir. Kesintinin nedenini inceleyin, sorunu giderin ve yükseltme işlemine devam etmek için aynı upgrade komutu yeniden gönderin. Komut upgrade bir kez etkilidir ve komutu yeniden gönderdiğinizde küme yükseltmesini sürdürmesi gerekir. Normalde kesintiler güncelleştirmeyi tamamlama süresini artırır ancak tamamlanmasını etkilemez.

Tahmini yükseltme süresi

Tahmini yükseltme süresi, kümedeki VM başına 12 ila 15 dakikadır. Örneğin, 20 düğümlü bir kümenin yükseltimi yaklaşık 5 saat sürebilir.

AKS altyapısı 0.70.0 ve üzerini kullanma yönergeleri

Yeni görüntü ve AKS altyapısını indirme

AKS temel Ubuntu görüntüsünün ve AKS altyapısının yeni sürümlerini indirin.

Azure Stack Hub için AKS altyapısı belgelerinde açıklandığı gibi Kubernetes kümesi dağıtmak için şunlar gerekir:

  • aks-engine ikili dosyası (gerekli).
  • AKS Temel Ubuntu 16.04-LTS Görüntü Dağıtımı (kullanım dışıdır - artık kullanım dışıdır, API Modelinde 20.04 kullanacak şekilde değiştirin).
  • AKS Base Ubuntu 18.04-LTS Görüntü Dağıtımı (kullanım dışı bırakıldı, artık kullanım dışı, API Modelinde 20.04 kullanacak şekilde değiştirin).
  • AKS Base Ubuntu 20.04-LTS Görüntü Dağıtımı (Linux aracıları için gereklidir).
  • AKS Temel Windows Server Görüntüsü (Windows aracıları için aşağıdaki görüntülerden biri gereklidir):
    • AKS Temel Windows Server Görüntüsü Kapsayıcılı.
    • AKS Temel Windows Server Görüntü Docker.

Bu görüntülerin yeni sürümleri bu güncelleştirmeyle kullanılabilir:

  • Gerekli AKS temel görüntüleri için AKS altyapısını ve Azure Stack sürüm eşleme tablosunu denetleyin.

    Azure Stack Hub Market'e Azure Kubernetes Services (AKS) altyapısı önkoşullarını ekleme başlığı altında yer alan yönergeleri izleyin.

  • Kubernetes küme yöneticisinin (normalde Azure Stack Hub kiracı kullanıcısı) yeni aks-engine'i indirmesi gerekir. Azure Stack Hub'da Linux üzerinde AKS altyapısını yükleme (veya eşdeğer Windows makalesi) başlığı altındaki yönergelere bakın. Kümeyi ilk kez yüklemek için kullandığınız işlemi izleyebilirsiniz. Güncelleştirme, önceki ikili dosyanın üzerine yazar. Örneğin, get-akse.sh betiğini kullandıysanız Bağlı bir ortama yükleme bölümünde açıklanan adımların aynısını izleyin. Windows sistemine yüklüyorsanız aynı işlem geçerlidir: Azure Stack Hub'da AKS altyapısını Windows'a yükleyin.

Ubuntu 16.04 dağıtımıyla oluşturulan Kubernetes kümelerini yükseltme

AKS Altyapısı v0.63.0'dan başlayarak, işletim sistemi kullanım ömrü sonuna ulaştığı için Ubuntu 16.04 dağıtımı artık desteklenen bir seçenek değildir. AKS Altyapısı v0.67.0 veya sonraki sürümleri için aks-engine yükseltmesi ile desteklenmeyen aks-ubuntu-16.04 dağıtım değerinin aks-ubuntu-18.04üzerine otomatik olarak yazar. AKS Engine v0.75.3 veya üzeri sürümlerde Kubernetes v1.24 veya üzerini kullanıyorsanız aks-engine-azurestack yükseltmesi, ile aks-ubuntu-20.04desteklenmeyen dağıtım değerinin aks-ubuntu-16.04 üzerine otomatik olarak yazar.

Ubuntu 18.04 dağıtımıyla oluşturulan Kubernetes kümelerini yükseltme

AKS Altyapısı v0.75.3 ile başlayarak, işletim sistemi kullanım ömrü sonuna ulaştığı için Ubuntu 18.04 dağıtımı artık desteklenen bir seçenek değildir. AKS Engine v0.75.3 veya sonraki sürümleri için aks-engine-azurestack yükseltmesi, ile desteklenmeyen dağıtım değerinin aks-ubuntu-18.04 aks-ubuntu-20.04üzerine otomatik olarak yazar.

Docker container runtime ile oluşturulan Kubernetes kümelerini yükseltme

Kubernetes v1.24'te dockershim bileşeni kubelet'ten kaldırıldı. Sonuç olarak docker kapsayıcısı çalışma zamanı artık desteklenen bir seçenek değildir. Daha fazla bilgi için bkz. Kubernetes v1.24 sürüm notları. AKS Engine v0.75.3 veya sonraki sürümleri için aks-engine-azurestack yükseltmesi ile desteklenmeyen değerin docker containerRuntime containerdüzerine otomatik olarak yazar.

AKS Altyapısı sürüm v0.75.3 için Kubernetes v1.23 üzerinde Windows düğümlerine sahip kümeler Docker çalışma zamanı ile Windows temel görüntüsünü kullanabilir. Kubernetes v1.24 üzerinde Windows düğümlerine sahip kümeler, Kapsayıcılı çalışma zamanı ile Windows temel görüntüsünü kullanabilir.

AKS altyapısı ve Azure Stack sürüm eşlemesi

Azure Stack Hub sürümü AKS altyapı sürümü
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*
2406 0.80.2*

Not

*Destekli. Daha fazla bilgi için AKS Altyapısı Sürüm Desteği ilkesine bakın.

AKS altyapısı ve karşılık gelen görüntü eşlemesi

Azure Stack Hub'da AKS Altyapısı için desteklenen Kubernetes sürümlerini aşağıdaki tabloda bulabilirsiniz. Genel Azure'da ve Azure Stack Hub'da desteklenen sürümleri döndüren aks-engine get-versions komutunu kullanmayın.

AKS altyapısı AKS temel görüntüsü Kubernetes sürümleri API modeli örnekleri
v0.43.1 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ekim 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Mart 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Mayıs 2020 (2020.05.13), AKS Temel Windows Görüntüsü (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ağustos 2020 (2020.08.24), AKS Temel Windows Görüntüsü (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Eylül 2020 (2020.09.14), AKS Temel Windows Görüntüsü (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, Ocak 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Temel Windows Görüntüsü (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Temel Windows Görüntüsü (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API Modeli Örnekleri (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Görüntü Dağıtımı, 2021 Q3 (2021.09.27), AKS Temel Windows Görüntüsü (17763.2213.210927) 1.19.15, 1.20.11 API Modeli Örnekleri (Linux, Windows)
v0.67.3 AKS Base Ubuntu 18.04-LTS Görüntü Dağıtımı, 2021 Q3 (2021.09.27), AKS Temel Windows Görüntüsü (17763.2213.210927) 1.19.15, 1.20.11 API Modeli Örnekleri (Linux, Windows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07), AKS Temel Windows Görüntüsü (17763.2565.220408) 1.21.10*, 1.22.7* API Modeli Örnekleri (Linux, Windows)
v0.71.0 AKS Base Ubuntu 18.04-LTS Görüntü Dağıtımı, 2022 Q3 (2022.08.12), AKS Temel Windows Görüntüsü (17763.3232.220805) 1.22.7*, 1.23.6* API Modeli Örnekleri (Linux, Windows)
v0.73.0 AKS Base Ubuntu 18.04-LTS Görüntü Dağıtımı, 2022 Q4 (2022.11.02), AKS Temel Windows Görüntüsü (17763.3532.221102) 1.22.15*, 1.23.13* API Modeli Örnekleri (Linux, Windows)
v0.75.3 AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2), AKS Base Windows Server 2019 Image Docker (17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) 1.23.15*, 1.24.9** API Modeli Örnekleri (Linux, Windows)
v0.76.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3), AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) 1.24.11**, 1.25.7** API Modeli Örnekleri (Linux, Windows)
v0.77.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.206.1), AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) 1.25.7**, 1.26.6** API Modeli Örnekleri (Linux, Windows)
v0.78.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.242.3), AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) 1.25.13**, 1.26.8** API Modeli Örnekleri (Linux, Windows)
v0.79.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1), AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961) 1.26.9**, 1.27.6** API Modeli Örnekleri (Linux, Windows)
v0.80.2 AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1), AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) 1.27.10**, 1.28.6** API Modeli Örnekleri (Linux, Windows)

Not

*Kubernetes v1.21'den başlayarak Azure Stack Hub'da yalnızca Azure için Bulut Sağlayıcısı desteklenir.

Not

** Kubernetes v1.24'ten itibaren yalnızca containerd kapsayıcı çalışma zamanı desteklenir. Daha fazla bilgi için Docker container runtime ile oluşturulan Kubernetes kümelerini yükseltme bölümüne bakın.

Güncelleştirme planlaması

AKS altyapısı upgrade komutu kümenizin yükseltme işlemini tamamen otomatikleştirir ve sanal makineleri (VM), ağ, depolama, Kubernetes ve düzenleme görevlerini işler. Güncelleştirmeyi uygulamadan önce sürüm notu bilgilerini gözden geçirmeyi unutmayın.

AKSe 0.76.0 ile ilgili yenilikler

AKSe 0.75.3 ve üzeri sürümlerle ilgili yenilikler

AKS Altyapısı sürüm v0.75.3 ve Azure Stack Hub'da gelecekteki tüm AKS Altyapısı sürümleri yeni aks-engine-azurestack deposundan alınacaktır. Bu nedenle, tüm aks-engine komutlar ile aks-engine-azurestackdeğiştirilmelidir. Azure Stack Hub'da en son AKS Altyapısı sürümünü almaya yönelik komutlar da değişti. Yeni komutları Linux istemcisi oluşturma ve Windows istemcisi oluşturma bölümünde görebilirsiniz. Herhangi bir sorun bulursanız yeni depoda bir sorun oluşturun.

Azure Stack Hub'daki AKS Altyapısı sürümü v0.75.3, Linux temel görüntüsü olarak Ubuntu 20.04 LTS sunar. Bu sürümden itibaren Ubuntu 18.04 artık desteklenmiyor. Daha fazla bilgi için bkz . Ubuntu 18.04 Dağıtımı ile oluşturulan Kubernetes kümelerini yükseltme.

Kubernetes v1.24'ten başlayarak yalnızca containerd çalışma zamanı desteklenir. Daha fazla bilgi için bkz . Docker çalışma zamanıyla oluşturulan Kubernetes kümelerini yükseltme. AKS Altyapısı sürüm v0.75.3 için Kubernetes v1.23 üzerinde Windows düğümlerine sahip kümeler Docker çalışma zamanı ile Windows temel görüntüsünü kullanabilir. Kubernetes v1.24 üzerinde Windows düğümlerine sahip kümeler, Containerd çalışma zamanı ile Windows temel görüntüsünü kullanabilir.

v0.75.3 GitHub sayfasında daha fazla özellik bulabilirsiniz.

AKS altyapısı 0.70.0 ve üzerini kullanma yönergeleri

Microsoft, Azure Bulut Sağlayıcısı'nı 0.70.0 sürümünde yükseltti. Azure Bulut Sağlayıcısı, Azure Stack Hub'da AKS Azure ve AKS altyapısı arasında paylaşılan temel bir bileşendir.

AKS altyapısı 0.70.0 ve üzerini kullanmak için:

  • İlk kez yeni bir Kubernetes kümesi oluşturmaya çalışırsanız: AKS altyapısında ve ilgili görüntü eşleme tablosunda uygun sürüm için sağlanan örnek API modelini kullanın.

  • Yeni bir küme oluşturuyor ancak mevcut API modelinizi kullanmak istiyorsanız: Azure için Bulut Sağlayıcısı yönergelerini izleyerek API modelinizi değiştirin. Yeni ayarın eklenememesi dağıtım hatasına neden olur.

  • Depolama birimleri kullanıyorsanız: AzureDiskCSI sürücüsünü kullandığınızdan emin olun. Sürüm 0.70.0 ve üzeri yalnızca CSI sürücülerini destekler, eski ağaç içi depolama sağlayıcısını desteklemez. Yükseltmek için depolama birimlerini kullanırken yükseltme yönergelerini izleyin.

Bilinen sorunlar

  • Birden çok Kubernetes hizmetini tek bir küme içinde paralel olarak dağıtmak temel yük dengeleyici yapılandırmasında hataya neden olabilir. Tek seferde bir hizmet dağıtmanızı öneririz.
  • Aks-engine aracı Azure ve Azure Stack Hub genelinde paylaşılan bir kaynak kodu deposu olduğundan, birçok sürüm notunu ve çekme isteğini incelemek, aracın daha önce listelenenlerin ötesinde diğer Kubernetes ve işletim sistemi platformlarını desteklediğine inanmanıza neden olabilir. Bunları yoksayabilir ve bu güncelleştirmenin resmi kılavuzu olarak yukarıdaki sürüm tablosunu kullanabilirsiniz.
  • AKS Altyapısı v0.67.0, Windows kümelerini dağıtırken yanlış Windows görüntüsünü kullanır. Bu sorunu çözmek için v0.70.0 kullanın.

Başvuru

Aşağıdaki liste, Azure ve Azure Stack Hub için birleştirilmiş sürüm notlarının tamamıdır:

AKS altyapısının v0.67.0 sürümü için geçerlidir.

Bu makalede, Azure Stack Hub güncelleştirmesindeki Azure Kubernetes Service (AKS) altyapısının içeriği açıklanmaktadır. Güncelleştirme, Azure Stack Hub platformunu hedefleyen AKS altyapısının en son sürümüne yönelik iyileştirmeler ve düzeltmeler içerir. Bu makale, genel Azure için AKS altyapısının sürüm bilgilerini belgelemeye yönelik değildir.

Güncelleştirme planlaması

AKS altyapısı upgrade komutu, kümenizin yükseltme işlemini tam olarak otomatikleştirir. Sanal makineleri (VM), ağ, depolama, Kubernetes ve düzenleme görevlerini işler. Güncelleştirmeyi uygulamadan önce sürüm notu bilgilerini gözden geçirmeyi unutmayın.

Yükseltme hususları

  • AKS altyapısı sürümünüz için doğru market öğelerini mi kullanıyorsunuz( AKS Base Ubuntu 16.04-LTS veya 18.04 Image Distro veya AKS Base Windows Server? Sürümleri "Yeni görüntüleri ve AKS altyapısını indirme" bölümünde bulabilirsiniz.
  • Hedef küme için doğru küme belirtimini (apimodel.json) ve kaynak grubunu kullanıyor musunuz? Kümeyi ilk dağıttığınızda, bu dosya çıkış dizininizde oluşturulmuştur. Kubernetes kümesi dağıtma komut parametrelerine bakın.
  • AKS altyapısını çalıştırmak ve yükseltme işlemlerini gerçekleştirmek için güvenilir bir makine mi kullanıyorsunuz?
  • Etkin iş yükleri olan bir işletimsel kümeyi güncelleştiriyorsanız, kümenin normal yük altında olduğunu varsayarak yükseltmeyi bunları etkilemeden uygulayabilirsiniz. Ancak, kullanıcıları bu kümeye yönlendirmeniz gerekmesi durumunda bir yedekleme kümeniz olmalıdır. Bir yedekleme kümesi kesinlikle önerilir.
  • Mümkünse, ağ atlamalarını ve olası bağlantı hatalarını azaltmak için Azure Stack Hub ortamındaki bir VM'den komutunu çalıştırın.
  • Aboneliğinizin tüm işlem için yeterli kotaya sahip olduğundan emin olun. İşlem sırasında yeni VM'ler ayırır. Sonuçta elde edilen VM sayısı özgün vm ile aynı olur, ancak işlem sırasında birkaç vm daha oluşturulmasını planlayın.
  • Sistem güncelleştirmeleri veya zamanlanmış görevler planlanmıyor.
  • Üretim kümesiyle aynı değerlerle yapılandırılmış bir kümede aşamalı yükseltme ayarlayın ve üretim kümenizde bunu yapmadan önce yükseltmeyi orada test edin.

Upgrade komutunu kullanma

Komutunu Azure Stack Hub'da Kubernetes kümesini yükseltme bölümünde açıklandığı gibi kullanmanız aks-engine upgrade gerekir.

Yükseltme kesintileri

Bazen beklenmeyen faktörler küme yükseltmesini kesintiye uğratır. AKS altyapısı bir hata bildirdiğinde veya AKS altyapısı yürütme işlemine bir şey olduğunda kesinti oluşabilir. Kesintinin nedenini inceleyin, sorunu giderin ve yükseltme işlemine devam etmek için aynı upgrade komutu yeniden gönderin. Komut upgrade bir kez etkilidir ve komutu yeniden gönderdiğinizde küme yükseltmesini sürdürmesi gerekir. Normalde kesintiler güncelleştirmeyi tamamlama süresini artırır ancak tamamlanmasını etkilemez.

Tahmini yükseltme süresi

Tahmini yükseltme süresi, kümedeki VM başına 12 ila 15 dakikadır. Örneğin, 20 düğümlü bir kümenin yükseltimi yaklaşık 5 saat sürebilir.

Yeni görüntü ve AKS altyapısını indirme

AKS temel Ubuntu görüntüsünün ve AKS altyapısının yeni sürümlerini indirin.

Azure Stack Hub için AKS altyapısı belgelerinde açıklandığı gibi Kubernetes kümesi dağıtmak için şunlar gerekir:

  • aks-engine ikili dosyası (gerekli).
  • AKS Temel Ubuntu 16.04-LTS Görüntü Dağıtımı (kullanım dışı bırakıldı- artık kullanım dışı, API modelinde 18.04 kullanacak şekilde değiştirin).
  • AKS Temel Ubuntu 18.04-LTS Görüntü Dağıtımı (Linux aracıları için gereklidir).
  • AKS Temel Windows Server Görüntü Dağıtımı (Windows aracıları için gereklidir).

Bu görüntülerin yeni sürümleri bu güncelleştirmeyle kullanılabilir:

  • Gerekli AKS temel görüntüleri için AKS altyapısını ve Azure Stack sürüm eşleme tablosunu denetleyin.

    Azure Stack Hub Market'e Azure Kubernetes Services (AKS) altyapısı önkoşullarını ekleme başlığı altında yer alan yönergeleri izleyin.

  • Kubernetes küme yöneticisinin (normalde Azure Stack Hub kiracı kullanıcısı) yeni aks-engine'i indirmesi gerekir. Azure Stack Hub'da Linux üzerinde AKS altyapısını yükleme (veya eşdeğer Windows makalesi) başlığı altındaki yönergelere bakın. Kümeyi ilk kez yüklemek için kullandığınız işlemi izleyebilirsiniz. Güncelleştirme, önceki ikili dosyanın üzerine yazar. Örneğin, get-akse.sh betiğini kullandıysanız Bağlı bir ortama yükleme bölümünde açıklanan adımların aynısını izleyin. Windows sistemine yüklüyorsanız aynı işlem geçerlidir: Azure Stack Hub'da AKS altyapısını Windows'a yükleyin.

Ubuntu 16.04 dağıtımıyla oluşturulan Kubernetes kümelerini yükseltme

AKS Altyapısı v0.67.0 ile başlayarak, işletim sistemi kullanım ömrünün sonuna ulaştığı için Ubuntu 16.04 dağıtımı artık desteklenen bir seçenek değildir. Bir kümeyi yükseltmek için, tarafından oluşturulan aks-engine deploy ve giriş olarak geçirilen giriş API'sinin giriş API'sinde işletim sistemi dağıtımını aks-ubuntu-18.04 aks-engine upgradeayarladığınızdan emin olun:

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

AKS altyapısı ve Azure Stack sürüm eşlemesi

Azure Stack Hub sürümü AKS altyapı sürümü
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

AKS altyapısı v0.67.0'da Kubernetes sürüm yükseltme yolu

Azure Stack Hub için geçerli sürümü ve yükseltme sürümünü aşağıdaki tabloda bulabilirsiniz. Bu tablo, Azure Stack Hub'daki AKS altyapısı kümesi için geçerlidir. Genel Azure'da ve Azure Stack Hub'da desteklenen sürümleri döndüren aks-engine get-versions komutunu kullanmayın.

Geçerli sürüm Yükseltme var
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

API modeli JSON dosyasında, bölümünün altındaki orchestratorProfile sürüm ve sürüm değerlerini belirtin. Örneğin, Kubernetes 1.17.17'yi dağıtmayı planlıyorsanız, aşağıdaki iki değerin ayarlanması gerekir (örnek kubernetes-azurestack.json bakın):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS altyapısı ve karşılık gelen görüntü eşlemesi

AKS altyapısı AKS temel görüntüsü Kubernetes sürümleri API modeli örnekleri
v0.43.1 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ekim 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Mart 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Mayıs 2020 (2020.05.13), AKS Temel Windows Görüntüsü (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ağustos 2020 (2020.08.24), AKS Temel Windows Görüntüsü (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Eylül 2020 (2020.09.14), AKS Temel Windows Görüntüsü (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, Ocak 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Temel Windows Görüntüsü (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Temel Windows Görüntüsü (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API Modeli Örnekleri (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Görüntü Dağıtımı, 2021 Q3 (2021.09.27), AKS Temel Windows Görüntüsü (17763.2213.210927) 1.19.15, 1.20.11 API Modeli Örnekleri (Linux, Windows)

Yenilikler

Özel önizlemeye katılmak istiyorsanız önizleme erişimi isteyebilirsiniz.

Yeni özellikler şunlardır:

  • Kubernetes 1.19.15 ve 1.20.11 desteği

Bilinen sorunlar

  • Birden çok Kubernetes hizmetini tek bir küme içinde paralel olarak dağıtmak temel yük dengeleyici yapılandırmasında hataya neden olabilir. Tek seferde bir hizmet dağıtmanızı öneririz.
  • Aks-engine aracı Azure ve Azure Stack Hub genelinde paylaşılan bir kaynak kodu deposu olduğundan, birçok sürüm notunu ve çekme isteğini incelemek, aracın daha önce listelenenlerin ötesinde diğer Kubernetes ve işletim sistemi platformlarını desteklediğine inanmanıza neden olabilir. Bunları yoksayabilir ve bu güncelleştirmenin resmi kılavuzu olarak yukarıdaki sürüm tablosunu kullanabilirsiniz.

Başvuru

Aşağıdaki liste, Azure ve Azure Stack Hub için birleştirilmiş sürüm notlarının tamamıdır:

AKS altyapısının v0.60.1 sürümü için geçerlidir.

Bu makalede, Azure Stack Hub güncelleştirmesindeki Azure Kubernetes Service (AKS) altyapısının içeriği açıklanmaktadır. Güncelleştirme, Azure Stack Hub platformunu hedefleyen AKS altyapısının en son sürümüne yönelik iyileştirmeler ve düzeltmeler içerir. Bu makale, genel Azure için AKS altyapısının sürüm bilgilerini belgelemeye yönelik değildir.

Güncelleştirme planlaması

AKS altyapısı upgrade komutu kümenizin yükseltme işlemini tamamen otomatikleştirir ve sanal makineleri (VM), ağ, depolama, Kubernetes ve düzenleme görevlerini işler. Güncelleştirmeyi uygulamadan önce sürüm notu bilgilerini gözden geçirmeyi unutmayın.

Yükseltme hususları

  • AKS altyapısı sürümünüz için doğru market öğelerini mi kullanıyorsunuz( AKS Base Ubuntu 16.04-LTS veya 18.04 Image Distro veya AKS Base Windows Server? Sürümleri "Yeni görüntüleri ve AKS altyapısını indirme" bölümünde bulabilirsiniz.
  • Hedef küme için doğru küme belirtimini (apimodel.json) ve kaynak grubunu kullanıyor musunuz? Kümeyi ilk dağıttığınızda, bu dosya çıkış dizininizde oluşturulmuştur. Kubernetes kümesi dağıtma komut parametrelerine bakın.
  • AKS altyapısını çalıştırmak ve yükseltme işlemlerini gerçekleştirmek için güvenilir bir makine mi kullanıyorsunuz?
  • Etkin iş yükleri olan bir işletimsel kümeyi güncelleştiriyorsanız, kümenin normal yük altında olduğunu varsayarak yükseltmeyi bunları etkilemeden uygulayabilirsiniz. Ancak, kullanıcıları bu kümeye yönlendirmeniz gerekmesi durumunda bir yedekleme kümeniz olmalıdır. Bir yedekleme kümesi kesinlikle önerilir.
  • Mümkünse, ağ atlamalarını ve olası bağlantı hatalarını azaltmak için Azure Stack Hub ortamındaki bir VM'den komutunu çalıştırın.
  • Aboneliğinizin tüm işlem için yeterli kotaya sahip olduğundan emin olun. İşlem sırasında yeni VM'ler ayırır. Sonuçta elde edilen VM sayısı özgün vm ile aynı olur, ancak işlem sırasında birkaç vm daha oluşturulmasını planlayın.
  • Sistem güncelleştirmeleri veya zamanlanmış görevler planlanmıyor.
  • Üretim kümesiyle aynı değerlerle yapılandırılmış bir kümede aşamalı yükseltme ayarlayın ve üretim kümenizde bunu yapmadan önce yükseltmeyi orada test edin.

Upgrade komutunu kullanma

Komutunu Azure Stack Hub'da Kubernetes kümesini yükseltme bölümünde açıklandığı gibi kullanmanız aks-engine upgrade gerekir.

Yükseltme kesintileri

Bazen beklenmeyen faktörler küme yükseltmesini kesintiye uğratır. AKS altyapısı bir hata bildirdiğinde veya AKS altyapısı yürütme işlemine bir şey olduğunda kesinti oluşabilir. Kesintinin nedenini inceleyin, sorunu giderin ve yükseltme işlemine devam etmek için aynı upgrade komutu yeniden gönderin. Komut upgrade bir kez etkilidir ve komutu yeniden gönderdiğinizde küme yükseltmesini sürdürmesi gerekir. Normalde kesintiler güncelleştirmeyi tamamlama süresini artırır ancak tamamlanmasını etkilemez.

Tahmini yükseltme süresi

Tahmini yükseltme süresi, kümedeki VM başına 12 ila 15 dakikadır. Örneğin, 20 düğümlü bir kümenin yükseltlenmesi yaklaşık 5 saat sürebilir.

Yeni görüntü ve AKS altyapısını indirme

AKS temel Ubuntu görüntüsünün ve AKS altyapısının yeni sürümlerini indirin.

Azure Stack Hub'daki AKS altyapısının belgelerinde açıklandığı gibi Kubernetes kümesi dağıtmak için şunlar gerekir:

  • aks-engine ikili dosyası (gerekli).
  • AKS Temel Ubuntu 16.04-LTS Görüntü Dağıtımı (kullanım dışı bırakıldı- artık kullanım dışı, API modelinde 18.04 kullanacak şekilde değiştirin).
  • AKS Temel Ubuntu 18.04-LTS Görüntü Dağıtımı (Linux aracıları için gereklidir).
  • AKS Temel Windows Server Görüntü Dağıtımı (Windows aracıları için gereklidir).

Bu güncelleştirmeyle bunların yeni sürümleri kullanılabilir:

  • Azure Stack Hub operatörünün yeni AKS Base görüntülerini damga marketine indirmesi gerekir:

    • AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ocak 2021 (2021.01.28)

    • AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),

    • AKS Temel Windows Görüntüsü (17763.1697.210129)

      Azure Stack Hub Market'e Azure Kubernetes Services (AKS) altyapısı önkoşullarını ekleme başlığı altında yer alan yönergeleri izleyin.

  • Kubernetes küme yöneticisinin (normalde Azure Stack Hub kiracı kullanıcısı) yeni aks-engine'i indirmesi gerekir. Azure Stack Hub'da Linux üzerinde AKS altyapısını yükleme (veya eşdeğer Windows makalesi) başlığı altındaki yönergelere bakın. Kümeyi ilk kez yüklemek için kullandığınız işlemi izleyebilirsiniz. Güncelleştirme, önceki ikili dosyanın üzerine yazar. Örneğin, get-akse.sh betiğini kullandıysanız Bağlı bir ortama yükleme bölümünde açıklanan adımların aynısını izleyin. Windows sistemine yüklüyorsanız aynı işlem geçerlidir: Azure Stack Hub'da AKS altyapısını Windows'a yükleyin.

AKS altyapısı ve Azure Stack sürüm eşlemesi

Azure Stack Hub sürümü AKS altyapı sürümü
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

AKS altyapısı v0.60.1'de Kubernetes sürüm yükseltme yolu

Azure Stack Hub için geçerli sürümü ve yükseltme sürümünü aşağıdaki tabloda bulabilirsiniz. Bu tablo, Azure Stack Hub'daki AKS altyapısı kümesi için geçerlidir. Genel Azure'da ve Azure Stack Hub'da desteklenen sürümleri döndüren aks-engine get-versions komutunu kullanmayın.

Geçerli sürüm Yükseltme var
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

API modeli JSON dosyasında, bölümünün altındaki orchestratorProfile sürüm ve sürüm değerlerini belirtin. Örneğin, Kubernetes 1.17.17'yi dağıtmayı planlıyorsanız, aşağıdaki iki değerin ayarlanması gerekir (örnek kubernetes-azurestack.json bakın):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS altyapısı ve karşılık gelen görüntü eşlemesi

AKS altyapısı AKS temel görüntüsü Kubernetes sürümleri API modeli örnekleri
v0.43.1 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ekim 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Mart 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Mayıs 2020 (2020.05.13), AKS Temel Windows Görüntüsü (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Ağustos 2020 (2020.08.24), AKS Temel Windows Görüntüsü (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı, Eylül 2020 (2020.09.14), AKS Temel Windows Görüntüsü (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, Ocak 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Temel Windows Görüntüsü (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Yenilikler

Özel önizlemeye katılmak istiyorsanız önizleme erişimi isteyebilirsiniz.

Yeni özellikler şunlardır:

  • Ubuntu 18.04'ün Genel Kullanılabilirliği.
  • Sertifika Döndürme Genel Önizleme #4214.
  • T4 Nvidia GPU Özel Önizleme #4259.
  • Azure Active Directory tümleştirmesi özel önizlemesi.
  • Azure Bloblar Özel Önizleme #712 için CSI Sürücüsü.
  • CSI Sürücüsü Azure Diskler Genel Önizleme #712.
  • CSI Sürücüsü NFS Genel Önizleme #712.
  • Kubernetes 1 desteği. 17.17 #4188 ve 1.18.15 #4187.

Bilinen sorunlar

  • Birden çok Kubernetes hizmetini tek bir küme içinde paralel olarak dağıtmak temel yük dengeleyici yapılandırmasında hataya neden olabilir. Tek seferde bir hizmet dağıtmanızı öneririz.
  • Aks-engine aracı Azure ve Azure Stack Hub genelinde paylaşılan bir kaynak kodu deposu olduğundan, birçok sürüm notunu ve çekme isteğini incelemek, aracın daha önce listelenenlerin ötesinde diğer Kubernetes ve işletim sistemi platformlarını desteklediğine inanmanıza neden olabilir. Bunları yoksayabilir ve bu güncelleştirmenin resmi kılavuzu olarak yukarıdaki sürüm tablosunu kullanabilirsiniz.

Başvuru

Aşağıdaki liste, Azure ve Azure Stack Hub için birleştirilmiş sürüm notlarının tamamıdır:

AKS altyapısının v0.55.4 sürümü için geçerlidir.

Bu makalede, Azure Stack Hub güncelleştirmesindeki Azure Kubernetes Service (AKS) altyapısının içeriği açıklanmaktadır. Güncelleştirme, Azure Stack Hub platformunu hedefleyen AKS altyapısının en son sürümüne yönelik iyileştirmeler ve düzeltmeler içerir. Bu makale, genel Azure için AKS altyapısının sürüm bilgilerini belgelemeye yönelik değildir.

Güncelleştirme planlaması

AKS altyapısı upgrade komutu kümenizin yükseltme işlemini tamamen otomatikleştirir ve sanal makineleri (VM), ağ, depolama, Kubernetes ve düzenleme görevlerini işler. Güncelleştirmeyi uygulamadan önce sürüm notu bilgilerini gözden geçirmeyi unutmayın.

Yükseltme hususları

  • AKS altyapısı sürümünüz için doğru market öğesini (AKS Base Ubuntu 16.04-LTS Image Distro) mı kullanıyorsunuz? Sürümleri "Yeni görüntü ve AKS altyapısını indirme" bölümünde bulabilirsiniz.
  • Hedef küme için doğru küme belirtimini (apimodel.json) ve kaynak grubunu kullanıyor musunuz? Kümeyi ilk dağıttığınızda, bu dosya çıkış dizininizde oluşturulmuştur. Kubernetes kümesi dağıtma komut parametrelerine bakın.
  • AKS altyapısını çalıştırmak ve yükseltme işlemlerini gerçekleştirmek için güvenilir bir makine mi kullanıyorsunuz?
  • Etkin iş yükleri olan bir işletimsel kümeyi güncelleştiriyorsanız, kümenin normal yük altında olduğunu varsayarak yükseltmeyi bunları etkilemeden uygulayabilirsiniz. Ancak, kullanıcıları bu kümeye yönlendirmeniz gerekmesi durumunda bir yedekleme kümeniz olmalıdır. Bir yedekleme kümesi kesinlikle önerilir.
  • Mümkünse, ağ atlamalarını ve olası bağlantı hatalarını azaltmak için Azure Stack Hub ortamındaki bir VM'den komutunu çalıştırın.
  • Aboneliğinizin tüm işlem için yeterli kotaya sahip olduğundan emin olun. İşlem sırasında yeni VM'ler ayırır. Sonuçta elde edilen VM sayısı özgün vm ile aynı olur, ancak işlem sırasında birkaç vm daha oluşturulmasını planlayın.
  • Sistem güncelleştirmeleri veya zamanlanmış görevler planlanmıyor.
  • Üretim kümesiyle aynı değerlerle yapılandırılmış bir kümede aşamalı yükseltme ayarlayın ve üretim kümenizde bunu yapmadan önce yükseltmeyi orada test edin.

Upgrade komutunu kullanma

Komutunu Azure Stack Hub'da Kubernetes kümesini yükseltme bölümünde açıklandığı gibi kullanmanız aks-engine upgrade gerekir.

Yükseltme kesintileri

Bazen beklenmeyen faktörler küme yükseltmesini kesintiye uğratır. AKS altyapısı bir hata bildirdiğinde veya AKS altyapısı yürütme işlemine bir şey olduğunda kesinti oluşabilir. Kesintinin nedenini inceleyin, sorunu giderin ve yükseltme işlemine devam etmek için aynı upgrade komutu yeniden gönderin. Komut upgrade bir kez etkilidir ve komutu yeniden gönderdiğinizde küme yükseltmesini sürdürmesi gerekir. Normalde kesintiler güncelleştirmeyi tamamlama süresini artırır ancak tamamlanmasını etkilemez.

Tahmini yükseltme süresi

Tahmini yükseltme süresi, kümedeki VM başına 12 ila 15 dakikadır. Örneğin, 20 düğümlü bir kümenin yükseltlenmesi yaklaşık 5 saat sürebilir.

Yeni görüntü ve AKS altyapısını indirme

AKS temel Ubuntu Görüntüsü ve AKS altyapısının yeni sürümlerini indirin.

Azure Stack Hub'daki AKS altyapısı belgelerinde açıklandığı gibi Kubernetes kümesi dağıtmak için iki ana bileşen gerekir:

  • aks-engine ikili dosyası (gerekli).
  • AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı

Bu görüntülerin yeni sürümleri bu güncelleştirmeyle kullanılabilir:

  • Azure Stack Hub işlecinin damga marketine yeni bir AKS temel Ubuntu görüntüsü indirmesi gerekir:

  • Ad: AKS Base Ubuntu 16.04-LTS Image Distro, Eylül 2020 (2020.09.14)

  • Sürüm: 2020.09.14

    Azure Stack Hub Market'e Azure Kubernetes Services (AKS) altyapısı önkoşullarını ekleme başlığı altında yer alan yönergeleri izleyin.

  • Kubernetes küme yöneticisinin (normalde Azure Stack Hub kiracı kullanıcısı) yeni aks-engine'i indirmesi gerekir. Azure Stack Hub'da Linux üzerinde AKS altyapısını yükleme (veya eşdeğer Windows makalesi) başlığı altındaki yönergelere bakın. Kümeyi ilk kez yüklemek için kullandığınız işlemi izleyebilirsiniz. Güncelleştirme, önceki ikili dosyanın üzerine yazar. Örneğin, get-akse.sh betiğini kullandıysanız Bağlı bir ortama yükleme bölümünde açıklanan adımların aynısını izleyin. Windows sistemine yüklüyorsanız aynı işlem geçerlidir: Azure Stack Hub'da AKS altyapısını Windows'a yükleyin.

AKS altyapısı ve Azure Stack sürüm eşlemesi

Azure Stack Hub sürümü AKS altyapı sürümü
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

AKS altyapısı v0.55.4'te Kubernetes sürüm yükseltme yolu

Azure Stack Hub için geçerli sürümü ve yükseltme sürümünü aşağıdaki tabloda bulabilirsiniz. Bu tablo, Azure Stack Hub'daki AKS altyapısı kümesi için geçerlidir. Genel Azure'da ve Azure Stack Hub'da desteklenen sürümleri döndüren aks-engine get-versions komutunu kullanmayın.

Geçerli sürüm Yükseltme var
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

API modeli JSON dosyasında, bölümünün altındaki orchestratorProfile sürüm ve sürüm değerlerini belirtin. Örneğin, Kubernetes 1.17.17'yi dağıtmayı planlıyorsanız, aşağıdaki iki değerin ayarlanması gerekir (örnek kubernetes-azurestack.json bakın):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

AKS altyapısı ve karşılık gelen görüntü eşlemesi

Kubernetes sürümleri Notlar
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 API modeli örnekleri (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API modeli örnekleri (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API modeli örnekleri (Linux, Windows)

Yenilikler

Bilinen sorunlar

  • Birden çok Kubernetes hizmetini tek bir küme içinde paralel olarak dağıtmak temel yük dengeleyici yapılandırmasında hataya neden olabilir. Tek seferde bir hizmet dağıtmanızı öneririz.
  • aks-engine get-versionsçalıştırdığınızda, çıkış Azure ve Azure Stack Hub için geçerli bilgiler üretir; ancak Azure Stack Hub'a karşılık gelenleri ayırt etmenin açık bir yolu yoktur. Hangi sürümlerin yükseltileceğini belirlemek için bu komutu kullanmayın. Önceki bölümde açıklanan yükseltme başvuru tablosunu kullanın.
  • Aks-engine aracı Azure ve Azure Stack Hub genelinde paylaşılan bir kaynak kodu deposu olduğundan, birçok sürüm notunu ve çekme isteğini incelemek, aracın daha önce listelenenlerin ötesinde diğer Kubernetes ve işletim sistemi platformlarını desteklediğine inanmanıza neden olabilir. Bunları yoksayabilir ve bu güncelleştirmenin resmi kılavuzu olarak yukarıdaki sürüm tablosunu kullanabilirsiniz.

Başvuru

Azure ve Azure Stack Hub için sürüm notlarının tamamı bir araya getirilmiştir:

AKS altyapısının 0.48.0 veya önceki sürümleri için geçerlidir.

Bu makalede, Azure Stack Hub güncelleştirmesindeki Azure Kubernetes Service (AKS) altyapısının içeriği açıklanmaktadır. Güncelleştirme, Azure Stack Hub platformunu hedefleyen AKS altyapısının en son sürümüne yönelik iyileştirmeler ve düzeltmeler içerir. Bu makale, genel Azure için AKS altyapısının sürüm bilgilerini belgelemeye yönelik değildir.

Güncelleştirme planlaması

AKS altyapısı upgrade komutu kümenizin yükseltme işlemini tamamen otomatikleştirir ve sanal makineleri (VM), ağ, depolama, Kubernetes ve düzenleme görevlerini işler. Güncelleştirmeyi uygulamadan önce sürüm notu bilgilerini gözden geçirmeyi unutmayın.

Yükseltme hususları

  • AKS altyapısı sürümünüz için doğru market öğesini (AKS Base Ubuntu 16.04-LTS Image Distro) mı kullanıyorsunuz? Sürümleri yeni AKS temel Ubuntu Görüntüsü ve AKS altyapısı sürümlerini indirme bölümünde bulabilirsiniz.
  • Hedef küme için doğru küme belirtimini (apimodel.json) ve kaynak grubunu kullanıyor musunuz? Kümeyi ilk dağıttığınızda, bu dosya çıkış dizininizde oluşturulmuştur. Kubernetes kümesi dağıtma komut parametrelerine bakın.
  • AKS altyapısını çalıştırmak ve yükseltme işlemlerini gerçekleştirmek için güvenilir bir makine mi kullanıyorsunuz?
  • Etkin iş yükleri olan bir işletimsel kümeyi güncelleştiriyorsanız, kümenin normal yük altında olduğunu varsayarak yükseltmeyi bunları etkilemeden uygulayabilirsiniz. Ancak, kullanıcıları bu kümeye yönlendirmeniz gerekmesi durumunda bir yedekleme kümeniz olmalıdır. Bir yedekleme kümesi kesinlikle önerilir.
  • Mümkünse, ağ atlamalarını ve olası bağlantı hatalarını azaltmak için Azure Stack Hub ortamındaki bir VM'den komutunu çalıştırın.
  • Aboneliğinizin tüm işlem için yeterli kotaya sahip olduğundan emin olun. İşlem sırasında yeni VM'ler ayırır. Sonuçta elde edilen VM sayısı özgün vm ile aynı olur, ancak işlem sırasında birkaç vm daha oluşturulmasını planlayın.
  • Sistem güncelleştirmeleri veya zamanlanmış görevler planlanmıyor.
  • Üretim kümesiyle aynı değerlerle yapılandırılmış bir kümede aşamalı yükseltme ayarlayın ve üretim kümenizde bunu yapmadan önce yükseltmeyi orada test edin.

Upgrade komutunu kullanma

Komutunu Azure Stack Hub'da Kubernetes kümesini yükseltme bölümünde açıklandığı gibi kullanmanız aks-engine upgrade gerekir.

Yükseltme kesintileri

Bazen beklenmeyen faktörler küme yükseltmesini kesintiye uğratır. AKS altyapısı bir hata bildirdiğinde veya AKS altyapısı yürütme işlemine bir şey olduğunda kesinti oluşabilir. Kesintinin nedenini inceleyin, sorunu giderin ve yükseltme işlemine devam etmek için aynı upgrade komutu yeniden gönderin. Komut upgrade bir kez etkilidir ve komutu yeniden gönderdiğinizde küme yükseltmesini sürdürmesi gerekir. Normalde kesintiler güncelleştirmeyi tamamlama süresini artırır ancak tamamlanmasını etkilemez.

Tahmini yükseltme süresi

Tahmini yükseltme süresi, kümedeki VM başına 12 ila 15 dakikadır. Örneğin, 20 düğümlü bir kümenin yükseltlenmesi yaklaşık 5 saat sürebilir.

Yeni görüntü ve AKS altyapısını indirme

AKS temel Ubuntu Görüntüsü ve AKS altyapısının yeni sürümlerini indirin.

Azure Stack Hub'daki AKS altyapısı belgelerinde açıklandığı gibi Kubernetes kümesi dağıtmak için iki ana bileşen gerekir:

  • aks-engine ikili dosyası (gerekli).
  • AKS Base Ubuntu 16.04-LTS Görüntü Dağıtımı.

Bu güncelleştirmeyle bunların yeni sürümleri kullanılabilir:

  • Azure Stack Hub operatörünün yeni AKS Base görüntülerini damga marketine indirmesi gerekir:

    • Ad: AKS Base Ubuntu 16.04-LTS Image Distro, March 2020

    • Sürüm: 2020.03.19

      Azure Stack Hub Market'e Azure Kubernetes Services (AKS) altyapısı önkoşullarını ekleme başlığı altında yer alan yönergeleri izleyin.

  • Kubernetes küme yöneticisinin (normalde Azure Stack Hub kiracı kullanıcısı) yeni aks-engine'i indirmesi gerekir. Azure Stack Hub'da Linux üzerinde AKS altyapısını yükleme (veya eşdeğer Windows makalesi) başlığı altındaki yönergelere bakın. Kümeyi ilk kez yüklemek için kullandığınız işlemi izleyebilirsiniz. Güncelleştirme, önceki ikili dosyanın üzerine yazar. Örneğin, get-akse.sh betiğini kullandıysanız Bağlı bir ortama yükleme bölümünde açıklanan adımların aynısını izleyin. Windows sistemine yüklüyorsanız aynı işlem geçerlidir: Azure Stack Hub'da AKS altyapısını Windows'a yükleyin.

Kubernetes sürüm yükseltme yolu

Azure Stack Hub için geçerli sürümü ve yükseltme sürümünü aşağıdaki tabloda bulabilirsiniz. Bu tablo, Azure Stack Hub'daki AKS altyapısı kümesi için geçerlidir. Genel Azure'da ve Azure Stack Hub'da desteklenen sürümleri döndüren aks-engine get-versions komutunu kullanmayın.

Geçerli sürüm Yükseltme var
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Yenilikler

  • Kubernetes sürüm 1.15.10 (#2834) desteği. Yeni bir küme dağıttığınızda, API model .json dosyanızda (küme tanım dosyası olarak da bilinir) aşağıdaki biçimde hem sürüm numarasını hem de ikincil sürüm numarasını belirtin. Örnek bir küme tanımı dosyası için bkz . kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Not

    API modeli .json dosyasında Kubernetes sürümü açıkça sağlanmazsa, sürüm 1.15 (#2932) kullanılır ve orchestratorVersion varsayılan olarak 1.15.11'dir ve bu da kümenin dağıtımı sırasında hataya neden olur.

  • aks-engine v0.43.1 ile, bulut sağlayıcısının denetim döngüsünü ve diğer görevleri gerçekleştirmesi için varsayılan sıklık ayarları, gelen istekler için Azure Stack Hub Resource Manager eşik sınırlarıyla iyi çalışmaz. Bu güncelleştirme, Azure Stack Hub Resource Manager'a yeniden deneme yükünü azaltmak için Azure Stack Hub varsayılanlarını değiştirir (#2861).

  • aks-engine'deki yeni doğrulama adımı, API modeli .json dosyası Azure Stack Hub tarafından desteklenmeyen özellikler içeriyorsa yürütmenin durdurulmasına veya uyarıların görüntülenmesine neden olur (#2717).

  • Yeni doğrulama iade işlemiyle aks-engine, aks-engine yürütme sürümü için gereken AKS temel görüntüsünün sürümünün kullanılabilirliğini doğrular (#2342). Bu, API modeli .json dosyası ayrıştırıldıktan sonra ve Azure Stack Hub Resource Manager çağrılmadan önce gerçekleşir.

  • Komuttaki upgrade yeni "--control-plane-only" aks-engine seçeneği, kullanıcının işlemleri yalnızca ana Sanal Makineler (#2635) hedefine yükseltmesine olanak tanır.

  • Ubuntu 16.04-LTS için Linux Çekirdeği sürüm 4.15.0-1071-azure güncelleştirmeleri. Ayrıntılar için bkz. "Paket: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]".

  • Kubernetes 1.14.8 ve 1.15.10 sürümlerini desteklemek için yeni hyperkube güncelleştirmeleri.

  • kubectl'yi kümenin Kubernetes sürümüyle eşleşecek şekilde güncelleştirin. Bu bileşen Kubernetes kümesi denetim düzlemi düğümlerinde kullanılabilir, SSH tarafından bir ana düğümde çalıştırabilirsiniz.

  • Azure Container İzleyici eklentisinin en son Şubat 2020 sürümü (#2850) güncelleştirmeleri.

  • sürümü coredns v1.6.6 (#2555) sürümüne yükseltildi.

  • Sürüm 3.3.18'e (#2462) yükseltin.etcd

  • Sürüm 3.0.11'e (#2887) yükseltin.moby

  • Bu sürümle birlikte AKS Altyapısı, görüntülerini oluştururken bağımlılığı şu andan k8s.gcr.io itibaren resmi Kubernetes MCR registry @ mcr.microsoft.com kullanmaya kadar keser (#2722).

Bilinen sorunlar

  • Birden çok Kubernetes hizmetini tek bir küme içinde paralel olarak dağıtmak temel yük dengeleyici yapılandırmasında hataya neden olabilir. Tek seferde bir hizmet dağıtmanızı öneririz.
  • Aks-engine get-versions çalıştırmak Azure ve Azure Stack Hub için geçerli bilgiler üretir; ancak Azure Stack Hub'a karşılık gelenleri ayırt etmenin açık bir yolu yoktur. Hangi sürümlerin yükseltileceğini belirlemek için bu komutu kullanmayın. Önceki bölümde açıklanan yükseltme başvuru tablosunu kullanın.
  • Aks-engine aracı Azure ve Azure Stack Hub genelinde paylaşılan bir kaynak kodu deposu olduğundan, birçok sürüm notunu ve çekme isteğini incelemek, aracın daha önce listelenenlerin ötesinde diğer Kubernetes ve işletim sistemi platformlarını desteklediğine inanmanıza neden olabilir. Bunları yoksayabilir ve bu güncelleştirmenin resmi kılavuzu olarak yukarıdaki sürüm tablosunu kullanabilirsiniz.

Başvuru

Aşağıda, düzeltilen bazı hataların listesi ve sürüm 0.44.0'dan sürüm 0.48.0'a kadar olan sürüm notlarının tamamı listelenmiştir. Sürüm notları hem Azure hem de Azure Stack Hub'ı içerir.

Hata düzeltmeleri

  • userAssignedIdentityId Windows azure.json eksik tırnak işaretleri (#2327)

  • Eklentiler update config yalnızca yükseltme amaçlıdır (#2282)

  • Windows düğümlerinde yönetim IP'sini almak için zaman aşımına uğruyor (#2284)

  • Windows VHD'ye 1.0.28 Azure CNI .zip dosyası ekleme (#2268)

  • Ayar IPAddressCount için varsayılan sırayı düzeltme (#2358)

  • El ile yapılan hataları ve kolay bakımı önlemek için tüm K8s sürümlerinde tek omsagent yaml kullanacak şekilde güncelleştirme (#2692)

Sürüm notları

Azure ve Azure Stack Hub için sürüm notlarının tamamı bir araya getirilmiştir:

Sonraki adımlar

  • Azure Stack Hub'da AKS altyapısı hakkında bilgi edinin