Herbruikbare updatestrategieën definiëren met Azure Kubernetes Fleet Manager

Beheerders kunnen de volgorde van updates voor door Fleet beheerde clusters beheren door een reeks fasen en groepen te definiëren. Ze kunnen configureren wanneer goedkeuringen en pauzes moeten plaatsvinden binnen die fasen en groepen. De volledige configuratie kan worden opgeslagen als een updatestrategie die onafhankelijk van updateuitvoeringen of automatische upgrades kan worden beheerd, zodat strategieën naar behoefte opnieuw kunnen worden gebruikt.

In dit artikel wordt beschreven hoe u updatestrategieën definieert met behulp van groepen en fasen.

Vereisten

• Lees het conceptuele overzicht van Fleet-updates, met een uitleg van updateuitvoeringen, fasen, groepen en strategieën waarnaar in deze handleiding wordt verwezen.

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

• Stel de volgende omgevingsvariabelen in:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export CLUSTERID=<aks-cluster-resource-id>
  export STRATEGY=<strategy-name>
  

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

• U hebt ook de fleet Azure CLI-extensie versie 1.6.0 of hoger 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
  

Clusters voor uw strategie selecteren

Er zijn twee manieren om te selecteren welke clusters zijn opgenomen in elke fase en groep van uw updatestrategie om de updatevolgorde te beheren:

• Lidlabels (aanbevolen): wijs labels toe aan elk vlootlid en gebruik memberSelector deze om leden door deze labels te selecteren. Elk lid kan meerdere labels hebben.
• Updategroepen: Wijs een updategroep toe aan elk vlootlid en definieer vervolgens groepen in uw strategie die overeenkomen met die groepsnamen. Elk lid kan slechts tot één groep behoren.

Een updatestrategie maken met ledenkiezers (preview)

Lidlabels zijn de aanbevolen methode voor het selecteren van clusters in uw updatestrategieën, omdat ze meer flexibiliteit bieden. Zie Groepsclusters met lidlabels voor conceptuele informatie.

Labels toepassen op lidclusters

Labels toepassen bij het toevoegen van een lidcluster aan de vloot

Pas labels toe op uw vlootleden met behulp van de az fleet member create opdracht. In het volgende voorbeeld worden twee labels toegepast op het lidcluster: env=staging en tier=frontend:

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --labels "env=staging tier=frontend"

Labels toepassen op een bestaand vlootlid

Labels toepassen op uw vlootleden met behulp van de az fleet member update opdracht

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --labels "env=staging tier=frontend"

Een updatestrategie maken

Een updatestrategie bestaat uit een of meer fasen, waarbij een fase een of meer updategroepen kan bevatten.

1. Maak een JSON-bestand om de fasen en groepen voor de updateuitvoering te definiëren. Fasen worden opeenvolgend uitgevoerd in de volgorde waarin ze worden weergegeven in het JSON-bestand. Binnen elke fase worden groepen parallel uitgevoerd. In het volgende voorbeeldbestand (example-labels-strategy.json) wordt een strategie gedefinieerd met twee fasen die worden gebruikt om clusters te selecteren op basis van memberSelector hun labels en optionele maxConcurrency instellingen bevat:

   • De staging fase maakt gebruik van een faseniveau memberSelector om alle clusters met het label env=staging te selecteren en één impliciete groep te maken.
   • De production fase maakt gebruik van een faseniveau memberSelector om alle clusters met het label env=productionvooraf te filteren en definieert vervolgens twee groepen, elk met een eigen memberSelector groep om clusters op het tier label te selecteren.

   Wanneer memberSelector het veld van een groep is ingesteld, wordt het veld van de groep name alleen gebruikt als weergave-id voor statusrapportage en logboekregistratie en niet meer gebruikt voor selectie van vlootleden op basis van een updategroep.

   {
       "stages": [
           {
               "name": "staging",
               "memberSelector": { "byLabel": "env=staging" },
               "maxConcurrency": "1",
               "afterStageWaitInSeconds": 600
           },
           {
               "name": "production",
               "memberSelector": { "byLabel": "env=production" },
               "maxConcurrency": "4",
               "groups": [
                   {
                       "name": "frontend",
                       "memberSelector": { "byLabel": "tier=frontend" },
                       "maxConcurrency": "3"
                   },
                   {
                       "name": "backend",
                       "memberSelector": { "byLabel": "tier=backend" },
                       "maxConcurrency": "3"
                   }
               ]
           }
       ]
   }
   

2. 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 \
    --stages example-labels-strategy.json
   

Een updatestrategie maken met behulp van updategroepen

Clusters kunnen ook worden geselecteerd in updatestrategieën door ze toe te wijzen aan één updategroep. U kunt een updatestrategie definiëren waarmee deze updategroepen aan fasen worden toegewezen. Binnen een updatefase worden updates parallel toegepast op elke updategroep. Binnen een updategroep worden lidclusters opeenvolgend bijgewerkt.

Clusters toewijzen om groepen bij te werken

Toewijzen aan groep bij het toevoegen van lidcluster aan de vloot

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

Een bestaand vlootlid toewijzen aan een updategroep

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

Een updatestrategie maken

Een updatestrategie bestaat uit een of meer fasen, waarbij een fase een of meer updategroepen kan bevatten.

Volgende stappen

U kunt een updatestrategie gebruiken als onderdeel van een handmatige updateuitvoering of een profiel voor automatische upgrade. Zie:

• Instructies: Voer een upgrade uit van meerdere clusters met azure Kubernetes Fleet Manager-updateuitvoeringen.
• Instructies: Goedkeuringen toevoegen aan Updatestrategieën van Azure Kubernetes Fleet Manager.
• Instructies: Meerdere clusters automatisch upgraden met Behulp van Azure Kubernetes Fleet Manager.
• Veelgestelde vragen over updates voor meerdere clusters.