Kubernetes- en knooppuntinstallatiekopieën bijwerken in meerdere clusters met behulp van Azure Kubernetes Fleet Manager

Platformbeheerders die een groot aantal clusters beheren, hebben vaak problemen met het faseren van de updates van meerdere clusters (bijvoorbeeld het upgraden van de installatiekopie van het knooppuntbesturingssysteem of kubernetes-versies) op een veilige en voorspelbare manier. Om deze uitdaging aan te pakken, kunt u met Azure Kubernetes Fleet Manager (Fleet) updates in meerdere clusters organiseren met behulp van updateuitvoeringen.

Updateuitvoeringen bestaan uit fasen, groepen en strategieën en kunnen handmatig worden toegepast voor eenmalige updates of automatisch voor doorlopende regelmatige updates met behulp van profielen voor automatische upgrade. Alle updateuitvoeringen (handmatig of geautomatiseerd) respecteren onderhoudsvensters voor het lidcluster.

In deze handleiding wordt beschreven hoe u updateuitvoeringen configureert en handmatig uitvoert.

Vereisten

• Lees het conceptuele overzicht van deze functie, dat een uitleg biedt van updatestrategieën, uitvoeringen, fasen en groepen waarnaar in deze handleiding wordt verwezen.

• U moet een Fleet-resource met een of meer lidclusters hebben. Zo niet, volgt u de quickstart om een Fleet-resource te maken en azure Kubernetes Service-clusters (AKS) als leden toe te voegen.

• Stel de volgende omgevingsvariabelen in:

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

• Als u de Azure CLI-instructies in dit artikel volgt, moet Azure CLI versie 2.58.0 of hoger zijn geïnstalleerd. Zie Azure CLI installeren als u CLI wilt installeren of upgraden.

• U hebt ook de fleet Azure CLI-extensie nodig, die u kunt installeren door de volgende opdracht uit te voeren:

  az extension add --name fleet
  

  Voer de az extension update opdracht uit om bij te werken naar de nieuwste versie van de extensie die is uitgebracht:

  az extension update --name fleet
  

Updateuitvoeringen maken

Notitie

Update wordt uitgevoerd volgens de geplande onderhoudsvensters die u hebt ingesteld op het niveau van het AKS-cluster. Zie gepland onderhoud voor meerdere lidclusters voor meer informatie, waarin wordt uitgelegd hoe updateuitvoeringen lidclusters verwerken die zijn geconfigureerd met geplande onderhoudsvensters.

Updateuitvoering ondersteunt twee opties voor de upgradevolgorde van het cluster:

• Eén voor één: Als u het niet belangrijk vindt om de upgradevolgorde van het cluster te beheren, one-by-one biedt u een eenvoudige benadering om alle lidclusters van de vloot één voor één bij elkaar te upgraden.
• Beheervolgorde van clusters met behulp van updategroepen en fasen: als u de upgradevolgorde van het cluster wilt beheren, kunt u lidclusters structuren in updategroepen en updatefasen. U kunt deze reeks opslaan als sjabloon in de vorm van een updatestrategie. U kunt later updateuitvoeringen maken met behulp van de updatestrategieën in plaats van de volgorde te definiëren telkens wanneer u een updateuitvoering moet maken.

Alle clusters één voor één bijwerken

Azure-portal

1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.

2. Selecteer in het servicemenu onder Instellingen de optie >Update voor meerdere clusters maken.

3. Voer een naam in voor de updateuitvoering en selecteer vervolgens Een voor één voor het upgradetype.

   

4. Selecteer een van de volgende opties voor het upgradebereik:

   • Kubernetes-versie voor zowel besturingsvlak- als knooppuntgroepen
   • Kubernetes-versie voor alleen het besturingsvlak van het cluster
   • Alleen versie van knooppuntinstallatiekopieën

5. Selecteer een van de volgende opties voor de knooppuntinstallatiekopieën:

   • Meest recente installatiekopieën: werkt elk AKS-cluster in de updateuitvoering bij naar de meest recente installatiekopieën die beschikbaar zijn voor dat cluster in de regio.
   • Consistente installatiekopie: omdat het mogelijk is dat een update wordt uitgevoerd om AKS-clusters te hebben in meerdere regio's waar de meest recente beschikbare knooppuntinstallatiekopieën kunnen verschillen (controleer releasetracker voor meer informatie). De updateuitvoering kiest de meest recente algemene installatiekopie in al deze regio's om consistentie te bereiken.

   

6. Selecteer Maken om de updateuitvoering te maken.

