Aggiornamento di un pool di nodi

Questo argomento spiega come aggiornare i node pool. Puoi aggiornare i node pool per i seguenti motivi:

  • Per eseguire l'upgrade della versione del pool di nodi
  • Per modificare il numero di nodi nel pool di nodi
  • Per modificare le annotazioni del pool di nodi (aggiornabili solo tramite l'API)

Puoi anche modificare altri parametri dei node pool non elencati sopra. Per un elenco completo dei parametri che puoi aggiornare, consulta la gcloud container azure node-pools update e la projects.locations.azureNodePools.patch documentazione.

Aggiornamento processo

Questa sezione descrive le procedure eseguite da GKE su Azure per aggiornare un pool di nodi. La procedura è diversa a seconda dell'entità delle modifiche necessarie al pool di nodi.

Aggiornamento solo della configurazione

Se GKE su Azure può aggiornare un pool di nodi senza riavviare o ricreare risorse, applicherà le modifiche. Ad esempio, l'aggiornamento delle annotazioni del pool di nodi non riavvierà le istanze.

Aggiornamento in sequenza

Quando una modifica a un pool di nodi richiede il riavvio delle macchine virtuali esistenti, ad esempio quando si aggiorna la versione di Kubernetes, GKE su Azure esegue i seguenti passaggi:

  1. Modifica il set di scalabilità di macchine virtuali del pool di nodi con la nuova configurazione.
  2. Scegli l'istanza sottostante di un nodo da aggiornare.
  3. GKE su Azure isola e svuota il nodo. A questo punto, non è possibile pianificare nuovi pod sul nodo di destinazione. Gli oggetti pod esistenti sul nodo di destinazione vengono ripianificati su altri nodi. I pod che non possono essere ripianificati su altri nodi esistenti rimangono nella fase In attesa finché non possono essere pianificati.
  4. Aggiorna l'istanza in modo che utilizzi la configurazione più recente dal relativo set di scalabilità di macchine virtuali.
  5. Esegui il reimage e riavvia l'istanza.
  6. Attendi che tutti i nodi in questo pool di nodi diventino integri.
  7. Se tutti i nodi in questo pool di nodi sono integri, seleziona un altro nodo finché non vengono aggiornati tutti i nodi. Se un nodo non è integro, GKE su Azure imposta il pool di nodi sullo stato DEGRADED. Per ulteriori informazioni, consulta Aggiornamenti non riusciti.

Proteggere i carichi di lavoro durante un aggiornamento in sequenza del pool di nodi

Durante l'aggiornamento in sequenza pool di nodi, GKE su Azure rispetta la configurazione di PodDisruptionBudget
per un massimo di un'ora dopo l'inizio dello svuotamento di un nodo. Dopo un'ora, GKE su Azure elimina tutti i pod rimanenti sul nodo.

Durante l'aggiornamento in sequenza, GKE su Azure esegue un arresto normale di tutti i nodi da riavviare o rimuovere con il massimo impegno per un massimo di due ore. Dopo due ore, se sono presenti oggetti pod rimanenti sul nodo, GKE su Azure elimina il nodo ed esegue il reimage dell'istanza di macchina virtuale sottostante.

Ridimensionamento dei node pool

I node pool GKE su Azure hanno la scalabilità automatica dei cluster abilitata per impostazione predefinita. Il gestore della scalabilità automatica dei cluster ridimensiona automaticamente il pool di nodi in base alle esigenze dei carichi di lavoro. Per ulteriori informazioni sul gestore della scalabilità automatica dei cluster, consulta Gestore della scalabilità automatica dei cluster.

Quando modifichi il numero massimo e minimo di nodi nel pool di nodi, GKE su Azure esegue azioni diverse a seconda della nuova configurazione e del numero attuale di nodi del node pool di nodi. Queste azioni includono quanto segue:

  • Se il numero attuale di nodi del pool di nodi è già compreso nel nuovo intervallo, GKE su Azure non modifica il numero di nodi nel pool.

  • Se il nuovo numero minimo di nodi è superiore al numero attuale di nodi del pool di nodi, GKE su Azure aggiunge altri nodi finché il pool di nodi non raggiunge la nuova dimensione minima.

  • Se il nuovo numero massimo di nodi è inferiore al numero attuale di nodi del pool di nodi, GKE su Azure riduce le dimensioni del pool di nodi eseguendo le seguenti azioni:

    1. Aggiorna la configurazione della scalabilità automatica nel set di scalabilità di macchine virtuali nel pool di nodi
    2. Seleziona un nodo da rimuovere
    3. Isola e svuota il nodo
    4. Elimina l'istanza di macchina virtuale sottostante
    5. Attendi che la macchina virtuale eliminata non sia più presente
    6. Esegui il controllo di integrità sull'intero pool di nodi
    7. Ripeti l'operazione finché il numero di nodi non raggiunge il numero desiderato

In che modo GKE su Azure protegge i carichi di lavoro durante il ridimensionamento del pool di nodi

Durante il ridimensionamento pool di nodi, GKE su Azure rispetta la configurazione di PodDisruptionBudget per un massimo di un'ora dopo l'inizio dello svuotamento di un nodo. Dopo un'ora, GKE su Azure elimina tutti gli oggetti pod rimanenti sul nodo.

Durante il ridimensionamento del pool di nodi, GKE su Azure esegue un arresto normale di tutti i nodi da riavviare o rimuovere e attende fino a due ore. Dopo due ore, se sono presenti oggetti pod rimanenti sul nodo, GKE su Azure elimina l'istanza di macchina virtuale sottostante.

Verificare lo stato di un aggiornamento non riuscito

Se GKE su Azure esegue un controllo di integrità dopo un aggiornamento e il controllo di integrità non riesce, il pool di nodi viene contrassegnato come DEGRADED. Puoi trovare informazioni sullo stato del cluster con il seguente comando Google Cloud CLI:

gcloud container azure node-pools describe NODE_POOL_NAME \
    --cluster CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION

Sostituisci quanto segue:

  • NODE_POOL_NAME: il nome del pool di nodi
  • CLUSTER_NAME: il nome del cluster
  • GOOGLE_CLOUD_LOCATION: la Google Cloud regione che gestisce il cluster

L'output include informazioni sullo stato e sulla configurazione del pool di nodi.

Prerequisiti

Per aggiornare un pool di nodi, devi disporre dell'autorizzazione Identity and Access Management gkemulticloud.googleapis.com/azureNodePools.update.

Aggiorna un pool di nodi

Puoi aggiornare un pool di nodi con Google Cloud CLI. Per aggiornare un pool di nodi, esegui:

gcloud container azure node-pools update NODE_POOL_NAME \
    --cluster CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION \
    --node-version NODE_POOL_VERSION \
    --min-nodes MIN_NODES \
    --max-nodes MAX_NODES

Sostituisci quanto segue:

Annullamento di un'operazione di aggiornamento

Per annullare un'operazione di aggiornamento del pool di nodi in corso, esegui il comando seguente:

gcloud container azure operations cancel OPERATION_NAME

Sostituisci OPERATION_NAME con il nome dell'operazione di aggiornamento.

Tieni presente che l'annullamento di un'operazione di aggiornamento del pool di nodi in corso non ripristinerà gli aggiornamenti dei nodi già completati. Ciò può comportare un pool di nodi aggiornato parzialmente.

Passaggi successivi