Poznámky k verzi modulu AKS ve službě Azure Stack Hub

Platí pro modul AKS verze v0.73.0.

Tento článek popisuje obsah modulu Azure Kubernetes Service (AKS) v aktualizaci služby Azure Stack Hub. Tato aktualizace zahrnuje vylepšení a opravy pro nejnovější verzi modulu AKS určenou pro platformu Azure Stack Hub. Všimněte si, že cílem není dokumentovat informace o verzi modulu AKS pro globální Azure.

Plánování aktualizací

Příkaz pro upgrade modulu AKS plně automatizuje proces upgradu vašeho clusteru, stará se o virtuální počítače, sítě, úložiště, Kubernetes a úlohy orchestrace. Před instalací aktualizace si nezapomeňte projít informace v poznámce k verzi.

Důležité informace o upgradu

  • Používáte správné položky marketplace, základní imagi AKS s distribucí Ubuntu 18.04 nebo základní windows server AKS pro vaši verzi modulu AKS? Verze najdete v části Stažení nových imagí a modulu AKS.
  • Používáte správnou specifikaci clusteru (apimodel.json) a skupinu prostředků pro cílový cluster? Při původním nasazení clusteru se tento soubor vygeneroval ve výstupním adresáři. Projděte si parametry příkazu Nasazení clusteru Kubernetes.
  • Používáte ke spuštění modulu AKS spolehlivý počítač, ze kterého provádíte operace upgradu?
  • Pokud aktualizujete provozní cluster s aktivními úlohami, můžete upgrade použít, aniž by to mělo vliv na ně, za předpokladu, že cluster je pod normálním zatížením. V případě potřeby přesměrovávat uživatele na něj byste ale měli mít záložní cluster. Důrazně doporučujeme cluster zálohování.
  • Pokud je to možné, spusťte příkaz z virtuálního počítače v prostředí služby Azure Stack Hub, abyste snížili počet směrování sítě a potenciální selhání připojení.
  • Ujistěte se, že vaše předplatné má dostatečnou kvótu pro celý proces. Proces během procesu přiděluje nové virtuální počítače. Výsledný počet virtuálních počítačů by byl stejný jako původní, ale v průběhu tohoto procesu plánujete vytvoření několika dalších virtuálních počítačů.
  • Neplánují se žádné aktualizace systému ani naplánované úlohy.
  • Nastavte fázovaný upgrade na clusteru, který je nakonfigurovaný se stejnými hodnotami jako produkční cluster, a před provedením upgradu v produkčním clusteru ho otestujte.

Použití příkazu k upgradu

Budete muset použít příkaz pro upgrade modulu AKS, jak je popsáno v následujícím článku Upgrade clusteru Kubernetes ve službě Azure Stack Hub.

Přerušení upgradu

Upgrade clusteru někdy přeruší neočekávané faktory. K přerušení může dojít, když modul AKS hlásí chybu nebo se něco stane s procesem provádění modulu AKS. Prozkoumejte příčinu přerušení, vyřešte ho a odešlete znovu stejný příkaz k upgradu, abyste mohli v procesu upgradu pokračovat. Příkaz pro upgrade je idempotentní a po opětovném odeslání příkazu by měl pokračovat v upgradu clusteru. Za normálních okolností se doba potřebná k dokončení aktualizace prodá, ale na dokončení aktualizace by to nemělo mít vliv.

Odhadovaná doba upgradu

Odhadovaný čas je 12 až 15 minut na virtuální počítač v clusteru. Například upgrade clusteru s 20 uzly může trvat přibližně pět (5) hodin.

Pokyny k používání motoru AKS 0.70.0 a vyšší

Microsoft upgradovali poskytovatele azure Cloud Provider ve verzi 0.70.0. Azure Cloud Provider je základní komponenta sdílená mezi AKS Azure a modulem AKS ve službě Azure Stack Hub.

Použití modulu AKS verze 0.70.0 a vyšší:

  • Pokud se pokoušíte vytvořit nový cluster Kubernetes poprvé:
    Použijte ukázkový model rozhraní API, který je k dispozici pro příslušnou verzi v modulu AKS, a odpovídající tabulku mapování obrázků .

  • Pokud vytváříte nový cluster, ale chcete použít stávající model rozhraní API:
    Model rozhraní API můžete upravit podle pokynů pro poskytovatele cloudových služeb pro Azure . Pokud nové nastavení nebudete chtít zahrnout, dojde k chybě nasazení.

  • Pokud používáte svazky úložiště:
    Ujistěte se, že používáte ovladač AzureDiskCSI. Verze 0.70.0 a vyšší podporují pouze ovladače CSI, nikoli staršího poskytovatele úložiště ve stromové struktuře. Pokud chcete upgradovat, postupujte podle pokynů k upgradu při používání svazků úložiště.

Stažení nové image a modulu AKS

Stáhněte si nové verze základní image Ubuntu a modulu AKS AKS.

Jak je vysvětleno v dokumentaci k modulu AKS pro Azure Stack Hub, nasazení clusteru Kubernetes vyžaduje:

  • Binární soubor aks-engine (povinné)
  • Základní image AKS s distribucí Ubuntu 16.04-LTS (zastaralá – už se nepoužívá, změna v modelu rozhraní API tak, aby se místo toho používala verze 18.04)
  • Základní image AKS s distribucí Ubuntu 18.04-LTS (vyžaduje se pro agenty Linuxu)
  • Základní distribuce image AKS s Windows Serverem (vyžadovaná pro agenty Windows)

