Definiera återanvändbara uppdateringsstrategier med Azure Kubernetes Fleet Manager

Gäller för: ✔️ Fleet Manager ✔️ Fleet Manager med hubbkluster

Administratörer kan styra sekvensen med uppdateringar till Fleet-hanterade kluster genom att definiera en serie faser och grupper. De kan konfigurera när godkännanden och pauser ska ske inom dessa faser och grupper. Hela konfigurationen kan sparas som en uppdateringsstrategi som kan hanteras oberoende av uppdateringskörningar eller automatiska uppgraderingar, så att strategier kan återanvändas efter behov.

Den här artikeln beskriver hur du definierar uppdateringsstrategier med hjälp av grupper och faser.

Ett diagram som visar ett exempel på en uppdateringsstrategi som innehåller två uppdateringssteg. Varje uppdateringssteg innehåller två uppdateringsgrupper. Varje uppdateringsgrupp innehåller två medlemskluster.

Förutsättningar

  • Läs den konceptuella översikten över uppdateringar av flottan, som innehåller en förklaring av uppdateringskörningar, steg, grupper och strategier 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>
    export CLUSTERID=<aks-cluster-resource-id>
    export STRATEGY=<strategy-name>
    
  • Om du följer de Azure CLI instruktionerna i den här artikeln installerar du den senaste versionen av Azure CLI. Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.

  • Du behöver fleet också tillägget Azure CLI. Installera det 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
    

Välj kluster för din strategi

Det finns två sätt att välja vilka kluster som ska ingå i varje steg och en grupp av din uppdateringsstrategi för att styra uppdateringssekvensen:

  • Medlemsetiketter (rekommenderas): Tilldela etiketter till varje medlem i flottan och använd memberSelector för att välja medlemmar efter dessa etiketter. Varje medlem kan ha flera etiketter.
  • Uppdateringsgrupper: Tilldela en uppdateringsgrupp till varje medlem i flottan och definiera sedan grupper i din strategi som matchar dessa gruppnamn. Varje medlem kan bara tillhöra en grupp.

Skapa en uppdateringsstrategi med medlemsväljare (förhandsversion)

Använd medlemsetiketter för att välja kluster i dina uppdateringsstrategier. De ger mer flexibilitet. Konceptuell information finns i Gruppera kluster med medlemsetiketter.

Important

Förhandsversionsfunktionerna i Azure Kubernetes Fleet Manager är tillgängliga via självbetjäning och opt-in. Förhandsversioner tillhandahålls "i befintligt skick" och "i mån av tillgång," och de är undantagna från servicenivåavtal och begränsad garanti. Förhandsversionerna av Azure Kubernetes Fleet Manager täcks delvis av kundsupport på bästa möjliga sätt. Därför är dessa funktioner inte avsedda för produktionsanvändning.

Använda etiketter på medlemskluster

Använd etiketter när du lägger till medlemskluster i flottan

az fleet member create Använd kommandot för att tillämpa etiketter på dina medlemmar i flottan. I följande exempel tillämpas två etiketter på medlemsklustret: env=staging och tier=frontend:

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

Tillämpa etiketter på en befintlig medlem i flottan

az fleet member update Använd kommandot för att tillämpa etiketter på dina medlemmar i flottan.

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

Skapa en uppdateringsstrategi

En uppdateringsstrategi består av ett eller flera steg, där en fas kan innehålla en eller flera uppdateringsgrupper.

Kommentar

En Azure portalupplevelse kommer att vara tillgänglig innan den här funktionen är allmänt tillgänglig.

  1. Skapa en JSON-fil för att definiera faser och grupper för uppdateringskörningen. Faserna körs sekventiellt i den ordning de visas i JSON-formatet. Grupper körs parallellt inom varje steg. Följande exempelfil (example-labels-strategy.json) definierar en strategi med två steg som använder memberSelector för att välja kluster efter deras etiketter och innehåller valfria maxConcurrency inställningar:

    • staging Fasen använder en stegnivå memberSelector för att välja alla kluster med etiketten env=staging och skapa en implicit grupp.
    • production Fasen använder en stegnivå memberSelector för att förfiltrera alla kluster med etiketten env=productionoch definierar sedan två grupper, var och en med sin egen memberSelector för att välja kluster efter tier etiketten.

    När memberSelector anges i en grupp används gruppens fält endast som visningsidentifierare name för statusrapportering och loggning och används inte längre för uppdateringsgruppsbaserat urval av medlemmar i flottan.

    {
        "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"
                    }
                ]
            }
        ]
    }
    

