Aggiornamento di un pool di nodi

Questo argomento spiega come aggiornare i node pool. Puoi aggiornare i pool di nodi 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 pool di nodi (aggiornabili solo tramite 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 che GKE su Azure esegue per aggiornare un pool di nodi. La procedura varia 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, apporterà queste modifiche. Ad esempio, l'aggiornamento delle annotazioni del pool di nodi non riavvierà alcuna istanza.

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 riprogrammati su nessun altro nodo esistente rimangono nella fase Pending finché non possono essere pianificati.
  4. Aggiorna l'istanza per acquisire 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é tutti i nodi non vengono aggiornati. Se un nodo non è integro, GKE su Azure imposta ilpool di nodil nello stato DEGRADED. Per ulteriori informazioni, vedi Aggiornamenti non riusciti.

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

Durante l'aggiornamento in sequenza del pool di nodi, GKE su Azure rispetta la configurazione di PodDisruptionBudget
fino a 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 controllato di tutti i nodi da riavviare o rimuovere con il massimo impegno per un massimo di due ore. Dopo due ore, se sul nodo sono presenti oggetti Pod rimanenti, GKE su Azure elimina il nodo e ricrea l'immagine dell'istanza della macchina virtuale sottostante.

Ridimensionamento dei node pool

I node pool GKE su Azure hanno la scalabilità automatica del cluster abilitata per impostazione predefinita. Il gestore della scalabilità automatica dei cluster ridimensiona automaticamente il pool di nodi in base alle esigenze dei tuoi carichi di lavoro. Per saperne di più 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:

  • Se il numero attuale di nodi del pool di nodi rientra già 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 nodil
    2. Seleziona un nodo da rimuovere
    3. Isolare e svuotare 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 PodDisruptionBudget fino a 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 controllato di tutti i nodi da riavviare o rimuovere e attende fino a due ore. Dopo due ore, se sul nodo sono presenti oggetti Pod rimanenti, GKE su Azure elimina l'istanza di macchina virtuale sottostante.

Controllare lo stato di aggiornamento non riuscito

Se GKE su Azure esegue un controllo di integrità dopo un aggiornamento e il controllo di integrità non va a buon fine, 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 tuo pool di nodi
  • CLUSTER_NAME: il nome del tuo cluster
  • GOOGLE_CLOUD_LOCATION: la Google Cloud regione che gestisce il tuo 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.

Aggiornamento di 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:

  • NODE_POOL_NAME: il nome del pool di nodi da aggiornare
  • CLUSTER_NAME: il nome del cluster a cui collegare il pool di nodil.
  • GOOGLE_CLOUD_LOCATION: la regione Google Cloud supportata che gestisce il cluster, ad esempio us-west1
  • NODE_POOL_VERSION: la nuova versione pool di nodi supportata
  • MIN_NODES: il nuovo numero minimo di nodi che il pool di nodi può contenere. Deve essere pari a 0 o superiore.
  • MAX_NODES: il nuovo numero massimo di nodi che il pool di nodi può contenere. Deve essere almeno 1 e il valore di MIN_NODES.

Annullamento di un'operazione di aggiornamento

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

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