V této aktualizaci jsou k dispozici nové verze těchto verzí:

Upgrade clusterů Kubernetes vytvořených pomocí distribuce Ubuntu 16.04

Upgrade clusterů Kubernetes vytvořených pomocí distribuce Ubuntu 16.04 Počínaje verzí AKS Engine v0.67.0 není distribuce Ubuntu 16.04 podporovanou možností, protože operační systém dosáhl konce životnosti. Pokud chcete upgradovat cluster, nezapomeňte v modelu vstupního rozhraní API nastavit distribuci operačního systému na aks-ubuntu-18.04 , což je ta, kterou aks-engine deploy vygeneroval a předal jako vstup do aks-engine upgrade.

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

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

Mapování verzí modulu AKS a služby Azure Stack

Verze služby Azure Stack Hub Verze modulu AKS
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
2206 0.70.0, 0.71.0, 0.73.0

Cesta upgradu verze Kubernetes v modulu AKS v0.71.0

Aktuální verzi a verzi upgradu najdete v následující tabulce pro Azure Stack Hub. Nepoužívejte příkaz aks-engine get-versions, protože tento příkaz může zahrnovat také verze podporované v globálním Azure. Následující tabulka verzí a upgradů platí pro cluster modulu AKS ve službě Azure Stack Hub.

Aktuální verze Dostupný upgrade
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 1.21.10
1.21.10 1.22.7
1.22.7 1.23.6
1.22.7, 1.22.15 1.23.13

V souboru JSON modelu rozhraní API zadejte hodnoty verze a verze v části orchestratorProfile, například pokud plánujete nasadit Kubernetes 1.17.17, musí být nastavené následující dvě hodnoty (viz příklad kubernetes-azurestack.json):

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

Modul AKS a mapování odpovídajících obrázků