Azure-CLI

1. Maak een updateuitvoering met behulp van de az fleet updaterun create opdracht met de door u gekozen waarden voor de --upgrade-type en --node-image-selection vlaggen. Met de volgende opdracht maakt u een update-uitvoering waarmee de Kubernetes-versie voor zowel het besturingsvlak als de knooppuntgroepen wordt bijgewerkt en de meest recente knooppuntinstallatiekopieën worden gebruikt die beschikbaar zijn voor elk cluster in de regio.

   De --upgrade-type vlag ondersteunt de volgende waarden:

   • Full werkt Kubernetes-versie bij voor besturingsvlak- en knooppuntgroepen, samen met de knooppuntinstallatiekopieën.
   • ControlPlaneOnly alleen de Kubernetes-versie wordt bijgewerkt voor het besturingsvlak van het cluster.
   • NodeImageOnly alleen de knooppuntinstallatiekopieën worden bijgewerkt.

   De --node-image-selection vlag ondersteunt de volgende waarden:

   • Latest: Werkt elk AKS-cluster in de updateuitvoering bij naar de meest recente installatiekopieën die beschikbaar zijn voor dat cluster in de regio.
   • Consistent: Omdat het mogelijk is dat een update wordt uitgevoerd om AKS-clusters te hebben in meerdere regio's waar de meest recente beschikbare knooppuntinstallatiekopieën verschillend kunnen zijn (raadpleeg releasetracker voor meer informatie). De updateuitvoering kiest de meest recente algemene installatiekopie in al deze regio's om consistentie te bereiken.

   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. Start de updateuitvoering met behulp van de az fleet updaterun start opdracht.

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

Wanneer u een updateuitvoering maakt, kunt u het bereik van de updateuitvoering beheren. De --upgrade-type vlag ondersteunt de volgende waarden:

• ControlPlaneOnly alleen de Kubernetes-versie wordt bijgewerkt voor het besturingsvlak van het cluster.
• Full werkt Kubernetes-versie bij voor besturingsvlak- en knooppuntgroepen, samen met de knooppuntinstallatiekopieën.
• NodeImageOnly alleen de knooppuntinstallatiekopieën worden bijgewerkt.

--node-image-selection Vlag ondersteunt ook de volgende waarden:

• Nieuwste: Werkt elk AKS-cluster in de update bij naar de meest recente installatiekopieën die beschikbaar zijn voor dat cluster in de regio.
• Consistent: Omdat het mogelijk is dat een update wordt uitgevoerd met AKS-clusters in meerdere regio's waar de meest recente beschikbare knooppuntinstallatiekopieën kunnen verschillen (raadpleeg releasetracker voor meer informatie). De updateuitvoering kiest de meest recente algemene installatiekopie in al deze regio's om consistentie te bereiken.

Een updateuitvoering starten:

Voer de volgende opdracht uit om updateuitvoeringen te starten:

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

Clusters toewijzen om groepen en fasen bij te werken

Updategroepen en fasen bieden meer controle over de volgorde die updateuitvoeringen volgen wanneer u de clusters bijwerkt. Binnen een updatefase worden updates parallel toegepast op alle verschillende updategroepen. Binnen een updategroep worden lidclusters opeenvolgend bijgewerkt.

U kunt een lidcluster op twee manieren toewijzen aan een specifieke updategroep:

• Toewijzen aan groep bij het toevoegen van een lidcluster aan de vloot.
• Wijs een bestaand vlootlid toe aan een updategroep.

Toewijzen aan groep bij het toevoegen van lidcluster aan de vloot

Azure-portal

1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.

2. Selecteer Lidclusters>toevoegen in het servicemenu onder Instellingen.

   

3. Selecteer het cluster dat u wilt toevoegen en selecteer vervolgens Volgende: Beoordelen en toevoegen.

4. Voer de naam in van de updategroep waaraan u het cluster wilt toewijzen en selecteer vervolgens Toevoegen.

Azure-CLI

• Wijs een lidcluster toe aan een updategroep wanneer u het lidcluster aan de vloot toevoegt met behulp van de az fleet member create opdracht met de --update-group vlag die is ingesteld op de naam van de updategroep.

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

Een bestaand vlootlid toewijzen aan een updategroep

Azure-portal

1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.

2. Selecteer lidclusters in het servicemenu onder Instellingen.

3. Selecteer het cluster of de clusters die u wilt toewijzen aan een updategroep en selecteer vervolgens Updategroep toewijzen

   