Kommentar

Fältet maxConcurrency är valfritt och styr hur många kluster som kan uppgraderas samtidigt på fas- eller gruppnivå. Använd ett större värde för att uppgradera kluster snabbare i din flotta, eller ett mindre värde för en mer kontrollerad distribution som begränsar explosionsradien om det uppstår problem.

När en fas använder memberSelector utan grupper (till exempel staging) bildar alla matchande medlemmar en enda implicit grupp och fasens maxConcurrency kontroller samtidighet direkt. När grupper definieras (t.ex production. ) fungerar stegnivån maxConcurrency som ett övergripande tak för alla grupper.

I det här exemplet anger staging-steget maxConcurrency-fasen till "1", så att stagingkluster uppgraderas en i taget. production Fasen tillåter upp till "4" kluster samtidigt, med frontend och backend grupperna var och en begränsade till "3".

Värden kan vara ett fast heltal (till exempel "3") eller en procentandel (till exempel "50%"). Om det utelämnas tillämpar systemet standardvärden. Mer information om hur dessa värden matchas och deras övre gränser finns i Maximal samtidighet (förhandsversion).

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

Skapa en uppdateringsstrategi med hjälp av uppdateringsgrupper

Du kan välja kluster i uppdateringsstrategier genom att tilldela dem till en enda uppdateringsgrupp. Definiera en uppdateringsstrategi som tilldelar dessa uppdateringsgrupper till faser. I en uppdateringsfas tillämpas uppdateringar på varje uppdateringsgrupp parallellt. I en uppdateringsgrupp uppdateras medlemskluster sekventiellt.

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 textsträngar som representerar referenser från flottans medlemmar. Så om alla medlemmar i flottan med referenser till en gemensam uppdateringsgrupp tas bort upphör även den specifika uppdateringsgruppen att finnas.

Tilldela kluster till uppdateringsgrupper

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

  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.

    Skärmbild av sidan Azure Portal för Azure Kubernetes Fleet Manager för att lägga till medlemskluster.

  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.

    Skärmbild av sidan för Azure-portalen för Azure Kubernetes Fleet Manager granska och lägga till steg för medlemskluster.

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

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

Tilldela en befintlig medlem i flottan till en uppdateringsgrupp

  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 de kluster som du vill tilldela till en uppdateringsgrupp och välj sedan Tilldela uppdateringsgrupp

    Skärmbild av sidan Azure Portal för att tilldela befintliga medlemskluster till en grupp.

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

    Skärmbild av sidan Azure Portal för medlemskluster som visar formuläret för att uppdatera ett medlemsklusters grupp.

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-1

Skapa en uppdateringsstrategi

En uppdateringsstrategi består av ett eller flera steg, där en fas kan innehålla en eller flera uppdateringsgrupper.

  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 >av flera kluster och sedan Skapa.

  3. Ange ett namn för strategin.

  4. Första gången du visar sidan visas ett förklaringsdiagram för uppdateringsstrategi som kan hjälpa dig att visualisera hur strategier fungerar.

    En skärmbild av Azure Portal som visar skapande av uppdateringsstrategi.

  5. Välj Skapa fas och ange:

    • Fasnamn – namnge fasen – det måste vara unikt för alla scennamn i strategin.
    • (Valfritt) Steggodkännanden – välj det här alternativet om du vill vänta på ett godkännande innan det här steget startar eller när det har slutförts. Mer information finns i Lägga till godkännanden för att uppdatera grupper och faser.
    • (Valfritt) Pausa efter fas – välj det här alternativet om du vill definiera en paus innan du går vidare till nästa steg.
    • (Valfritt) Pausa varaktighet – välj en fördefinierad varaktighet eller ange ett anpassat värde i sekunder.

    En skärmbild av Azure Portal som visar skapandet av Azure Kubernetes Fleet Manager-uppdateringsstrategisteget.

  6. Tilldela en eller flera uppdateringsgrupper till fasen och välj sedan Skapa.

    Kommentar

    Det maximala antalet uppdateringsgrupper i varje uppdateringssteg är 50.

    En skärmbild av Azure Portal som visar skapandet av Azure Kubernetes Fleet Manager-uppdateringsstrategisteget och väljer uppdateringsgrupper som ska inkluderas.