Modul AKS Základní image AKS Verze Kubernetes Ukázky modelů rozhraní API
v0.43.1 Základní image AKS s distribucí Ubuntu 16.04-LTS, říjen 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, březen 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, květen 2020 (2020.05.13), základní image AKS s Windows (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, srpen 2020 (2020.08.24), základní image AKS s Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Základní image AKS s distribucí Ubuntu 16.04-LTS, září 2020 (2020.09.14), základní image AKS s Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Verze 0.60.1 Základní image AKS s distribucí Ubuntu 16.04-LTS, leden 2021 (2021.01.28),
Základní image AKS s distribucí Ubuntu 18.04-LTS, 1. čtvrtletí 2021 (2021.01.28),
Základní image AKS s Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Základní image AKS s distribucí Ubuntu 18.04-LTS, 2. čtvrtletí 2021 (2021.05.24), základní image AKS s Windows (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Ukázky modelů rozhraní API (Linux, Windows)
v0.67.0 Základní image AKS s distribucí Ubuntu 18.04-LTS, 3. čtvrtletí 2021 (2021.09.27), základní image AKS s Windows (17763.2213.210927) 1.19.15, 1.20.11 Ukázky modelů rozhraní API (Linux, Windows)
v0.67.3 Základní image AKS s distribucí Ubuntu 18.04-LTS, 3. čtvrtletí 2021 (2021.09.27), základní image AKS s Windows (17763.2213.210927) 1.19.15, 1.20.11 Ukázky modelů rozhraní API (Linux, Windows)
v0.70.0 Základní image AKS s distribucí Ubuntu 18.04-LTS, 2. čtvrtletí 2022 (2022.04.07), základní image AKS s Windows (17763.2565.220408) 1.21.10*, 1.22.7* Ukázky modelů rozhraní API (Linux, Windows)
v0.71.0 Základní image AKS s distribucí Ubuntu 18.04-LTS, 3. čtvrtletí 2022 (2022.08.12), základní image AKS s Windows (17763.3232.220805) 1.22.7*, 1.23.6* Ukázky modelů rozhraní API (Linux, Windows)
Verze 0.73.0 Základní image AKS s distribucí Ubuntu 18.04-LTS, 4. čtvrtletí 2022 (2022.11.02), základní image AKS s Windows (17763.3532.221102) 1.22.15*, 1.23.13* Ukázky modelů rozhraní API** (Linux, Windows)

Poznámka

**Existují zprávy , které naznačují, že upgrade na verzi 5.4.0-1095-azure jádra Linuxu může způsobit problémy s containerd. Základní image operačního systému AKS tuto verzi jádra neobsahují. Pokyny k zakázání automatických upgradů, dokud nebude k dispozici oprava, najdete tady.

Poznámka

*Od Kubernetes verze 1.21 se ve službě Azure Stack Hub podporuje pouzeposkytovatel cloudových služeb pro Azure .

Novinky

Obsahuje například tyto nové funkce:

  • Přidání podpory pro Kubernetes v1.22.15 a v1.23.13
  • Další funkce najdete na adrese v0.73.0.

Známé problémy

  • Paralelní nasazení několika služeb Kubernetes v rámci jednoho clusteru může vést k chybě v konfiguraci nástroje pro vyrovnávání zatížení úrovně Basic. V jednu chvíli doporučujeme nasadit jednu službu.
  • Vzhledem k tomu, že nástroj aks-engine je úložištěm zdrojového kódu pro sdílení napříč Azure a službou Azure Stack Hub. Když prozkoumáte mnoho poznámek k verzi a žádostí o přijetí změn, budete se domnívat, že nástroj podporuje i jiné verze Kubernetes a platformy operačního systému nad rámec výše uvedených, ignorujte je a jako oficiálního průvodce pro tuto aktualizaci použijte výše uvedenou tabulku verzí.
  • Modul AKS verze 0.67.0 používá při nasazování clusterů Windows nesprávnou image Windows. Uživatelé by k vyřešení tohoto problému měli použít verzi 0.70.0.

Reference

Toto je kompletní sada poznámek k verzi pro Azure a Azure Stack Hub v kombinaci:

Platí pro modul AKS verze v0.67.0.

Tento článek popisuje obsah modulu Azure Kubernetes Service (AKS) v aktualizaci služby Azure Stack Hub. Tato aktualizace zahrnuje vylepšení a opravy pro nejnovější verzi modulu AKS určenou pro platformu Azure Stack Hub. Všimněte si, že cílem není dokumentovat informace o verzi modulu AKS pro globální Azure.

Plánování aktualizací

Příkaz pro upgrade modulu AKS plně automatizuje proces upgradu vašeho clusteru, stará se o virtuální počítače, sítě, úložiště, Kubernetes a úlohy orchestrace. Před instalací aktualizace si nezapomeňte projít informace v poznámce k verzi.

Důležité informace o upgradu

  • Používáte pro svou verzi modulu AKS správné položky z marketplace, základní distribuci Ubuntu 16.04-LTS nebo image 18.04 nebo základní windows server AKS? Verze najdete v části Stažení nových imagí a modulu AKS.
  • Používáte správnou specifikaci clusteru (apimodel.json) a skupinu prostředků pro cílový cluster? Při původním nasazení clusteru se tento soubor vygeneroval ve výstupním adresáři. Projděte si parametry příkazu Nasazení clusteru Kubernetes.
  • Používáte ke spuštění modulu AKS spolehlivý počítač, ze kterého provádíte operace upgradu?
  • Pokud aktualizujete provozní cluster s aktivními úlohami, můžete upgrade použít, aniž by to mělo vliv na ně, za předpokladu, že cluster je pod normálním zatížením. V případě potřeby přesměrovávat uživatele na něj byste ale měli mít záložní cluster. Důrazně doporučujeme cluster zálohování.
  • Pokud je to možné, spusťte příkaz z virtuálního počítače v prostředí služby Azure Stack Hub, abyste snížili počet směrování sítě a potenciální selhání připojení.
  • Ujistěte se, že vaše předplatné má dostatečnou kvótu pro celý proces. Proces během procesu přiděluje nové virtuální počítače. Výsledný počet virtuálních počítačů by byl stejný jako původní, ale během procesu je potřeba vytvořit několik dalších virtuálních počítačů.
  • Neplánují se žádné aktualizace systému ani naplánované úlohy.
  • Nastavte fázovaný upgrade v clusteru, který je nakonfigurovaný se stejnými hodnotami jako produkční cluster, a otestujte upgrade tam předtím, než to uděláte v produkčním clusteru.

Použití příkazu pro upgrade

Budete muset použít příkaz pro upgrade modulu AKS, jak je popsáno v následujícím článku Upgrade clusteru Kubernetes ve službě Azure Stack Hub.

Přerušení upgradu

Upgrade clusteru někdy přeruší neočekávané faktory. K přerušení může dojít, když modul AKS hlásí chybu nebo se něco stane s procesem provádění modulu AKS. Prozkoumejte příčinu přerušení, vyřešte ji a znovu odešlete stejný příkaz k upgradu, abyste mohli pokračovat v procesu upgradu. Příkaz pro upgrade je idempotentní a po opětovném odeslání příkazu by měl pokračovat v upgradu clusteru. Přerušení obvykle prodlužuje dobu dokončení aktualizace, ale nemělo by to mít vliv na dokončení aktualizace.

Odhadovaná doba upgradu

Odhadovaná doba je 12 až 15 minut na virtuální počítač v clusteru. Například upgrade clusteru s 20 uzly může trvat přibližně pět (5) hodin.

Stažení nové image a modulu AKS

Stáhněte si nové verze základní image Ubuntu a modulu AKS AKS.

Jak je vysvětleno v dokumentaci k modulu AKS pro Azure Stack Hub, nasazení clusteru Kubernetes vyžaduje:

  • Binární soubor aks-engine (povinné)
  • Základní distribuce image AKS Ubuntu 16.04-LTS (zastaralá – už se nepoužívá, změna v modelu rozhraní API na verzi 18.04)
  • Základní distribuce image AKS Ubuntu 18.04-LTS (vyžadováno pro agenty Linuxu)
  • Základní distribuce imagí systému Windows Server AKS (vyžaduje se pro agenty Windows)

V této aktualizaci jsou k dispozici nové verze těchto verzí:

Upgrade clusterů Kubernetes vytvořených pomocí distribuce Ubuntu 16.04

Upgrade clusterů Kubernetes vytvořených pomocí distribuce Ubuntu 16.04 Počínaje verzí AKS Engine v0.67.0 není distribuce Ubuntu 16.04 podporovanou možností, protože operační systém dosáhl konce životnosti. Pokud chcete upgradovat cluster, nezapomeňte ve vstupním modelu rozhraní API nastavit distribuci operačního systému na aks-ubuntu-18.04 hodnotu , kterou aks-engine deploy vygeneroval a předal jako vstup do aks-engine upgrade.

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

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

Modul AKS a mapování verzí služby Azure Stack

Verze služby Azure Stack Hub Verze modulu AKS
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

Cesta upgradu verze Kubernetes v modulu AKS v0.67.0

Aktuální verzi a verzi upgradu najdete v následující tabulce pro Azure Stack Hub. Nepoužívejte příkaz aks-engine get-versions, protože tento příkaz může zahrnovat také verze podporované v globálním Azure. Následující tabulka verzí a upgradů platí pro cluster modulu AKS ve službě Azure Stack Hub.

Aktuální verze Dostupný upgrade
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

V souboru JSON modelu rozhraní API zadejte hodnoty verze a verze v části orchestratorProfile, například pokud plánujete nasadit Kubernetes 1.17.17, musí být nastavené následující dvě hodnoty (viz příklad kubernetes-azurestack.json):

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

Modul AKS a odpovídající mapování obrázků

Modul AKS Základní image AKS Verze Kubernetes Ukázky modelů rozhraní API
v0.43.1 Základní image AKS s distribucí Ubuntu 16.04-LTS, říjen 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, březen 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Základní image AKS Ubuntu 16.04-LTS, květen 2020 (2020.05.13), základní image AKS Windows (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Základní image AKS Ubuntu 16.04-LTS, srpen 2020 (2020.08.24), základní image AKS Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Základní image AKS Ubuntu 16.04-LTS, září 2020 (2020.09.14), základní image AKS Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 Základní image AKS Ubuntu 16.04-LTS, leden 2021 (2021.01.28),
Základní image AKS Ubuntu 18.04-LTS, 1. čtvrtletí 2021 (2021.01.28),
Základní image AKS s Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Základní image AKS Ubuntu 18.04-LTS, 2. čtvrtletí 2021 (2021.05.24), základní image AKS Windows (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Ukázky modelů rozhraní API (Linux, Windows)
v0.67.0 Základní image AKS Ubuntu 18.04-LTS, 3. čtvrtletí 2021 (2021.09.27), základní image AKS Windows (17763.2213.210927) 1.19.15, 1.20.11 Ukázky modelů rozhraní API (Linux, Windows)

Novinky

Pokud máte zájem o účast v privátní verzi Preview, můžete požádat o přístup k verzi Preview.

Obsahuje například tyto nové funkce:

  • Podpora kubernetes 1.19.15 a 1.20.11

Známé problémy

  • Paralelní nasazení několika služeb Kubernetes v jednom clusteru může vést k chybě v konfiguraci základního nástroje pro vyrovnávání zatížení. Doporučujeme nasadit vždy jednu službu.
  • Vzhledem k tomu, že nástroj aks-engine je úložištěm zdrojového kódu pro sdílení napříč Azure a Službou Azure Stack Hub. Prozkoumáním mnoha poznámek k verzi a žádostí o přijetí změn se dozvíte, že nástroj podporuje i jiné verze Kubernetes a platformy operačního systému nad rámec výše uvedených, ignorujte je a jako oficiálního průvodce pro tuto aktualizaci použijte výše uvedenou tabulku verzí.

Reference

Toto je kompletní sada poznámek k verzi pro Azure a Azure Stack Hub v kombinaci:

Platí pro verzi v0.60.1 modulu AKS.

Tento článek popisuje obsah modulu Azure Kubernetes Service (AKS) v aktualizaci služby Azure Stack Hub. Tato aktualizace obsahuje vylepšení a opravy nejnovější verze modulu AKS určeného pro platformu Azure Stack Hub. Všimněte si, že cílem není zdokumentovat informace o vydání modulu AKS pro globální Azure.

Plánování aktualizací

Příkaz pro upgrade modulu AKS plně automatizuje proces upgradu vašeho clusteru, zajišťuje úlohy virtuálních počítačů, sítí, úložiště, Kubernetes a orchestrace. Před instalací aktualizace si nezapomeňte projít informace v poznámce k verzi.

Aspekty upgradu

  • Používáte správné položky marketplace, základní AKS Ubuntu 16.04-LTS nebo Image Distro 18.04 nebo AKS Base Windows Server pro vaši verzi modulu AKS? Verze najdete v části Stažení nových imagí a modulu AKS.
  • Používáte správnou specifikaci clusteru (apimodel.json) a skupinu prostředků pro cílový cluster? Při původním nasazení clusteru se tento soubor vygeneroval ve výstupním adresáři. Viz parametry příkazu nasazení Nasazení clusteru Kubernetes.
  • Používáte ke spuštění modulu AKS spolehlivý počítač, ze kterého provádíte operace upgradu?
  • Pokud aktualizujete provozní cluster s aktivními úlohami, můžete upgrade použít, aniž by to mělo vliv na ně, za předpokladu, že je cluster pod normálním zatížením. V případě potřeby přesměrovávat uživatele na něj byste ale měli mít záložní cluster. Důrazně doporučujeme cluster zálohování.
  • Pokud je to možné, spusťte příkaz z virtuálního počítače v prostředí služby Azure Stack Hub, abyste snížili počet síťových směrování a potenciálních selhání připojení.
  • Ujistěte se, že vaše předplatné má dostatečnou kvótu pro celý proces. Proces během procesu přiděluje nové virtuální počítače. Výsledný počet virtuálních počítačů by byl stejný jako původní, ale během procesu je potřeba vytvořit několik dalších virtuálních počítačů.
  • Neplánují se žádné aktualizace systému ani naplánované úlohy.
  • Nastavte fázovaný upgrade v clusteru, který je nakonfigurovaný se stejnými hodnotami jako produkční cluster, a otestujte upgrade tam předtím, než to uděláte v produkčním clusteru.

Použití příkazu pro upgrade

Budete muset použít příkaz pro upgrade modulu AKS, jak je popsáno v následujícím článku Upgrade clusteru Kubernetes ve službě Azure Stack Hub.

Přerušení upgradu

Upgrade clusteru někdy přeruší neočekávané faktory. K přerušení může dojít, když modul AKS hlásí chybu nebo se něco stane s procesem provádění modulu AKS. Prozkoumejte příčinu přerušení, vyřešte ji a znovu odešlete stejný příkaz k upgradu, abyste mohli pokračovat v procesu upgradu. Příkaz pro upgrade je idempotentní a po opětovném odeslání příkazu by měl pokračovat v upgradu clusteru. Přerušení obvykle prodlužuje dobu dokončení aktualizace, ale nemělo by to mít vliv na dokončení aktualizace.

Odhadovaná doba upgradu

Odhadovaná doba je 12 až 15 minut na virtuální počítač v clusteru. Například upgrade clusteru s 20 uzly může trvat přibližně pět (5) hodin.

Stažení nové image a modulu AKS

Stáhněte si nové verze základní image Ubuntu a modulu AKS AKS.

Jak je vysvětleno v dokumentaci k modulu AKS pro Azure Stack Hub, nasazení clusteru Kubernetes vyžaduje:

  • Binární soubor aks-engine (povinné)
  • Základní distribuce image AKS Ubuntu 16.04-LTS (povinné)
  • Základní distribuce image AKS Ubuntu 18.04-LTS (volitelné)
  • Základní distribuce imagí systému Windows Server AKS (volitelné)

V této aktualizaci jsou k dispozici nové verze těchto verzí:

Modul AKS a mapování verzí služby Azure Stack

Verze služby Azure Stack Hub Verze modulu AKS
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

Cesta upgradu verze Kubernetes v modulu AKS verze 0.60.1

Aktuální verzi a verzi upgradu najdete v následující tabulce pro Azure Stack Hub. Nepoužívejte příkaz aks-engine get-versions, protože tento příkaz může zahrnovat také verze podporované v globálním Azure. Následující tabulka verzí a upgradů platí pro cluster modulu AKS ve službě Azure Stack Hub.

Aktuální verze Dostupný upgrade
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

V souboru JSON modelu rozhraní API zadejte hodnoty verze a verze v části orchestratorProfile, například pokud plánujete nasadit Kubernetes 1.17.17, musí být nastavené následující dvě hodnoty (viz příklad kubernetes-azurestack.json):

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

Modul AKS a odpovídající mapování obrázků

Modul AKS Základní image AKS Verze Kubernetes Ukázky modelů rozhraní API
v0.43.1 Základní image AKS s distribucí Ubuntu 16.04-LTS, říjen 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, březen 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, květen 2020 (2020.05.13), základní image AKS s Windows (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Základní image AKS s distribucí Ubuntu 16.04-LTS, srpen 2020 (2020.08.24), základní image AKS s Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Základní image AKS s distribucí Ubuntu 16.04-LTS, září 2020 (2020.09.14), základní image AKS s Windows (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
Verze 0.60.1 Základní image AKS s distribucí Ubuntu 16.04-LTS, leden 2021 (2021.01.28),
Základní image AKS s distribucí Ubuntu 18.04-LTS, 1. čtvrtletí 2021 (2021.01.28),
Základní image AKS s Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Novinky

Pokud máte zájem o účast v privátní verzi Preview, můžete požádat o přístup k verzi Preview.

Obsahuje například tyto nové funkce:

  • Obecná dostupnost Ubuntu 18.04
  • Obměně certifikátů ve verzi Public Preview #4214
  • T4 Nvidia GPU Private Preview #4259
  • Integrace Azure Active Directory ve verzi Private Preview
  • Ovladač CSI pro privátní verzi Preview objektů blob Azure #712
  • Disky Azure Ve verzi Public Preview #712 ovladače CSI
  • Ovladač CSI NFS Public Preview #712
  • Podpora kubernetes 1 17.17 #4188 a 1.18.15 #4187

Známé problémy

  • Paralelní nasazení několika služeb Kubernetes v rámci jednoho clusteru může vést k chybě v konfiguraci nástroje pro vyrovnávání zatížení úrovně Basic. V jednu chvíli doporučujeme nasadit jednu službu.
  • Vzhledem k tomu, že nástroj aks-engine je úložištěm zdrojového kódu pro sdílení napříč Azure a službou Azure Stack Hub. Když prozkoumáte mnoho poznámek k verzi a žádostí o přijetí změn, budete se domnívat, že nástroj podporuje i jiné verze Kubernetes a platformy operačního systému nad rámec výše uvedených, ignorujte je a jako oficiálního průvodce pro tuto aktualizaci použijte výše uvedenou tabulku verzí.

Reference

Toto je kompletní sada poznámek k verzi pro Azure a Azure Stack Hub v kombinaci:

Platí pro modul AKS verze v0.55.4.

Tento článek popisuje obsah modulu Azure Kubernetes Service (AKS) v aktualizaci služby Azure Stack Hub. Tato aktualizace zahrnuje vylepšení a opravy pro nejnovější verzi modulu AKS určenou pro platformu Azure Stack Hub. Všimněte si, že cílem není dokumentovat informace o verzi modulu AKS pro globální Azure.

Plánování aktualizací

Příkaz pro upgrade modulu AKS plně automatizuje proces upgradu vašeho clusteru, stará se o virtuální počítače, sítě, úložiště, Kubernetes a úlohy orchestrace. Před instalací aktualizace si nezapomeňte projít informace v poznámce k verzi.

Důležité informace o upgradu

  • Používáte správnou položku marketplace, základní image AKS Ubuntu 16.04-LTS, pro svou verzi modulu AKS? Verze najdete v části Stažení nové image a modulu AKS.

  • Používáte správnou specifikaci clusteru (apimodel.json) a skupinu prostředků pro cílový cluster? Při původním nasazení clusteru se tento soubor vygeneroval ve výstupním adresáři. deploy Viz parametry příkazu Nasazení clusteru Kubernetes.

  • Používáte ke spuštění modulu AKS spolehlivý počítač, ze kterého provádíte operace upgradu?

  • Pokud aktualizujete provozní cluster s aktivními úlohami, můžete upgrade použít, aniž by to mělo vliv na ně, za předpokladu, že cluster je pod normálním zatížením. V případě potřeby přesměrovávat uživatele na něj byste ale měli mít záložní cluster. Důrazně doporučujeme cluster zálohování.

  • Pokud je to možné, spusťte příkaz z virtuálního počítače v prostředí služby Azure Stack Hub, abyste snížili počet směrování sítě a potenciální selhání připojení.

  • Ujistěte se, že vaše předplatné má dostatečnou kvótu pro celý proces. Proces během procesu přiděluje nové virtuální počítače. Výsledný počet virtuálních počítačů by byl stejný jako původní, ale v průběhu tohoto procesu plánujete vytvoření několika dalších virtuálních počítačů.

  • Neplánují se žádné aktualizace systému ani naplánované úlohy.

  • Nastavte fázovaný upgrade na clusteru, který je nakonfigurovaný se stejnými hodnotami jako produkční cluster, a před provedením upgradu v produkčním clusteru ho otestujte.

Použití příkazu k upgradu

Budete muset použít příkaz modulu upgrade AKS, jak je popsáno v následujícím článku Upgrade clusteru Kubernetes ve službě Azure Stack Hub.

Přerušení upgradu

Upgrade clusteru někdy přeruší neočekávané faktory. K přerušení může dojít, když modul AKS hlásí chybu nebo se něco stane s procesem provádění modulu AKS. Prozkoumejte příčinu přerušení, vyřešte ho a odešlete znovu stejný příkaz k upgradu, abyste mohli v procesu upgradu pokračovat. Příkaz pro upgrade je idempotentní a po opětovném odeslání příkazu by měl pokračovat v upgradu clusteru. Za normálních okolností se doba potřebná k dokončení aktualizace prodá, ale na dokončení aktualizace by to nemělo mít vliv.

Odhadovaná doba upgradu

Odhadovaný čas je 12 až 15 minut na virtuální počítač v clusteru. Například upgrade clusteru s 20 uzly může trvat přibližně pět (5) hodin.

Stažení nové image a modulu AKS

Stáhněte si nové verze základní image Ubuntu a modulu AKS AKS.

Jak je vysvětleno v dokumentaci k modulu AKS pro Azure Stack Hub, nasazení clusteru Kubernetes vyžaduje dvě hlavní komponenty:

  • Binární soubor aks-engine

  • Základní image AKS s distribucí Ubuntu 16.04-LTS

V této aktualizaci jsou k dispozici nové verze těchto verzí:

Mapování verzí modulu AKS a služby Azure Stack

Verze služby Azure Stack Hub Verze modulu AKS
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

Cesta upgradu verze Kubernetes v modulu AKS verze 0.55.4

Aktuální verzi a verzi upgradu najdete v následující tabulce pro Azure Stack Hub. Nepoužívejte příkaz aks-engine get-versions, protože tento příkaz může zahrnovat také verze podporované v globálním Azure. Následující tabulka verzí a upgradů platí pro cluster modulu AKS ve službě Azure Stack Hub.

Aktuální verze Dostupný upgrade
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

V souboru JSON modelu rozhraní API zadejte hodnoty verze a verze v orchestratorProfile části. Pokud například plánujete nasadit Kubernetes 1.16.14, musí být nastavené následující dvě hodnoty (viz příklad kubernetes-azurestack.json):

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

Modul AKS a odpovídající mapování obrázků

Verze Kubernetes Poznámky
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 Ukázky modelů rozhraní API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Ukázky modelů rozhraní API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Ukázky modelů rozhraní API (Linux, Windows)

Novinky

  • Aktualizace virtuálního pevného disku s Linuxem ve službě Azure Stack na verzi 2020.09.14 #3828
  • Přidává podporu pro K8s v1.17.11 ve službě Azure Stack #3702.
  • Přidává podporu pro K8s v1.16.14 ve službě Azure Stack #3704.
  • Aktualizace virtuálního pevného disku s Linuxem na verzi 2020.09.14 #3750
  • Aktualizace virtuálního pevného disku Windows na srpen č. 3730
  • Upgraduje kubernetes metrics-server na v0.3.7 #3669.
  • Upgraduje verzi Dockeru a opraví problém s obměnou protokolu #3693.
  • Upgraduje CoreDNS na verzi 1.7.0 #3608.
  • Použití balíčků moby 19.03.x #3549
  • Opravy strategie aktualizace azure-cni #3571

Známé problémy

  • Paralelní nasazení několika služeb Kubernetes v jednom clusteru může vést k chybě v konfiguraci základního nástroje pro vyrovnávání zatížení. Pokud je to možné, nasazuje se současně jedna služba.
  • Spuštění aks-engine get-versions vytvoří informace použitelné pro Azure a Azure Stack Hub, ale neexistuje explicitní způsob, jak rozpoznat, co odpovídá službě Azure Stack Hub. Tento příkaz nepoužívejte k určení verzí, které jsou k dispozici pro upgrade. Použijte referenční tabulku upgradu popsanou výše.
  • Vzhledem k tomu, že nástroj aks-engine je úložiště zdrojového kódu pro sdílení napříč Azure a službou Azure Stack Hub. Prozkoumáním mnoha poznámek k verzi a žádostí o přijetí změn se dozvíte, že nástroj podporuje i jiné verze Kubernetes a platformy operačního systému nad rámec výše uvedených, ignorujte je a jako oficiálního průvodce pro tuto aktualizaci použijte výše uvedenou tabulku verzí.

Reference

Toto je kompletní sada poznámek k verzi pro Azure a Azure Stack Hub v kombinaci:

Platí pro modul AKS verze 0.48.0 nebo starší.

Tento článek popisuje obsah modulu Azure Kubernetes Service (AKS) v aktualizaci služby Azure Stack Hub. Tato aktualizace obsahuje vylepšení a opravy nejnovější verze modulu AKS určeného pro platformu Azure Stack Hub. Všimněte si, že cílem není zdokumentovat informace o vydání modulu AKS pro globální Azure.

Plánování aktualizací

Příkaz pro upgrade modulu AKS plně automatizuje proces upgradu vašeho clusteru, zajišťuje úlohy virtuálních počítačů, sítí, úložiště, Kubernetes a orchestrace. Před instalací aktualizace si nezapomeňte projít informace v tomto článku.

Aspekty upgradu

  • Používáte správnou položku marketplace, základní image AKS Ubuntu 16.04-LTS, pro vaši verzi modulu AKS? Verze najdete v části Stažení nové základní image Ubuntu a verzí modulu AKS AKS.

  • Používáte správnou specifikaci clusteru (apimodel.json) a skupinu prostředků pro cílový cluster? Při původním nasazení clusteru se tento soubor vygeneroval ve výstupním adresáři. Viz parametry příkazu "deploy" Nasazení clusteru Kubernetes.

  • Používáte ke spuštění modulu AKS spolehlivý počítač, ze kterého provádíte operace upgradu?

  • Pokud aktualizujete provozní cluster s aktivními úlohami, můžete upgrade použít, aniž by to mělo vliv na ně, za předpokladu, že je cluster pod normálním zatížením. V případě potřeby přesměrovávat uživatele na něj byste ale měli mít záložní cluster.

  • Pokud je to možné, spusťte příkaz z virtuálního počítače v prostředí služby Azure Stack Hub, abyste snížili počet síťových směrování a potenciálních selhání připojení.

  • Ujistěte se, že vaše předplatné má dostatečnou kvótu pro celý proces. Proces během procesu přiděluje nové virtuální počítače. Výsledný počet virtuálních počítačů by byl stejný jako původní, ale během procesu je potřeba vytvořit několik dalších virtuálních počítačů.

  • Neplánují se žádné aktualizace systému ani naplánované úlohy.

  • Nastavte fázovaný upgrade v clusteru, který je nakonfigurovaný se stejnými hodnotami jako produkční cluster, a otestujte upgrade tam předtím, než to uděláte v produkčním clusteru.

Použití příkazu pro upgrade

Budete muset použít příkaz upgrade modulu AKS, jak je popsáno v následujícím článku Upgrade clusteru Kubernetes ve službě Azure Stack Hub.

Přerušení upgradu

Upgrade clusteru někdy přeruší neočekávané faktory. K přerušení může dojít, když modul AKS hlásí chybu nebo se něco stane s procesem provádění modulu AKS. Prozkoumejte příčinu přerušení, vyřešte ji a znovu odešlete stejný příkaz k upgradu, abyste mohli pokračovat v procesu upgradu. Příkaz pro upgrade je idempotentní a po opětovném odeslání příkazu by měl pokračovat v upgradu clusteru. Přerušení obvykle prodlužuje dobu dokončení aktualizace, ale nemělo by to mít vliv na dokončení aktualizace.

Odhadovaná doba upgradu

Odhadovaná doba je 12 až 15 minut na virtuální počítač v clusteru. Například upgrade clusteru s 20 uzly může trvat přibližně pět (5) hodin.

Stažení nové image a modulu AKS

Stáhněte si nové verze základní image Ubuntu a modulu AKS AKS.

Jak je vysvětleno v dokumentaci k modulu AKS pro Azure Stack Hub, nasazení clusteru Kubernetes vyžaduje dvě hlavní komponenty:

  • Binární soubor aks-engine
  • Základní image AKS – distribuce Ubuntu 16.04-LTS

V této aktualizaci jsou k dispozici nové verze těchto verzí:

Cesta upgradu verze Kubernetes

Aktuální verzi a verzi upgradu najdete v následující tabulce pro Azure Stack Hub. Neřiďte se příkazem aks-engine get-versions , protože příkaz obsahuje také verze podporované v globálním Azure. Následující tabulka verzí a upgradů platí pro cluster modulu AKS ve službě Azure Stack Hub.

Aktuální verze Dostupný upgrade
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Novinky

  • Podpora kubernetes verze 1.15.10 (#2834). Při nasazování nového clusteru nezapomeňte v souboru JSON modelu rozhraní API (tj. definiční soubor clusteru) zadat číslo verze vydané verze a číslo podverze. Můžete najít příklad: kubernetes-azurestack.json:

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Poznámka

    Pokud v souboru JSON modelu rozhraní API není explicitně uvedená verze Kubernetes, použije se verze 1.15 (#2932) a orchestratorVersion se nastaví jako 1.15.11 výchozí, což způsobí chybu během nasazování clusteru.

  • S aks-engine v0.43.1 výchozí nastavení frekvence pro poskytovatele cloudu pro provádění řídicí smyčky a dalších úloh nefunguje dobře se službou Azure Stack Hub Resource Manager prahových limitů pro příchozí požadavky. Tato aktualizace mění výchozí nastavení služby Azure Stack Hub, aby se omezilo opakované zatížení do služby Azure Stack Hub Resource Manager (#2861).

  • Nový krok ověření v aks-engine způsobí zastavení provádění nebo zobrazení upozornění, pokud soubor JSON modelu rozhraní API obsahuje vlastnosti, které Azure Stack Hub nepodporuje (#2717).

  • Po novém ověření ověří modul aks-engine dostupnost verze základní image AKS, která je potřebná pro spuštění verze aks-engine (#2342). K tomu dojde po analýze souboru modelu rozhraní API a před voláním služby Azure Stack Hub Resource Manager.

  • Nová možnost aks-engine "--control-plane-only" v příkazu "upgrade" umožňuje uživateli upgradovat operace tak, aby cílily pouze na hlavní Virtual Machines (#2635).

  • Aktualizace na linuxové jádro verze 4.15.0-1071-azure pro Ubuntu 16.04-LTS. Podrobnosti najdete v tématu Balíček: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security].

  • Nové aktualizace hyperkube pro podporu Kubernetes verze 1.14.8 a 1.15.10.

  • Aktualizujte kubectl tak, aby odpovídal verzi Kubernetes pro cluster. Tato komponenta je k dispozici v uzlech řídicí roviny clusteru Kubernetes. Můžete ji spustit přes SSH do hlavního serveru.

  • Aktualizace pro doplněk Azure Container Monitor s nejnovější verzí z února 2020 (č. 2850).

  • Upgrade na coredns verzi v1.6.6 (č. 2555).

  • Upgradujte etcd na verzi 3.3.18 (#2462).

  • Upgradujte moby na verzi 3.0.11 (#2887).

  • V této verzi modul AKS vyřežuje závislost od k8s.gcr.io teď při sestavování imagí oficiální Kubernetes MCR registry @ mcr.microsoft.com (#2722).

Známé problémy

  • Paralelní nasazení několika služeb Kubernetes v rámci jednoho clusteru může vést k chybě v konfiguraci nástroje pro vyrovnávání zatížení úrovně Basic. Pokud je to možné, nasazuje se současně jedna služba.

  • Spuštění aks-engine get-versions vytvoří informace použitelné pro Azure a Azure Stack Hub, ale neexistuje explicitní způsob, jak rozlišit, co odpovídá službě Azure Stack Hub. Nepoužívejte tento příkaz ke zjištění, které verze oblasti jsou k dispozici pro upgrade. Použijte referenční tabulku upgradu popsanou výše.

  • Vzhledem k tomu, že nástroj aks-engine je úložištěm zdrojového kódu pro sdílení napříč Azure a službou Azure Stack Hub. Prozkoumání mnoha poznámek k verzi a žádostí o přijetí změn vás povede k přesvědčení, že nástroj podporuje i jiné verze Kubernetes a platformy operačního systému nad rámec výše uvedených. Ignorujte je a jako oficiálního průvodce pro tuto aktualizaci použijte výše uvedenou tabulku verzí.

Reference

Následuje seznam některých opravených chyb a kompletní sady poznámek k verzi od 0.44.0 do 0.48.0. Všimněte si, že druhý seznam bude obsahovat položky Azure a Azure Stack Hub.

Opravy chyb

  • userAssignedIdentityId ve windows azure.json chybí uvozovky (#2327)

  • Doplňky update config jsou jenom upgradované (#2282)

  • Vypršení časového limitu pro získání IP adresy správy v uzlech Windows (#2284)

  • Přidání souboru zip 1.0.28 Azure CNI do virtuálního pevného disku s Windows (#2268)

  • Správné výchozí pořadí pro nastavení IPAddressCount (#2358)

  • Aktualizace tak, aby se pro všechny verze K8s používal jeden yaml omsagent, abyste se vyhnuli jakýmkoli ručním chybám a snadné údržbě (#2692)

Poznámky k verzi

Toto je kompletní sada poznámek k verzi pro Azure a Azure Stack Hub v kombinaci.

Další kroky