4. Voer de naam in van de updategroep waaraan u het cluster wilt toewijzen en selecteer vervolgens Toewijzen.

   

Azure-CLI

• Wijs een bestaand vlootlid toe aan een updategroep met behulp van de az fleet member update opdracht met de --update-group vlag die is ingesteld op de naam van de updategroep.

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

Notitie

Een vlootlid kan slechts deel uitmaken van één updategroep, maar aan een updategroep kunnen meerdere vlootleden zijn toegewezen. Een updategroep zelf is geen afzonderlijk resourcetype. Updategroepen zijn alleen tekenreeksen die verwijzingen van de vlootleden vertegenwoordigen. Dus als alle vlootleden met verwijzingen naar een gemeenschappelijke updategroep worden verwijderd, zal die specifieke updategroep ook niet meer bestaan.

Een updateuitvoering en fasen definiëren

U kunt een updateuitvoering definiëren met behulp van updatefasen om de toepassing van updates opeenvolgend te ordenen in verschillende updategroepen. Een eerste updatefase kan bijvoorbeeld testomgevinglidclusters bijwerken en vervolgens een tweede updatefase de clusters van leden van de productieomgeving bijwerken. U kunt ook een wachttijd opgeven tussen de updatefasen.

Azure-portal

1. Navigeer in Azure Portal naar uw Azure Kubernetes Fleet Manager-resource.

2. Selecteer in het servicemenu onder Instellingen de optie >Update voor meerdere clusters maken.

3. Voer een naam in voor de updateuitvoering en selecteer vervolgens Fasen voor het type updatereeks.

   

4. Selecteer Fase maken en voer vervolgens een naam in voor de fase en de wachttijd tussen fasen.

   

5. Selecteer de updategroepen die u in deze fase wilt opnemen. U kunt ook de volgorde van de updategroepen opgeven als u ze in een specifieke volgorde wilt bijwerken. Selecteer Maken als u klaar bent.

   

6. Selecteer een van de volgende opties voor het upgradebereik:

   • Kubernetes-versie voor zowel besturingsvlak- als knooppuntgroepen
   • Kubernetes-versie voor alleen het besturingsvlak van het cluster
   • Alleen versie van knooppuntinstallatiekopieën

7. Selecteer een van de volgende opties voor de knooppuntinstallatiekopieën:

   • Meest recente installatiekopieën: werkt elk AKS-cluster in de updateuitvoering bij naar de meest recente installatiekopieën die beschikbaar zijn voor dat cluster in de regio.
   • Consistente installatiekopie: omdat het mogelijk is dat een update wordt uitgevoerd om AKS-clusters te hebben in meerdere regio's waar de meest recente beschikbare knooppuntinstallatiekopieën kunnen verschillen (controleer releasetracker voor meer informatie). De updateuitvoering kiest de meest recente algemene installatiekopie in al deze regio's om consistentie te bereiken.

   

8. Selecteer Maken om de updateuitvoering te maken.

   Het opgeven van fasen en de volgorde ervan telkens wanneer u een updateuitvoering maakt, kan herhalend en omslachtig worden. Bijwerkstrategieën vereenvoudigen dit proces doordat u sjablonen voor updateuitvoeringen kunt opslaan. Zie het maken en gebruiken van de updatestrategie voor meer informatie.

9. Selecteer in het menu Update voor meerdere clusters de updateuitvoering en selecteer vervolgens Start.

Azure-CLI