I det här scenariot skapar vi faser och grupper som matchar den information som används för Azure Portal-processen.

  1. Skapa en JSON-fil för att definiera faser och grupper för uppdateringskörningen. Faserna körs sekventiellt i den ordning de visas i JSON-formatet. Grupper körs parallellt inom varje steg, så ordningen har ingen betydelse. Följande exempelfil (example-stages.json) definierar en strategi med två steg och innehåller valfria maxConcurrency och maxAllowedFailures inställningar:

    {
        "stages": [
            {
                "name": "stage-1",
                "maxConcurrency": "7",
                "maxAllowedFailures": "2",
                "groups": [
                    {
                        "name": "group-1",
                        "maxConcurrency": "3",
                        "maxAllowedFailures": "1"
                    },
                    {
                        "name": "group-2",
                        "maxConcurrency": "50%",
                        "maxAllowedFailures": "25%"
                    }
                ],
                "afterStageWaitInSeconds": 300
            },
            {
                "name": "stage-2",
                "maxConcurrency": "100%",
                "maxAllowedFailures": "0",
                "groups": [
                    {
                        "name": "group-3",
                        "maxConcurrency": "2",
                        "maxAllowedFailures": "0"
                    }
                ]
            }
        ]
    }
    

    maxConcurrency

    Fältet maxConcurrency är valfritt och styr hur många kluster som kan uppgraderas samtidigt på fas- eller gruppnivå. Använd ett större värde för att uppgradera kluster snabbare i din flotta, eller ett mindre värde för en mer kontrollerad distribution som begränsar explosionsradien om problem uppstår.

    I det här exemplet stage-1 anger du maxConcurrency till "7", vilket gör att upp till "7" kluster i den här fasen kan uppgraderas samtidigt. Inom stage-1begränsar group-1 samtidighet till "3" kluster, vilket innebär att upp till "3" i den här gruppen kan uppgraderas samtidigt. group-2 tillåter upp till "50%" av sina kluster att uppgradera samtidigt (till exempel om gruppen innehåller 4 kluster kan upp till 2 uppgradera samtidigt).

    Värden kan vara ett fast heltal (till exempel "3") eller en procentandel (till exempel "100%"). Om det utelämnas tillämpar systemet standardvärden. Mer information om hur dessa värden matchas och deras övre gränser finns i Maximal samtidighet (förhandsversion).

    maxAllowedFailures

    Fältet maxAllowedFailures är valfritt och styr hur många uppgraderingsfel för medlemskluster som tolereras innan gruppen eller fasen markeras som misslyckad. Som standard (när det tas bort eller "0") stoppas hela uppdateringskörningen av ett enskilt fel.

    Den här inställningen utvärderar endast antalet fel. Den kräver ingen lägsta framgångsgrad. En grupp eller ett stadium kan därför sluta Completed även om vissa eller alla medlemmar misslyckades, så länge tröskelvärdet för fel inte överskreds när Fleet fattade sina schemaläggningsbeslut.

    I det här exemplet anger stage-1maxAllowedFailures till "2", vilket tolererar upp till två medlemsfel i steget. stage-1 Inom group-1tolererar "1" fel och group-2 tolererar "25%" att dess medlemmar misslyckas (till exempel om gruppen innehåller 4 kluster tolereras upp till 1 fel). stage-2 anger maxAllowedFailures till "0", vilket innebär att eventuella fel omedelbart stoppar körningen och ofta är användbart för produktionsfaser.

    För de flesta distributioner föredrar du procentbaserade värden eftersom de skalas bättre mellan olika gruppstorlekar. Undvik att ange värdet lika med det totala antalet medlemmar såvida du inte avsiktligt vill ha ett effektivt beteende för segmentet "misslyckas aldrig".

    Värden kan vara ett fast heltal (till exempel "3") eller en procentandel (till exempel "25%"). Mer information om hur dessa värden löses finns i Maximalt antal tillåtna fel (förhandsversion).

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

Nästa steg

Du kan använda en uppdateringsstrategi som en del av en manuell uppdateringskörning eller en profil för automatisk uppgradering. Se: