Aktualizace imagí Kubernetes a uzlů napříč několika clustery pomocí Azure Kubernetes Fleet Manageru

Správci platforem spravující velký počet clusterů často mají problémy s přípravou aktualizací více clusterů (například upgrade image operačního systému uzlu nebo verzí Kubernetes) bezpečným a předvídatelným způsobem. K vyřešení tohoto úkolu vám Azure Kubernetes Fleet Manager (Fleet) umožňuje orchestrovat aktualizace napříč několika clustery pomocí spuštění aktualizací.

Spuštění aktualizací se skládají z fází, skupin a strategií a dají se použít ručně pro jednorázové aktualizace nebo automaticky pro průběžné pravidelné aktualizace pomocí profilů automatického upgradu. Všechna spuštění aktualizací (ručně nebo automatizovaná) dodržují časové intervaly údržby členských clusterů.

Tato příručka popisuje, jak nakonfigurovat a ručně spustit spuštění aktualizací.

Požadavky

• Přečtěte si koncepční přehled této funkce, která poskytuje vysvětlení strategií aktualizací, spuštění, fází a skupin, na které se odkazuje v této příručce.

• Musíte mít prostředek Fleet s jedním nebo více členy clusteru. Pokud ne, postupujte podle tohoto rychlého startu a vytvořte prostředek Fleet a připojte se ke clusterům Azure Kubernetes Service (AKS) jako členové.

• Nastavte následující proměnné prostředí:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export AKS_CLUSTER_ID=<aks-cluster-resource-id>
  

• Pokud budete postupovat podle pokynů Azure CLI v tomto článku, potřebujete nainstalovat Azure CLI verze 2.58.0 nebo novější. Pokud chcete nainstalovat nebo upgradovat, přečtěte si téma Instalace Azure CLI.

• Potřebujete fleet také rozšíření Azure CLI, které můžete nainstalovat spuštěním následujícího příkazu:

  az extension add --name fleet
  

  Spuštěním az extension update příkazu aktualizujte nejnovější verzi vydaného rozšíření:

  az extension update --name fleet
  

Vytváření spuštění aktualizací

Spuštění aktualizace podporuje dvě možnosti pro sekvenci upgradu clusteru:

• Jeden po druhém: Pokud vás nezajímá řízení pořadí upgradu clusteru, one-by-one poskytuje jednoduchý přístup k upgradu všech členských clusterů flotily postupně po jednom.
• Řízení posloupnosti clusterů pomocí skupin aktualizací a fází: Pokud chcete řídit pořadí upgradu clusteru, můžete členové clustery strukturovat ve skupinách aktualizací a fázích aktualizace. Tuto sekvenci můžete uložit jako šablonu ve formě strategie aktualizace. Spuštění aktualizací můžete později vytvořit pomocí strategií aktualizace místo definování posloupnosti pokaždé, když potřebujete vytvořit spuštění aktualizace.

Poznámka:

Spuštění aktualizací dodržují časová období plánované údržby, která jste nastavili na úrovni clusteru AKS. Další informace najdete v tématu Plánovaná údržba napříč několika členskými clustery, které vysvětlují, jak spuštění aktualizací zpracovávají členské clustery nakonfigurované s časovými obdobími plánované údržby.

Aktualizace všech clusterů o jeden po druhém

Azure Portal

1. Na webu Azure Portal přejděte k prostředku Azure Kubernetes Fleet Manager.

2. V nabídce služby v části Nastavení vyberte Možnost Vytvořit spuštění pro více>clusterů.

3. Zadejte název spuštění aktualizace a potom vyberte jeden po druhém pro typ upgradu.

   

4. Pro obor upgradu vyberte jednu z následujících možností:

   • Verze Kubernetes pro řídicí rovinu i fondy uzlů
   • Verze Kubernetes pouze pro řídicí rovinu clusteru
   • Pouze verze image uzlu

5. Vyberte jednu z následujících možností pro image Node:

   • Nejnovější image: Aktualizuje každý cluster AKS v aktualizaci na nejnovější image dostupnou pro tento cluster v jeho oblasti.
   • Konzistentní image: Jak je možné, aby spuštění aktualizace mělo clustery AKS ve více oblastech, kde se můžou lišit nejnovější dostupné image uzlů (další informace najdete v nástroji sledování verzí). Spuštění aktualizace vybere nejnovější společnou image ve všech těchto oblastech, aby se dosáhlo konzistence.

   

6. Výběrem možnosti Vytvořit vytvořte spuštění aktualizace.

Azure CLI

