Visualizzare gli upgrade dei cluster

Questa pagina spiega come ottenere informazioni sugli upgrade per i tuoi cluster Google Kubernetes Engine (GKE). GKE esegue automaticamente l'upgrade di tutti i cluster nel tempo. Quando GKE esegue l'upgrade di un cluster, aggiorna la versione del control plane Kubernetes e dei nodi worker in operazioni separate.

GKE aggrega le informazioni sugli upgrade dei cluster per aiutarti a comprendere meglio lo stato del tuo cluster. Puoi ottenere le seguenti informazioni per un cluster:

  • Upgrade pianificati (anteprima): GKE ti invia una notifica almeno 72 ore prima di un upgrade automatico del control plane del cluster. Quando abiliti gli upgrade pianificati, GKE esegue comunque automaticamente l'upgrade del control plane di un cluster a intervalli regolari, ma solo dopo aver fornito questa notifica avanzata. Se non ricevi una notifica in anticipo, il piano di controllo del cluster non viene aggiornato.
  • Target di upgrade automatico: scopri quali nuove versioni GKE prevede per il tuo cluster, che potrebbero essere patch o nuove versioni secondarie, a seconda della versione e dei vincoli esistenti del cluster. Se non è presente un target di upgrade automatico, il cluster è già in corrispondenza dell'ultimo target di upgrade oppure GKE non ha assegnato un target di upgrade automatico per motivi tecnici o aziendali. Puoi anche recuperare i target di upgrade automatico generali in base alla versione secondaria di un cluster nelle note di rilascio di GKE Aggiornamenti delle versioni, ad esempio la nota 2024-R33.
  • Stato dell'upgrade automatico: i cluster GKE hanno uno stato per gli upgrade dei cluster. Utilizza questo stato per scoprire di più sugli upgrade attuali e sui vincoli che GKE prende in considerazione quando sceglie quando eseguire l'upgrade automatico del cluster, inclusi fattori come le esclusioni dalla manutenzione o i motivi che impediscono gli upgrade. Per saperne di più, consulta Stato dell'upgrade automatico del cluster.

  • Cronologia degli upgrade: GKE fornisce un'istantanea degli upgrade recenti del control plane e dei nodi per il tuo cluster, inclusi gli upgrade automatici e manuali. Per gli upgrade recenti del control plane e dei nodi, puoi visualizzare dettagli come i seguenti:

    • Versioni: la versione iniziale e quella di destinazione.
    • Stato: indica se l'upgrade è ancora in corso o se è stato eseguito correttamente, non è riuscito o è stato annullato.
    • Ora: l'ora di inizio e di fine.
    • Tipo di avvio: indica se l'upgrade è stato attivato automaticamente o manualmente.

  • Date di fine del supporto: GKE supporta le versioni secondarie fino a 24 mesi. Per saperne di più, consulta il ciclo di vita della versione secondaria di GKE. Per le date di fine del supporto per tutte le versioni secondarie attuali, consulta la pianificazione stimata per i canali di rilascio.

  • Eventi del cluster: GKE invia notifiche del cluster a Cloud Logging per determinati eventi, ad esempio quando gli upgrade iniziano o terminano, quando sono disponibili nuove versioni, bollettini sulla sicurezza e date di fine assistenza. Oltre a GKE che mostra automaticamente questi eventi con Cloud Logging, puoi anche indirizzare queste notifiche a Pub/Sub. Per saperne di più, consulta Notifiche di cluster.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

  • Attiva l'API Google Kubernetes Engine.
    • Attiva l'API Kubernetes Engine
  • Se vuoi utilizzare Google Cloud CLI per questa attività, installala e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, scarica l'ultima versione eseguendo il comando gcloud components update. Le versioni precedenti di gcloud CLI potrebbero non supportare l'esecuzione dei comandi in questo documento.

Ricevere notifiche sugli upgrade dei cluster pianificati