1. Maak een JSON-bestand om de fasen en groepen voor de updateuitvoering te definiëren. Hier volgt een voorbeeld van invoer uit het fasebestand (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. Maak een updateuitvoering met behulp van de az fleet updaterun create opdracht waarbij de --stages vlag is ingesteld op de naam van uw JSON-bestand en de door u gekozen waarden voor de --upgrade-type en --node-image-selection vlaggen. Met de volgende opdracht maakt u een update-uitvoering waarmee de Kubernetes-versie voor zowel het besturingsvlak als de knooppuntgroepen wordt bijgewerkt en de meest recente knooppuntinstallatiekopieën worden gebruikt die beschikbaar zijn voor elk cluster in de regio.

   De --upgrade-type vlag ondersteunt de volgende waarden:

   • Full werkt Kubernetes-versie bij voor besturingsvlak- en knooppuntgroepen, samen met de knooppuntinstallatiekopieën.
   • ControlPlaneOnly alleen de Kubernetes-versie wordt bijgewerkt voor het besturingsvlak van het cluster.
   • NodeImageOnly alleen de knooppuntinstallatiekopieën worden bijgewerkt.

   De --node-image-selection vlag ondersteunt de volgende waarden:

   • Latest: Werkt elk AKS-cluster in de updateuitvoering bij naar de meest recente installatiekopieën die beschikbaar zijn voor dat cluster in de regio.
   • Consistent: Omdat het mogelijk is dat een update wordt uitgevoerd om AKS-clusters te hebben in meerdere regio's waar de meest recente beschikbare knooppuntinstallatiekopieën verschillend kunnen zijn (raadpleeg releasetracker voor meer informatie). De updateuitvoering kiest de meest recente algemene installatiekopie in al deze regio's om consistentie te bereiken.

   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. Start de updateuitvoering met behulp van de az fleet updaterun start opdracht.

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

Een updateuitvoering maken met behulp van updatestrategieën

Voor het maken van een updateuitvoering moet u de fasen, groepen en volgorde elke keer opgeven. Bijwerkstrategieën vereenvoudigen dit proces doordat u sjablonen voor updateuitvoeringen kunt opslaan.

Notitie

Het is mogelijk om meerdere updateuitvoeringen te maken met unieke namen uit dezelfde updatestrategie.

U kunt een updatestrategie maken met een van de volgende methoden:

• Sla een updatestrategie op tijdens het maken van een updateuitvoering met behulp van Azure Portal.
• Maak een nieuwe updatestrategie en verwijs er vervolgens naar bij het maken van een updateuitvoering.

Een updatestrategie opslaan tijdens het maken van een updateuitvoering

• Sla een updatestrategie op tijdens het maken van een updateuitvoering in Azure Portal:

  

Een nieuwe updatestrategie maken en ernaar verwijzen bij het maken van een updateuitvoering

Azure-portal

1. Navigeer naar de pagina voor het bijwerken van meerdere clusters en selecteer vervolgens Strategieën>maken een strategie:

   

2. Configureer de details van de updatestrategie en selecteer Vervolgens Maken.

3. Raadpleeg de updatestrategie bij het maken van nieuwe volgende updateuitvoeringen:

   

Azure-CLI

1. Maak een nieuwe updatestrategie met behulp van de az fleet updatestrategy create opdracht waarbij de --stages vlag is ingesteld op de naam van uw JSON-bestand.

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

2. Maak een updateuitvoering met behulp van de az fleet updaterun create opdracht, waarbij de --update-strategy-name vlag is ingesteld op de naam van de updatestrategie.

   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
   

Een updateuitvoering beheren

In de volgende secties wordt uitgelegd hoe u een updateuitvoering beheert met behulp van Azure Portal en Azure CLI.

Azure-portal

• Op de updatepagina voor meerdere clusters van de vlootresource kunt u een updateuitvoering starten die niet is gestart of mislukt:

  

• Op de pagina voor het bijwerken van meerdere clusters van de vlootresource kunt u stoppen met het uitvoeren van een update die momenteel wordt uitgevoerd:

  

• Binnen elke updateuitvoering met de status Niet gestart, Mislukt of Actief kunt u een fase selecteren en de upgrade overslaan :

  

  U kunt de upgrade ook overslaan op het niveau van de updategroep of het cluster van leden.

Azure-CLI

• U kunt een updateuitvoering starten die de status Niet gestart of Mislukt heeft met behulp van de az fleet updaterun start opdracht:

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

• U kunt de uitvoering van een update die momenteel wordt uitgevoerd stoppen met behulp van de az fleet updaterun stop opdracht:

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

• U kunt updatefasen of -groepen overslaan door ze in de --targets vlag op te geven met behulp van de az fleet updaterun skip opdracht:

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

  Zie conceptueel overzicht van de statussen van de updateuitvoering en sla gedrag over bij uitvoeringen/fasen/groepen over voor meer informatie.

Updateuitvoeringen automatiseren met behulp van profielen voor automatische upgrade

Profielen voor automatische upgrade worden gebruikt om updates automatisch uit te voeren in lidclusters wanneer nieuwe versies van Kubernetes of knooppuntinstallatiekopieën beschikbaar worden gesteld.

Zie Upgrades van Kubernetes en knooppuntinstallatiekopieën automatiseren met behulp van Azure Kubernetes Fleet Manager voor meer informatie over het configureren van profielen voor automatische upgrade.

Zie voor meer informatie het conceptuele overzicht van de statussen van de updateuitvoering en sla gedrag over bij uitvoeringen/fasen/groepen over.

Volgende stappen

Meer informatie over Azure Kubernetes Fleet Manager.