Uppdatera Kubernetes- och nodavbildningar i flera kluster med Azure Kubernetes Fleet Manager

Plattformsadministratörer som hanterar ett stort antal kluster har ofta problem med att mellanlagring av uppdateringar av flera kluster (till exempel uppgradering av nodoperativsystemavbildning eller Kubernetes-versioner) på ett säkert och förutsägbart sätt. För att hantera den här utmaningen kan du med Azure Kubernetes Fleet Manager (Fleet) samordna uppdateringar över flera kluster med hjälp av uppdateringskörningar.

Uppdateringskörningar består av steg, grupper och strategier och kan tillämpas manuellt för engångsuppdateringar, eller automatiskt, för pågående regelbundna uppdateringar med hjälp av profiler för automatisk uppgradering. Alla uppdateringskörningar (manuella eller automatiserade) respekterar underhållsperioder för medlemskluster.

Den här guiden beskriver hur du konfigurerar och kör uppdateringskörningar manuellt.

Förutsättningar

• Läs den konceptuella översikten över den här funktionen, som innehåller en förklaring av uppdateringsstrategier, körningar, faser och grupper som refereras i den här guiden.

• Du måste ha en Fleet-resurs med ett eller flera medlemskluster. Om inte följer du snabbstarten för att skapa en Fleet-resurs och ansluta till AKS-kluster (Azure Kubernetes Service) som medlemmar.

• Ange följande miljövariabler:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  

• Om du följer Azure CLI-anvisningarna i den här artikeln behöver du Azure CLI version 2.58.0 eller senare installerad. Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.

• Du behöver fleet också Azure CLI-tillägget som du kan installera genom att köra följande kommando:

  az extension add --name fleet
  

  az extension update Kör kommandot för att uppdatera till den senaste versionen av tillägget som släpptes:

  az extension update --name fleet
  

Skapa uppdateringskörningar

Kommentar

Uppdateringskörningar respekterar de planerade underhållsperioder som du anger på AKS-klusternivå. Mer information finns i planerat underhåll över flera medlemskluster, vilket förklarar hur uppdateringskörningar hanterar medlemskluster som konfigurerats med planerade underhållsperioder.

Uppdateringskörningen stöder två alternativ för klusteruppgraderingssekvensen:

• En i taget: Om du inte bryr dig om att styra klusteruppgraderingssekvensen ger one-by-one du en enkel metod för att uppgradera alla medlemskluster i flottan i följd en i taget.
• Styr sekvensen av kluster med hjälp av uppdateringsgrupper och faser: Om du vill styra klusteruppgraderingssekvensen kan du strukturera medlemskluster i uppdateringsgrupper och uppdateringssteg. Du kan lagra den här sekvensen som en mall i form av uppdateringsstrategi. Du kan skapa uppdateringskörningar senare med hjälp av uppdateringsstrategierna i stället för att definiera sekvensen varje gång du behöver skapa en uppdateringskörning.

Uppdatera alla kluster en i taget

Azure-portalen

1. I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.

2. På tjänstmenyn går du till Inställningar och väljer Uppdatera flera kluster>Skapa en körning.

3. Ange ett namn för uppdateringskörningen och välj sedan En i taget för uppgraderingstypen.

   

4. Välj något av följande alternativ för uppgraderingsomfånget:

   • Kubernetes-version för både kontrollplans- och nodpooler
   • Kubernetes-version för endast kontrollplanet i klustret
   • Endast nodbildversion

5. Välj något av följande alternativ för nodbilden:

   • Senaste avbildning: Uppdaterar varje AKS-kluster i uppdateringen till den senaste avbildningen som är tillgänglig för klustret i dess region.
   • Konsekvent bild: Eftersom det är möjligt att en uppdateringskörning har AKS-kluster i flera regioner där de senaste tillgängliga nodavbildningarna kan vara olika (kontrollera versionsspåraren för mer information). Uppdateringskörningen väljer den senaste gemensamma avbildningen i alla dessa regioner för att uppnå konsekvens.

   

6. Välj Skapa för att skapa uppdateringskörningen.

Azure CLI

