Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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.
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
fleetockså tillägget Azure CLI. Installera det genom att köra följande kommando:az extension add --name fleetaz extension updateKö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
memberSelectorfö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.
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
memberSelectorför att välja kluster efter deras etiketter och innehåller valfriamaxConcurrencyinställningar:-
stagingFasen använder en stegnivåmemberSelectorför att välja alla kluster med etikettenenv=stagingoch skapa en implicit grupp. -
productionFasen använder en stegnivåmemberSelectorför att förfiltrera alla kluster med etikettenenv=productionoch definierar sedan två grupper, var och en med sin egenmemberSelectorför att välja kluster eftertieretiketten.
När
memberSelectoranges i en grupp används gruppens fält endast som visningsidentifierarenamefö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).
Skapa en ny uppdateringsstrategi med
az fleet updatestrategy createkommandot med--stagesflaggan 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
I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.
På tjänstmenyn går du till Inställningar och väljer Medlemskluster>Lägg till.
Välj det kluster som du vill lägga till och välj sedan Nästa: Granska + lägg till.
Ange namnet på den uppdateringsgrupp som du vill tilldela klustret till och välj sedan Lägg till.
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
I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.
På tjänstmenyn går du till Inställningar och väljer Medlemskluster.
Välj de kluster som du vill tilldela till en uppdateringsgrupp och välj sedan Tilldela uppdateringsgrupp
Ange namnet på den uppdateringsgrupp som du vill tilldela klustret till och välj sedan Tilldela.
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.
I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.
På tjänstmenyn går du till Inställningar och väljer >av flera kluster och sedan Skapa.
Ange ett namn för strategin.
Första gången du visar sidan visas ett förklaringsdiagram för uppdateringsstrategi som kan hjälpa dig att visualisera hur strategier fungerar.
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.
Tilldela en eller flera uppdateringsgrupper till fasen och välj sedan Skapa.
Kommentar
Det maximala antalet uppdateringsgrupper i varje uppdateringssteg är 50.
I det här scenariot skapar vi faser och grupper som matchar den information som används för Azure Portal-processen.
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
maxConcurrencyochmaxAllowedFailuresinstä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" } ] } ] }maxConcurrencyFä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-1anger dumaxConcurrencytill"7", vilket gör att upp till"7"kluster i den här fasen kan uppgraderas samtidigt. Inomstage-1begränsargroup-1samtidighet till"3"kluster, vilket innebär att upp till"3"i den här gruppen kan uppgraderas samtidigt.group-2tillå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).maxAllowedFailuresFä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-1maxAllowedFailurestill"2", vilket tolererar upp till två medlemsfel i steget.stage-1Inomgroup-1tolererar"1"fel ochgroup-2tolererar"25%"att dess medlemmar misslyckas (till exempel om gruppen innehåller 4 kluster tolereras upp till 1 fel).stage-2angermaxAllowedFailurestill"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).Skapa en ny uppdateringsstrategi med
az fleet updatestrategy createkommandot med--stagesflaggan 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:
- Anvisningar: Uppgradera flera kluster med azure Kubernetes Fleet Manager-uppdateringskörningar.
- Anvisningar: Lägga till godkännanden i Azure Kubernetes Fleet Manager Update Strategies.
- Anvisningar: Uppgradera automatiskt flera kluster med Azure Kubernetes Fleet Manager.
- Vanliga frågor och svar om flerklusteruppdateringar.