Puoi attivare gli upgrade pianificati per GKE per ricevere una notifica in anticipo sugli upgrade automatici del control plane del cluster. Quando questa funzionalità di attivazione è abilitata, GKE pubblica una notifica del cluster su Cloud Logging o, facoltativamente, su Pub/Sub, informandoti dell'ora di inizio dell'upgrade, della versione di destinazione e del control plane del cluster che verrà aggiornato. GKE ti invia una notifica tra le 72 e le 96 ore prima dell'ora di inizio. GKE avvia l'upgrade entro otto ore dall'ora di inizio pianificata a una delle seguenti opzioni:

  • La versione di GKE indicata nella notifica
  • Una patch successiva nella stessa versione secondaria se una patch diventa una destinazione di upgrade automatico nel canale di rilascio del cluster prima dell'upgrade

Le notifiche di upgrade pianificato forniscono la certezza di quando GKE avvierà un upgrade di un control plane. Tuttavia, questa notifica non garantisce che GKE esegua l'upgrade del cluster all'ora fornita. Inoltre, la notifica ti informa solo dell'inizio dell'upgrade e non garantisce il completamento dell'upgrade.

Se non abiliti questa funzionalità, GKE esegue comunque automaticamente l'upgrade del control plane del cluster. Tuttavia, il comportamento predefinito senza questa funzionalità è che non ricevi una notifica di upgrade pianificato in anticipo.

Esamina le sezioni seguenti per capire quali azioni puoi intraprendere o non intraprendere quando ricevi una notifica di upgrade pianificato e altri motivi per cui GKE potrebbe non eseguire l'upgrade di un cluster all'ora indicata.

Cosa fare quando ricevi una notifica di upgrade programmato

Se vuoi che l'upgrade pianificato venga eseguito all'ora indicata nella notifica, non devi fare altro che monitorare l'integrità dell'ambiente cluster e dei workload quando GKE avvia l'upgrade automatico.

In alternativa, puoi eseguire alcune delle seguenti azioni, che influiranno sui tempi dell'upgrade:

Motivi per cui GKE potrebbe non eseguire un upgrade pianificato

GKE potrebbe non eseguire l'upgrade pianificato all'ora specificata se è stato rilevato un problema con la versione tra l'invio della notifica e l'inizio pianificato dell'upgrade. Per ulteriori informazioni, consulta Individuare cosa impedisce il successivo upgrade del cluster.

Se GKE annulla l'upgrade pianificato, a causa delle tue azioni o di altre circostanze impreviste, GKE invia un'altra notifica del cluster quando l'upgrade viene riprogrammato.

Limitazioni

  • Non puoi attivare gli upgrade pianificati con il sequenziamento dell'implementazione.
  • GKE non invia una notifica per un upgrade pianificato annullato. GKE invia una notifica solo per un nuovo upgrade pianificato.
  • Se attivi gli upgrade pianificati, l'attivazione potrebbe causare il completamento degli upgrade automatici più lentamente rispetto a quando le notifiche non sono attive. Questo effetto si verifica perché, per ogni upgrade, GKE deve fornire un preavviso minimo di 72 ore, rispettare la finestra di avvio di 8 ore e rispettare qualsiasi finestra di manutenzione, se ne hai configurata una per il cluster. Se hai bisogno di upgrade per procedere nel tuo cluster con la massima efficienza, ti sconsigliamo di utilizzare questa funzionalità. Puoi anche attivare la funzionalità, ma utilizzare gli upgrade manuali per avanzare gli upgrade quando necessario.
  • GKE fornisce una notifica avanzata solo per gli upgrade della versione del control plane e non per gli upgrade del pool di nodi o altri tipi di aggiornamenti dei nodi. Per maggiori informazioni sulla differenza tra gli upgrade (aggiornamenti di versione) e altri tipi di aggiornamenti, vedi Gestire le modifiche al ciclo di vita del cluster per ridurre al minimo le interruzioni.
  • Non puoi abilitare o disabilitare gli upgrade pianificati con Terraform.

  • Le notifiche di upgrade pianificato forniscono solo la garanzia che gli upgrade automatici del control plane non inizieranno senza una notifica preventiva. Tuttavia, la notifica non garantisce quanto segue:

    • Non è garantito che gli upgrade inizino a un'ora esatta, ma solo entro una finestra di inizio di 8 ore.
    • Non è garantito che GKE avvii l'upgrade entro questo periodo di tempo. Per maggiori informazioni, consulta Motivi per cui GKE potrebbe non eseguire un upgrade pianificato.
    • Non è garantito che GKE esegua automaticamente l'upgrade del control plane alla versione patch esatta, se nel canale di rilascio è presente una versione patch successiva come target di upgrade automatico della stessa versione secondaria.

