Definire strategie di aggiornamento riutilizzabili con Azure Kubernetes Fleet Manager

Gli amministratori possono controllare la sequenza di aggiornamenti ai cluster gestiti da Fleet definendo una serie di fasi e gruppi. Possono configurare quando le approvazioni e le pause devono essere eseguite all'interno di tali fasi e gruppi. L'intera configurazione può essere salvata come strategia di aggiornamento che può essere gestita indipendentemente dalle esecuzioni degli aggiornamenti o dagli aggiornamenti automatici, consentendo di riutilizzare le strategie in base alle esigenze.

Questo articolo illustra come definire strategie di aggiornamento usando gruppi e fasi.

Prerequisiti

• Leggere la panoramica concettuale degli aggiornamenti di Fleet, che fornisce una spiegazione delle esecuzioni degli aggiornamenti, delle fasi, dei gruppi e delle strategie a cui si fa riferimento in questa guida.

• È necessario disporre di una risorsa flotta con uno o più cluster membri. In caso contrario, seguire l’avvio rapido per creare una risorsa Fleet e unire i cluster di Servizio Azure Kubernetes (AKS) come membri.

• Impostare le seguenti variabili di ambiente:

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

• Se si seguono le istruzioni dell'interfaccia della riga di comando di Azure in questo articolo, è necessaria l'interfaccia della riga di comando di Azure versione 2.70.0 o successiva installata. Per eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

• È necessaria anche l'estensione della fleet CLI di Azure versione 1.6.0 o successiva, che è possibile installare eseguendo il comando seguente:

  az extension add --name fleet
  

  Eseguire il comando per eseguire l'aggiornamento az extension update alla versione più recente dell'estensione rilasciata:

  az extension update --name fleet
  

Selezionare i cluster per la strategia

Esistono due modi per selezionare i cluster inclusi in ogni fase e gruppo della strategia di aggiornamento per controllare la sequenza di aggiornamento:

• Etichette dei membri (scelta consigliata): assegnare etichette a ogni membro della flotta e usare memberSelector per selezionare i membri in base a tali etichette. Ogni membro può avere più etichette.
• Aggiornare i gruppi: assegnare un gruppo di aggiornamento a ogni membro della flotta, quindi definire i gruppi nella strategia che corrispondono a tali nomi di gruppo. Ogni membro può appartenere a un solo gruppo.

Creare una strategia di aggiornamento usando selettori di membri (anteprima)

Le etichette dei membri sono l'approccio consigliato per la selezione dei cluster nelle strategie di aggiornamento perché offrono maggiore flessibilità. Per informazioni concettuali, vedere Raggruppare i cluster usando le etichette dei membri.

Applicare etichette sui cluster membri

Applicare etichette all'aggiunta di un cluster membro alla flotta

Applicare etichette ai membri della flotta usando il az fleet member create comando . L'esempio seguente applica due etichette al cluster membro: env=staging e tier=frontend:

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

Applicare etichette a un membro della flotta esistente

Applicare etichette ai membri della flotta usando il az fleet member update comando

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

Creare una strategia di aggiornamento

Una strategia di aggiornamento è costituita da una o più fasi, in cui una fase può contenere uno o più gruppi di aggiornamento.

1. Creare un file JSON per definire le fasi e i gruppi per l'esecuzione dell'aggiornamento. Le fasi vengono eseguite in sequenza nell'ordine in cui vengono visualizzate nel file JSON. I gruppi vengono eseguiti in parallelo in ogni fase. Il file di esempio seguente (example-labels-strategy.json) definisce una strategia con due fasi usando memberSelector per selezionare i cluster in base alle etichette e include impostazioni facoltative maxConcurrency :

   • La fase staging utilizza un memberSelector a livello di fase per selezionare tutti i cluster con l'etichetta env=staging e creare un gruppo implicito.
   • La fase production utilizza un memberSelector a livello di fase per prefiltrare tutti i cluster con l'etichetta env=production, quindi definisce due gruppi, ciascuno dotato del proprio memberSelector per selezionare i cluster in base all'etichetta tier.

   Quando memberSelector è impostato su un gruppo, il name campo del gruppo viene usato solo come identificatore di visualizzazione per la reportistica dello stato e la registrazione dei log e non viene più usato per la selezione dei membri della flotta basata sui gruppi di aggiornamento.

   {
       "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. Creare una nuova strategia di aggiornamento usando il az fleet updatestrategy create comando con il --stages flag impostato sul nome del file JSON.

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

Creare una strategia di aggiornamento usando i gruppi di aggiornamento

I cluster possono anche essere selezionati nelle strategie di aggiornamento assegnandoli a un singolo gruppo di aggiornamento. È possibile definire una strategia di aggiornamento che assegna questi gruppi di aggiornamento alle fasi. All'interno di una fase di aggiornamento, gli aggiornamenti vengono applicati a ogni gruppo di aggiornamento in parallelo. All'interno di un gruppo di aggiornamento, i cluster membri vengono aggiornati in sequenza.

Assegnare cluster a gruppi di aggiornamento

Assegnarlo al gruppo quando si aggiunge il cluster membro alla flotta

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

Assegnare un membro della flotta esistente a un gruppo di aggiornamento

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

Creare una strategia di aggiornamento

Una strategia di aggiornamento è costituita da una o più fasi, in cui una fase può contenere uno o più gruppi di aggiornamento.

Passaggi successivi

È possibile usare una strategia di aggiornamento come parte di un'esecuzione di aggiornamento manuale o di un profilo di aggiornamento automatico. Vedere:

• Procedura: Aggiornare più cluster usando le esecuzioni degli aggiornamenti di Azure Kubernetes Fleet Manager.
• Procedura: Aggiungere approvazioni alle strategie di aggiornamento di Azure Kubernetes Fleet Manager.
• Procedura: aggiornare automaticamente più cluster usando Azure Kubernetes Fleet Manager.
• Domande frequenti sugli aggiornamenti multi-cluster.