Definire strategie di aggiornamento ripristinabili usando Azure Kubernetes Fleet Manager

Gli amministratori possono controllare la sequenza di aggiornamenti ai cluster gestiti da Fleet definendo fasi, gruppi e pause facoltative tra fasi. Queste sequenze possono essere salvate come strategie di aggiornamento che possono essere gestite indipendentemente da esecuzioni di aggiornamento o 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 Fleet con uno o più cluster membri. In caso contrario, seguire l’avvio rapido per creare una risorsa Flotta e aggiungere cluster del servizio Azure Kubernetes 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.61.0 o successiva installata. Per eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

• È anche necessaria l'estensione fleet dell'interfaccia della riga di comando di Azure, 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
  

Assegnare cluster per aggiornare i gruppi

Prima che i cluster possano essere usati nelle strategie di aggiornamento, è necessario aggiungerli ai gruppi di aggiornamento che possono essere usati nelle fasi di aggiornamento. 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.

È possibile assegnare un cluster membro a un gruppo di aggiornamento specifico in uno dei due modi seguenti:

• Assegnare al gruppo quando si aggiunge un cluster membro alla flotta.
• Assegnare un membro della flotta esistente a un gruppo di aggiornamento.

Nota

Un membro della flotta può far parte solo di un gruppo di aggiornamento, ma un gruppo di aggiornamento può avere più membri della flotta assegnati. Un gruppo di aggiornamento non è un tipo di risorsa diverso. I gruppi di aggiornamento sono semplicemente stringhe che rappresentano riferimenti ai membri della flotta. Pertanto, se tutti i membri della flotta con riferimenti a un gruppo di aggiornamento comune vengono eliminati, tale gruppo di aggiornamento smetterà di esistere.

Assegna al gruppo quando si aggiunge un cluster membro alla flotta

Azure portal

1. Nella portale di Azure passare alla risorsa Di Azure Kubernetes Fleet Manager.

2. Nel menu del servizio, in Impostazioni, selezionare Cluster membri>Aggiungi.

   

3. Selezionare il cluster da aggiungere e quindi selezionare Avanti: Rivedi e aggiungi.

4. Immettere il nome del gruppo di aggiornamento a cui si vuole assegnare il cluster e quindi selezionare Aggiungi.

   

Interfaccia della riga di comando di Azure

Assegnare un cluster membro a un gruppo di aggiornamento quando si aggiunge il cluster membro alla flotta usando il comando con il az fleet member create --update-group parametro impostato sul nome del gruppo di aggiornamento.

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

Azure portal

1. Nella portale di Azure passare alla risorsa Di Azure Kubernetes Fleet Manager.

2. Dal menu del servizio, in Impostazioni, selezionare Cluster membri.

3. Selezionare i cluster da assegnare a un gruppo di aggiornamento e quindi selezionare Assegna gruppo di aggiornamento

   

4. Immettere il nome del gruppo di aggiornamento a cui si vuole assegnare il cluster e quindi selezionare Assegna.

   

Interfaccia della riga di comando di Azure

Assegnare un membro della flotta esistente a un gruppo di aggiornamento usando il comando con il az fleet member update --update-group flag impostato sul nome del gruppo di aggiornamento.

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

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.

Azure portal

1. Nella portale di Azure passare alla risorsa Di Azure Kubernetes Fleet Manager.

2. Dal menu del servizio, in Impostazioni selezionare Strategie di aggiornamento>multi-cluster e quindi Crea.

3. Immettere un nome per la strategia.

4. La prima volta che si visualizza la pagina, viene visualizzato un diagramma di spiegazione della strategia di aggiornamento che consente di visualizzare il funzionamento delle strategie.

   

5. Selezionare Crea fase e immettere:

   • Nome fase: denominare la fase, deve essere univoco in tutti i nomi di fase della flotta.
   • (Facoltativo) Pausa dopo la fase : selezionare questa opzione se si vuole definire una pausa prima di passare alla fase successiva.
   • (Facoltativo) Durata pausa: selezionare una durata predefinita oppure immettere un valore personalizzato in secondi.

   

6. Assegnare uno o più gruppi di aggiornamento alla fase e quindi selezionare Crea.

   

Interfaccia della riga di comando di Azure

Per questo scenario si creeranno fasi e gruppi in modo che corrispondano ai dettagli usati per il processo di portale di Azure.

1. Creare un file JSON per definire le fasi e i gruppi per l'esecuzione dell'aggiornamento. Ecco un esempio di input del file di fasi (example-stages.json) che rappresenta la strategia illustrata per la creazione tramite il portale di Azure:

   {
       "stages": [
           {
               "name": "stage-1",
               "groups": [
                   {
                       "name": "group-1"
                   },
                   {
                       "name": "group-2"
                   }
               ],
               "afterStageWaitInSeconds": 300
           },
           {
               "name": "stage-2",
               "groups": [
                   {
                       "name": "group-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-stages.json
   

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: aggiornare automaticamente più cluster usando Azure Kubernetes Fleet Manager.