Abilita upgrade pianificati

Abilita gli upgrade pianificati sostituendo CLUSTER_NAME con il nome del cluster:

gcloud beta container clusters update CLUSTER_NAME
   --enable-scheduled-upgrades

Dopo aver attivato gli upgrade pianificati, puoi visualizzare le notifiche con Cloud Logging o configurare le notifiche con Pub/Sub. Per saperne di più, consulta Notifiche del cluster.

Quando ricevi una notifica di upgrade pianificato, consulta la sezione Cosa fare quando ricevi una notifica di upgrade pianificato.

Disattivare gli upgrade pianificati

Disattiva gli upgrade pianificati sostituendo CLUSTER_NAME con il nome del cluster:

gcloud beta container clusters update CLUSTER_NAME
   --disable-scheduled-upgrades

Dopo aver disattivato questa funzionalità, GKE non ti invierà più notifiche sugli upgrade pianificati.

Recupera informazioni sugli upgrade di un cluster

Puoi ricevere informazioni proattive sugli upgrade di un cluster utilizzando la consoleGoogle Cloud o gcloud CLI.

Visualizzare informazioni sugli upgrade a livello di progetto

Per ottenere informazioni aggregate sugli upgrade dei cluster in un progetto, puoi utilizzare la dashboard Upgrade.

Nella console Google Cloud , vai alla dashboard Upgrade:

Vai a Upgrade

Le schede incluse in questa dashboard aggregano informazioni pertinenti sugli upgrade, ad esempio:

  • Stati degli upgrade recenti del control plane e dei nodi
  • Log delle notifiche del cluster per gli upgrade
  • Consigli relativi agli upgrade
  • Cronologie di fine del supporto per versioni secondarie specifiche
  • Il numero di cluster in ogni canale di rilascio

Visualizzare le informazioni sugli upgrade a livello di cluster

Console

  1. Nella console Google Cloud , vai alla pagina Cluster Kubernetes.

    Vai ai cluster Kubernetes

  2. Seleziona il nome del cluster per visualizzare la pagina Dettagli cluster.

  3. Nella pagina Dettagli cluster, consulta la sezione Upgrade del cluster.

gcloud

Esegui questo comando:

gcloud container clusters get-upgrade-info CLUSTER_NAME

Sostituisci CLUSTER_NAME con il nome del cluster.

Ottenere informazioni sugli upgrade per i node pool dei cluster Standard

Puoi ottenere visibilità sui singoli pool di nodi per i cluster Standard. Questa sezione non si applica ai cluster Autopilot, in cui GKE gestisce i nodi, quindi non ci sono pool di nodi da gestire.

Console

  1. Nella console Google Cloud , vai alla pagina Cluster Kubernetes.

    Vai ai cluster Kubernetes

  2. Fai clic sul nome del cluster per visualizzarne i dettagli.

  3. Fai clic sulla scheda Nodi.

  4. Nella sezione Pool di nodi, fai clic sul nome del pool di nodi per il quale vuoi ottenere informazioni sugli upgrade.

  5. Nella pagina Dettagli del pool di nodi, consulta la sezione Upgrade.

gcloud

Esegui questo comando:

gcloud container node-pools get-upgrade-info POOL_NAME
    --cluster=CLUSTER_NAME

Sostituisci POOL_NAME con il nome del pool di nodi.

Stato dell'upgrade automatico del cluster

Di seguito sono riportati i potenziali stati degli upgrade automatici per un cluster:

  • ACTIVE: uno stato di upgrade attivo.
  • UNKNOWN: lo stato dell'upgrade è sconosciuto.
  • MINOR_UPGRADE_PAUSED: gli upgrade della versione secondaria sono in pausa.
  • UPGRADE_PAUSED: tutti gli upgrade automatici sono in pausa.

