Visualizza 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:

• 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 di 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 del supporto. 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 Google Kubernetes Engine
• Se vuoi utilizzare Google Cloud CLI per questa attività, installala e poi inizializzala. Se hai già installato gcloud CLI, scarica l'ultima versione eseguendo gcloud components update.

Ottenere informazioni sugli upgrade di un cluster

Puoi ottenere informazioni 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

gcloud container clusters get-upgrade-info CLUSTER_NAME

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.

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

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 delle versioni secondarie 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 per 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 raffreddamento 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 dei 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.

Trovare 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:

• Pianificazione delle release: nella pianificazione stimata 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:

• Visualizzare le informazioni sugli upgrade a livello di progetto (anteprima). Fai clic sulla scheda Upgrade, dove puoi visualizzare la tabella Stati degli upgrade. Cerca il tuo cluster nella tabella e visualizza la colonna Upgrade automatico.
• Ottieni informazioni sugli upgrade a livello di cluster per trovare lo stato dell'upgrade automatico del cluster.

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:

• Notifiche del cluster: GKE invia una notifica al termine di un'operazione di upgrade di un cluster. Per visualizzare queste notifiche, filtra in base a UpgradeInfoEvent quando visualizzi le notifiche del cluster in Cloud Logging.
• Dashboard degli upgrade (anteprima): vai alla tabella Stati degli upgrade nella consoleGoogle Cloud . Trova il tuo cluster. Se nella colonna Stato è indicato Eseguito l'upgrade, controlla la colonna Ultimo aggiornamento per sapere quando è stato completato l'upgrade.
• Visualizzare le informazioni sugli upgrade a livello di cluster: utilizza l'interfaccia alla gcloud CLI per trovare la cronologia degli upgrade del cluster, che include gli upgrade recenti.

Scopri la durata prevista dell'upgrade

Per scoprire la durata prevista dell'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 aggiornati il control plane o i 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 in cui sono ancora in esecuzione versioni secondarie dopo la data di fine del supporto. Per saperne di più, consulta Upgrade automatici alla fine del supporto.

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

• Programma di rilascio: nella pianificazione stimata per i canali di rilascio, trova la data di fine del supporto corrispondente alla versione secondaria e al canale di rilascio del tuo cluster. Per i cluster che non si trovano nel canale esteso, consulta la data di fine del supporto standard. Per i cluster nel canale esteso, consulta la data di fine del supporto esteso.
• Notifiche del cluster: GKE invia una notifica quando un cluster esegue una versione secondaria alla fine del supporto o in prossimità. Per visualizzare queste notifiche, filtra in base a UpgradeInfoEvent quando visualizzi le notifiche del cluster in Cloud Logging.
• Approfondimenti e suggerimenti: GKE ti informa quando il tuo cluster esegue una versione secondaria dopo la fine dell'assistenza standard. Per maggiori informazioni, vedi Identificare i cluster che eseguono una versione secondaria oltre la fine dell'assistenza standard.
• Ottenere informazioni sugli upgrade a livello di cluster: Trova la data di fine del supporto della versione secondaria del cluster.
• Dashboard degli upgrade (anteprima): la dashboard Upgrade include una sezione Fine del supporto della versione con versioni specifiche e i giorni rimanenti fino alla fine del supporto.

Passaggi successivi

• Programmazione delle release di GKE
• Note di rilascio di GKE
• Notifiche dei cluster