1. Skapa en uppdateringskörning med az fleet updaterun create kommandot med dina valda värden för flaggorna --upgrade-type och --node-image-selection . Följande kommando skapar en uppdateringskörning som uppgraderar Kubernetes-versionen för både kontrollplans- och nodpooler och använder den senaste nodavbildningen som är tillgänglig för varje kluster i dess region.

   Flaggan --upgrade-type stöder följande värden:

   • Full uppgraderar Kubernetes-versionen för kontrollplans- och nodpooler tillsammans med nodbilderna.
   • ControlPlaneOnly uppgraderar bara Kubernetes-versionen för kontrollplanet i klustret.
   • NodeImageOnly uppgraderar endast nodbilderna.

   Flaggan --node-image-selection stöder följande värden:

   • Latest: Uppdaterar varje AKS-kluster i uppdateringskörningen till den senaste avbildningen som är tillgänglig för klustret i dess region.
   • Consistent: Eftersom det är möjligt att en uppdateringskörning har AKS-kluster i flera regioner där de senaste tillgängliga nodavbildningarna kan vara olika (kontrollera versionsspåraren för mer information). Uppdateringskörningen väljer den senaste gemensamma avbildningen i alla dessa regioner för att uppnå konsekvens.

   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. Starta uppdateringskörningen az fleet updaterun start med kommandot .

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

När du skapar en uppdateringskörning kan du styra omfånget för uppdateringskörningen. Flaggan --upgrade-type stöder följande värden:

• ControlPlaneOnly uppgraderar bara Kubernetes-versionen för kontrollplanet i klustret.
• Full uppgraderar Kubernetes-versionen för kontrollplans- och nodpooler tillsammans med nodbilderna.
• NodeImageOnly uppgraderar endast nodbilderna.

--node-image-selection Flaggan stöder också följande värden:

• Senaste: Uppdaterar varje AKS-kluster i uppdateringen till den senaste avbildningen som är tillgänglig för klustret i dess region.
• Konsekvent: Eftersom det är möjligt att en uppdateringskörning har AKS-kluster i flera regioner där de senaste tillgängliga nodavbildningarna kan vara olika (kontrollera versionsspåraren för mer information). Uppdateringskörningen väljer den senaste gemensamma avbildningen i alla dessa regioner för att uppnå konsekvens.

Startar en uppdateringskörning:

Starta uppdateringskörningar genom att köra följande kommando:

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

Tilldela kluster för att uppdatera grupper och faser

Uppdateringsgrupper och faser ger mer kontroll över den sekvens som uppdateringskörningar följer när du uppdaterar klustren. I en uppdateringsfas tillämpas uppdateringar på alla olika uppdateringsgrupper parallellt. I en uppdateringsgrupp uppdateras medlemskluster sekventiellt.

Du kan tilldela ett medlemskluster till en specifik uppdateringsgrupp på något av två sätt:

• Tilldela till grupp när du lägger till medlemskluster i flottan.
• Tilldela en befintlig medlem i flottan till en uppdateringsgrupp.

Tilldela till grupp när du lägger till medlemskluster i flottan

Azure-portalen

1. I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.

2. På tjänstmenyn går du till Inställningar och väljer Medlemskluster>Lägg till.

   

3. Välj det kluster som du vill lägga till och välj sedan Nästa: Granska + lägg till.

4. Ange namnet på den uppdateringsgrupp som du vill tilldela klustret till och välj sedan Lägg till.

Azure CLI

• Tilldela ett medlemskluster till en uppdateringsgrupp när du lägger till medlemsklustret i flottan med kommandot az fleet member create med --update-group flaggan inställd på namnet på uppdateringsgruppen.

  az fleet member create --resource-group $GROUP --fleet-name $FLEET --name member1 --member-cluster-id $AKS_CLUSTER_ID --update-group group-1a
  

Tilldela en befintlig medlem i flottan till en uppdateringsgrupp

Azure-portalen

1. I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.

2. På tjänstmenyn går du till Inställningar och väljer Medlemskluster.

3. Välj det kluster eller kluster som du vill tilldela till en uppdateringsgrupp och välj sedan Tilldela uppdateringsgrupp

   

4. Ange namnet på den uppdateringsgrupp som du vill tilldela klustret till och välj sedan Tilldela.

   