Di seguito sono riportati i potenziali motivi per cui GKE mette in pausa gli upgrade automatici per un cluster:

  • MAINTENANCE_WINDOW: un periodo di manutenzione impedisce gli upgrade del cluster.
  • MAINTENANCE_EXCLUSION_: un motivo di pausa con questo prefisso indica che un'esclusione dalla manutenzione impedisce gli upgrade del cluster. Il suffisso indica l'ambito dell'esclusione dalla manutenzione, ad esempio MAINTENANCE_EXCLUSION_NO_UPGRADES.
  • CLUSTER_DISRUPTION_BUDGET: dopo determinate operazioni, come la creazione o gli upgrade dei cluster, questi richiedono un periodo di attesa per proteggere la stabilità e la disponibilità del cluster e delle relative applicazioni.
  • CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: Il cluster non rientra nel budget di interruzione del cluster per gli upgrade delle versioni secondarie.
  • SYSTEM_CONFIG: gli upgrade automatici sono temporaneamente in pausa per motivi tecnici o aziendali. Con questo stato, ti consigliamo di non eseguire un upgrade manuale a meno che non sia necessario.
  • AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: un motivo non specificato.

Trova informazioni sugli scenari comuni per gli upgrade dei cluster

Trova informazioni sugli scenari comuni che potresti incontrare durante la gestione degli upgrade dei cluster.

Scopri quando è previsto il prossimo upgrade del cluster

Per sapere quando è previsto il prossimo upgrade del cluster in modo da poter pianificare e qualificare l'upgrade alla nuova versione, utilizza le seguenti risorse:

  • Programma delle pubblicazioni: nel programma stimato per i canali di rilascio, trova la data stimata dell'upgrade automatico corrispondente alla versione secondaria e al canale di rilascio del cluster.
  • Visualizzare le informazioni sugli upgrade a livello di cluster: trova la destinazione di upgrade automatico del cluster.
  • Notifiche del cluster: GKE invia una notifica quando una nuova versione diventa disponibile in un canale. Dopo che una nuova versione diventa disponibile, con tempistiche che variano a seconda del canale, GKE la designa come target di upgrade automatico nel canale. Per visualizzare queste notifiche, filtra in base a UpgradeAvailableEvent quando visualizzi le notifiche dei cluster in Cloud Logging.
  • Note di rilascio: segui le note di rilascio per scoprire quando GKE imposta la nuova versione secondaria come target di upgrade automatico nel canale.

Trovare cosa blocca il prossimo upgrade del cluster

Per scoprire cosa blocca un upgrade in modo da poterlo sbloccare, trova lo stato dell'upgrade automatico del cluster. Se gli upgrade automatici sono in pausa, vedi il motivo. Utilizza uno dei seguenti metodi:

Trovare il momento in cui viene completato l'upgrade del cluster

Per sapere quando vengono completati gli upgrade del control plane e dei nodi del cluster in modo da verificare che i carichi di lavoro funzionino come previsto, utilizza le seguenti risorse:

Scopri quanto tempo è previsto per l'upgrade

Per sapere quanto tempo è previsto per l'upgrade, puoi trovare la durata degli upgrade precedenti ottenendo informazioni sugli upgrade a livello di cluster. Per esempi recenti, consulta la cronologia degli upgrade.

La durata di un upgrade dipende dal fatto che vengano eseguiti l'upgrade del control plane o dei nodi, dalla strategia di upgrade, dai budget di interruzione dei pod (PDB), dalle norme di manutenzione attive e da altri fattori.

Trovare quando la versione secondaria del cluster raggiunge la fine del supporto

GKE esegue automaticamente l'upgrade dei cluster che eseguono ancora versioni secondarie dopo la data di fine del supporto. Per saperne di più, consulta Upgrade automatici al termine dell'assistenza.

Per sapere quando la versione secondaria del tuo cluster raggiunge la fine del supporto, ad esempio per impostare un'esclusione della manutenzione o capire quando le API deprecate non saranno più utilizzabili, utilizza le seguenti risorse:

Passaggi successivi