1. Vytvořte spuštění aktualizace pomocí az fleet updaterun create příkazu s vybranými hodnotami pro příznaky --upgrade-type a --node-image-selection příznaky. Následující příkaz vytvoří spuštění aktualizace, která upgraduje verzi Kubernetes pro fondy řídicí roviny i fondů uzlů a používá nejnovější image uzlu dostupnou pro každý cluster v její oblasti.

   Příznak --upgrade-type podporuje následující hodnoty:

   • Full upgraduje verzi Kubernetes pro řídicí rovinu a fondy uzlů spolu s imagemi uzlů.
   • ControlPlaneOnly Upgraduje pouze verzi Kubernetes pro řídicí rovinu clusteru.
   • NodeImageOnly upgraduje pouze image uzlů.

   Příznak --node-image-selection podporuje následující hodnoty:

   • Latest: Aktualizuje každý cluster AKS v aktualizaci na nejnovější image dostupnou pro tento cluster v její oblasti.
   • Consistent: Jak je možné, aby spuštění aktualizace mělo clustery AKS ve více oblastech, kde se můžou lišit nejnovější dostupné image uzlů (další informace najdete v nástroji sledování vydaných verzí). Spuštění aktualizace vybere nejnovější společnou image ve všech těchto oblastech, aby se dosáhlo konzistence.

   az fleet updaterun create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1 \
    --upgrade-type Full \
    --kubernetes-version 1.26.0 \
    --node-image-selection Latest
   

2. Spusťte spuštění aktualizace pomocí az fleet updaterun start příkazu.

   az fleet updaterun start \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1
   

Při vytváření aktualizačního spuštění máte možnost řídit rozsah spuštění aktualizace. Příznak --upgrade-type podporuje následující hodnoty:

• ControlPlaneOnly Upgraduje pouze verzi Kubernetes pro řídicí rovinu clusteru.
• Full upgraduje verzi Kubernetes pro řídicí rovinu a fondy uzlů spolu s imagemi uzlů.
• NodeImageOnly upgraduje pouze image uzlů.

--node-image-selection Příznak také podporuje následující hodnoty:

• Nejnovější: Aktualizuje každý cluster AKS v aktualizaci na nejnovější image dostupnou pro tento cluster v jeho oblasti.
• Konzistentní: Vzhledem k tomu, že spuštění aktualizací může mít clustery AKS napříč několika oblastmi, kde se můžou lišit nejnovější dostupné image uzlů (další informace najdete v nástroji sledování vydaných verzí). Spuštění aktualizace vybere nejnovější společnou image ve všech těchto oblastech, aby se dosáhlo konzistence.

Spuštění aktualizace:

Spuštění aktualizací spustíte spuštěním následujícího příkazu:

az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name>

Aktualizace clusterů pomocí skupin a fází

Spuštění aktualizace můžete definovat pomocí fází aktualizace a postupně uspořádat aplikace aktualizací do různých skupin aktualizací. Například první fáze aktualizace může aktualizovat členské clustery testovacího prostředí a druhá fáze aktualizace pak aktualizuje členské clustery produkčního prostředí. Můžete také zadat dobu čekání mezi fázemi aktualizace. Tuto sekvenci můžete uložit jako šablonu ve formě strategie aktualizace.

Azure Portal

1. Na webu Azure Portal přejděte k prostředku Azure Kubernetes Fleet Manager.

2. V nabídce služby v části Nastavení vyberte Možnost Vytvořit spuštění pro více>clusterů.

3. Zadejte název spuštění aktualizace a pak vyberte Dílčí fáze pro typ sekvence aktualizace.

   

4. Vyberte Vytvořit fázi a zadejte název fáze a dobu čekání mezi fázemi.

   

5. Vyberte skupiny aktualizací, které chcete zahrnout do této fáze. Pokud je chcete aktualizovat v určité sekvenci, můžete také určit pořadí skupin aktualizací. Až budete hotovi, vyberte Vytvořit.

   

6. Pro obor upgradu vyberte jednu z následujících možností:

   • Verze Kubernetes pro řídicí rovinu i fondy uzlů
   • Verze Kubernetes pouze pro řídicí rovinu clusteru
   • Pouze verze image uzlu

7. Vyberte jednu z následujících možností pro image Node:

   • Nejnovější image: Aktualizuje každý cluster AKS v aktualizaci na nejnovější image dostupnou pro tento cluster v jeho oblasti.
   • Konzistentní image: Jak je možné, aby spuštění aktualizace mělo clustery AKS ve více oblastech, kde se můžou lišit nejnovější dostupné image uzlů (další informace najdete v nástroji sledování verzí). Spuštění aktualizace vybere nejnovější společnou image ve všech těchto oblastech, aby se dosáhlo konzistence.

   

8. Výběrem možnosti Vytvořit vytvořte spuštění aktualizace.

   Zadávání fází a jejich pořadí při každém vytváření aktualizačního spuštění může být opakované a těžkopádné. Strategie aktualizace zjednodušují tento proces tím, že umožňují ukládat šablony pro spuštění aktualizací. Další informace najdete v tématu vytváření a používání strategie aktualizace.

9. V nabídce Aktualizace s více clustery vyberte spuštění aktualizace a pak vyberte Spustit.

Azure CLI

1. Vytvořte soubor JSON pro definování fází a skupin pro spuštění aktualizace. Tady je příklad vstupu ze souboru fází (example-stages.json):

   {
       "stages": [
           {
               "name": "stage1",
               "groups": [
                   {
                       "name": "group-1a"
                   },
                   {
                       "name": "group-1b"
                   },
                   {
                       "name": "group-1c"
                   }
               ],
               "afterStageWaitInSeconds": 3600
           },
           {
               "name": "stage2",
               "groups": [
                   {
                       "name": "group-2a"
                   },
                   {
                       "name": "group-2b"
                   },
                   {
                       "name": "group-2c"
                   }
               ]
           }
       ]
   }
   