Azure CLI

• Tilldela en befintlig medlem i flottan till en uppdateringsgrupp med kommandot az fleet member update med --update-group flaggan inställd på namnet på uppdateringsgruppen.

  az fleet member update --resource-group $GROUP --fleet-name $FLEET --name member1 --update-group group-1a
  

Kommentar

En medlem i flottan kan bara ingå i en uppdateringsgrupp, men en uppdateringsgrupp kan ha flera medlemmar i flottan tilldelade. En uppdateringsgrupp i sig är inte en separat resurstyp. Uppdateringsgrupper är endast strängar som representerar referenser från medlemmarna i flottan. Så om alla medlemmar i flottan med referenser till en gemensam uppdateringsgrupp tas bort upphör även den specifika uppdateringsgruppen att finnas.

Definiera en uppdateringskörning och -faser

Du kan definiera en uppdateringskörning med hjälp av uppdateringssteg för att sekventiellt ordna program för uppdateringar till olika uppdateringsgrupper. En första uppdateringsfas kan till exempel uppdatera medlemskluster för testmiljön och ett andra uppdateringssteg skulle sedan uppdatera medlemskluster för produktionsmiljön. Du kan också ange en väntetid mellan uppdateringsstegen.

Azure-portalen

1. I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.

2. På tjänstmenyn går du till Inställningar och väljer Uppdatera flera kluster>Skapa en körning.

3. Ange ett namn för uppdateringskörningen och välj sedan Faser för uppdateringssekvenstypen.

   

4. Välj Skapa fas och ange sedan ett namn för fasen och väntetiden mellan faserna.

   

5. Välj de uppdateringsgrupper som du vill ta med i den här fasen. Du kan också ange ordningen på uppdateringsgrupperna om du vill uppdatera dem i en viss sekvens. Välj Skapa när du är klar.

   

6. Välj något av följande alternativ för uppgraderingsomfånget:

   • Kubernetes-version för både kontrollplans- och nodpooler
   • Kubernetes-version för endast kontrollplanet i klustret
   • Endast nodbildversion

7. Välj något av följande alternativ för nodbilden:

   • Senaste avbildning: Uppdaterar varje AKS-kluster i uppdateringen till den senaste avbildningen som är tillgänglig för klustret i dess region.
   • Konsekvent bild: Eftersom det är möjligt att en uppdateringskörning har AKS-kluster i flera regioner där de senaste tillgängliga nodavbildningarna kan vara olika (kontrollera versionsspåraren för mer information). Uppdateringskörningen väljer den senaste gemensamma avbildningen i alla dessa regioner för att uppnå konsekvens.

   

8. Välj Skapa för att skapa uppdateringskörningen.

   Att ange steg och deras ordning varje gång du skapar en uppdateringskörning kan bli repetitivt och besvärligt. Uppdateringsstrategier förenklar den här processen genom att du kan lagra mallar för uppdateringskörningar. Mer information finns i skapa och använda uppdateringsstrategi.

9. I menyn För uppdatering av flera kluster väljer du uppdateringskörningen och väljer sedan Starta.

Azure CLI

1. Skapa en JSON-fil för att definiera faser och grupper för uppdateringskörningen. Här är ett exempel på indata från fasfilen (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. Skapa en uppdateringskörning med az fleet updaterun create kommandot med --stages flaggan inställd på namnet på din JSON-fil och dina valda värden för flaggorna --upgrade-type och --node-image-selection . Följande kommando skapar en uppdateringskörning som uppgraderar Kubernetes-versionen för både kontrollplans- och nodpooler och använder den senaste nodavbildningen som är tillgänglig för varje kluster i dess region.

   Flaggan --upgrade-type stöder följande värden:

   • Full uppgraderar Kubernetes-versionen för kontrollplans- och nodpooler tillsammans med nodbilderna.
   • ControlPlaneOnly uppgraderar bara Kubernetes-versionen för kontrollplanet i klustret.
   • NodeImageOnly uppgraderar endast nodbilderna.

   Flaggan --node-image-selection stöder följande värden:

   • Latest: Uppdaterar varje AKS-kluster i uppdateringskörningen till den senaste avbildningen som är tillgänglig för klustret i dess region.
   • Consistent: Eftersom det är möjligt att en uppdateringskörning har AKS-kluster i flera regioner där de senaste tillgängliga nodavbildningarna kan vara olika (kontrollera versionsspåraren för mer information). Uppdateringskörningen väljer den senaste gemensamma avbildningen i alla dessa regioner för att uppnå konsekvens.

   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. Starta uppdateringskörningen az fleet updaterun start med kommandot .

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

Skapa en uppdateringskörning med uppdateringsstrategier

När du skapar en uppdateringskörning måste du ange faser, grupper och ordning varje gång. Uppdateringsstrategier förenklar den här processen genom att du kan lagra mallar för uppdateringskörningar.

Kommentar

Det går att skapa flera uppdateringskörningar med unika namn från samma uppdateringsstrategi.

Du kan skapa en uppdateringsstrategi med någon av följande metoder:

• Spara en uppdateringsstrategi när du skapar en uppdateringskörning med hjälp av Azure Portal.
• Skapa en ny uppdateringsstrategi och referera sedan till den när du skapar en uppdateringskörning.

Spara en uppdateringsstrategi när du skapar en uppdateringskörning

• Spara en uppdateringsstrategi när du skapar en uppdateringskörning i Azure Portal:

  

Skapa en ny uppdateringsstrategi och referera till den när du skapar en uppdateringskörning

Azure-portalen

1. Gå till sidan för uppdatering av flera kluster och välj sedan Strategier>Skapa en strategi:

   

2. Konfigurera information om uppdateringsstrategin och välj sedan Skapa.

3. Referera till uppdateringsstrategin när du skapar nya efterföljande uppdateringskörningar:

   

Azure CLI

1. Skapa en ny uppdateringsstrategi med az fleet updatestrategy create kommandot med --stages flaggan inställd på namnet på din JSON-fil.

   az fleet updatestrategy create --resource-group $GROUP --fleet-name $FLEET --name strategy-1 --stages example-stages.json
   

2. Skapa en uppdateringskörning med az fleet updaterun create kommandot med --update-strategy-name flaggan inställd på namnet på uppdateringsstrategin.

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-5 --update-strategy-name strategy-1 --upgrade-type NodeImageOnly --node-image-selection Consistent
   

Hantera en uppdateringskörning

I följande avsnitt beskrivs hur du hanterar en uppdateringskörning med hjälp av Azure Portal och Azure CLI.

Azure-portalen

• På sidan För flerklusteruppdatering för resursen för flottan kan du starta en uppdateringskörning som antingen är i Tillståndet Inte startad eller Misslyckades:

  

• På sidan för uppdatering av flera kluster för resursen för flottan kan du stoppa en uppdateringskörning som körs för tillfället:

  

• I alla uppdateringar som körs i tillståndet Inte startad, Misslyckades eller Körs kan du välja valfri fas och hoppa över uppgraderingen:

  

  Du kan också hoppa över uppgraderingen på uppdateringsgrupp- eller medlemsklusternivå.

Azure CLI

• Du kan starta en uppdateringskörning som antingen är i tillståndet Inte startad eller Misslyckades med kommandot az fleet updaterun start :

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

• Du kan stoppa en uppdateringskörning som körs med kommandot az fleet updaterun stop :

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

• Du kan hoppa över uppdateringssteg eller grupper genom att ange dem i --targets flaggan med kommandot az fleet updaterun skip :

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

  Mer information finns i konceptuell översikt över uppdateringskörningstillstånden och hoppa över beteendet för körningar/faser/grupper.

Automatisera uppdateringskörningar med hjälp av profiler för automatisk uppgradering

Profiler för automatisk uppgradering används för att automatiskt köra uppdateringskörningar i medlemskluster när nya Kubernetes- eller nodavbildningsversioner görs tillgängliga.

Mer information om hur du konfigurerar profiler för automatisk uppgradering finns i automatisera uppgraderingar av Kubernetes- och nodbilder med Azure Kubernetes Fleet Manager.

Mer information finns i den konceptuella översikten över uppdateringskörningstillstånden och hoppa över beteendet för körningar/faser/grupper.

Nästa steg

Läs mer om Azure Kubernetes Fleet Manager.