2. Vytvořte spuštění aktualizace pomocí az fleet updaterun create příkazu s příznakem --stages nastaveným na název souboru JSON a zvolenými hodnotami pro objekty --upgrade-type a --node-image-selection příznaky. Následující příkaz vytvoří spuštění aktualizace, která upgraduje verzi Kubernetes pro fondy řídicí roviny i fondů uzlů a používá nejnovější image uzlu dostupnou pro každý cluster v její oblasti.

   Příznak --upgrade-type podporuje následující hodnoty:

   • Full upgraduje verzi Kubernetes pro řídicí rovinu a fondy uzlů spolu s imagemi uzlů.
   • ControlPlaneOnly Upgraduje pouze verzi Kubernetes pro řídicí rovinu clusteru.
   • NodeImageOnly upgraduje pouze image uzlů.

   Příznak --node-image-selection podporuje následující hodnoty:

   • Latest: Aktualizuje každý cluster AKS v aktualizaci na nejnovější image dostupnou pro tento cluster v její oblasti.
   • Consistent: Jak je možné, aby spuštění aktualizace mělo clustery AKS ve více oblastech, kde se můžou lišit nejnovější dostupné image uzlů (další informace najdete v nástroji sledování vydaných verzí). Spuštění aktualizace vybere nejnovější společnou image ve všech těchto oblastech, aby se dosáhlo konzistence.

   az fleet updaterun create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1 \
    --upgrade-type Full \
    --kubernetes-version 1.26.0 \
    --node-image-selection Latest \
    --stages example-stages.json
   

3. Spusťte spuštění aktualizace pomocí az fleet updaterun start příkazu.

   az fleet updaterun start \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1
   

Vytvoření aktualizačního spuštění pomocí strategií aktualizací

Vytvoření aktualizačního spuštění vyžaduje, abyste pokaždé zadali fáze, skupiny a pořadí. Strategie aktualizace zjednodušují tento proces tím, že umožňují ukládat šablony pro spuštění aktualizací.

Poznámka:

Je možné vytvořit více spuštění aktualizací s jedinečnými názvy ze stejné strategie aktualizace.

Strategii aktualizace můžete vytvořit pomocí jedné z následujících metod:

• Vytvořte novou strategii aktualizace a při vytváření spuštění aktualizace ji pak na ni odkazujte.
• Uložte strategii aktualizace při vytváření aktualizačního spuštění pomocí webu Azure Portal.

Uložení strategie aktualizace při vytváření spuštění aktualizace

• Uložte strategii aktualizace při vytváření aktualizačního spuštění na webu Azure Portal:

  

Správa spuštění aktualizace

Následující části vysvětlují, jak spravovat spuštění aktualizace pomocí webu Azure Portal a Azure CLI.

Azure Portal

• Na stránce aktualizace více clusterů prostředku vozového parku můžete spustit spuštění aktualizace, které je ve stavu Nespustilo nebo Selhalo:

  

• Na stránce aktualizace více clusterů prostředku vozového parku můžete zastavit aktuálně spuštěnou aktualizaci:

  

• V rámci jakéhokoli spuštění aktualizace ve stavu Nespustilo se, Selhalo nebo Spuštěno můžete vybrat libovolnou fázi a přeskočit upgrade:

  

  Upgrade můžete také přeskočit na úrovni skupiny aktualizací nebo člena clusteru.

Azure CLI

• Spuštění aktualizace, které je ve stavu Nespustilo nebo Selhání, můžete spustit pomocí az fleet updaterun start příkazu:

  az fleet updaterun start \
   --resource-group $GROUP \
   --fleet-name $FLEET \
   --name <run-name>
  

• Spuštění aktuálně spuštěné aktualizace můžete zastavit pomocí az fleet updaterun stop příkazu:

  az fleet updaterun stop \
   --resource-group $GROUP \
   --fleet-name $FLEET \
   --name <run-name>
  

• Fáze aktualizace nebo skupiny můžete přeskočit zadáním příznaku --targets az fleet updaterun skip pomocí příkazu:

  az fleet updaterun skip \
   --resource-group $GROUP \
   --fleet-name $FLEET \
   --name <run-name> \
   --targets Group:my-group-name Stage:my-stage-name
  

  Další informace najdete v koncepčním přehledu stavů spuštění aktualizací a přeskočení chování při spuštění, fázích nebo skupinách.

Automatizace spuštění aktualizací pomocí profilů automatického upgradu

Profily automatického upgradu slouží k automatickému spouštění aktualizací napříč členskými clustery, když jsou k dispozici nové verze imagí Kubernetes nebo uzlů.

Další informace o konfiguraciprofilůch

Další informace najdete v koncepčním přehledu stavů spuštění aktualizace a přeskočení chování při spuštění, fázích nebo skupinách.

Další kroky

• Postupy: Automatický upgrade několika clusterů pomocí Azure Kubernetes Fleet Manageru