Controllo delle versioni e assistenza di GKE

Questa pagina spiega il controllo delle versioni in Google Kubernetes Engine (GKE) e i criteri per il supporto delle versioni. Nel tempo, GKE esegue l'upgrade dei cluster alle versioni più recenti di Kubernetes. Per scoprire di più sul funzionamento degli upgrade, consulta Informazioni sugli upgrade dei cluster GKE.

Puoi visualizzare la pianificazione di implementazione e supporto delle versioni correnti nella programmazione delle release di GKE.

Supporto delle versioni

Il supporto di GKE per le versioni secondarie di Kubernetes si basa sulle norme open source di Kubernetes. GKE supporta una versione secondaria fornendo versioni patch della stessa release secondaria e, su base regolare, eseguendo automaticamente l'upgrade dei cluster alle patch più recenti.

In che modo Kubernetes supporta una versione secondaria

La community del software open source (OSS) Kubernetes rilascia una versione secondaria con nuove funzionalità e miglioramenti tre volte all'anno. Ogni ciclo di rilascio dura circa 15 settimane.

Kubernetes supporta ogni versione secondaria per 14 mesi. I bug principali e le vulnerabilità di sicurezza rilevati in una versione secondaria supportata vengono corretti con il rilascio di una versione patch ad hoc. A volte la community di Kubernetes rivede il calendario di assistenza delle versioni, se necessario. Per saperne di più, consulta la sezione Periodo di assistenza.

In che modo GKE supporta una versione secondaria

Dopo che Kubernetes rilascia una nuova versione secondaria, GKE la introduce prima nel canale Rapido. GKE fornisce versioni patch durante questo periodo, ma poiché il canale rapido fornisce le versioni GKE più recenti, queste versioni sono escluse dall' SLA di GKE e potrebbero contenere problemi senza soluzioni alternative note.

Dopo la disponibilità iniziale nel canale Rapido, GKE promuove la nuova versione secondaria nel canale Regolare. GKE fornisce fino a un totale di 24 mesi di assistenza per una versione secondaria dopo che è stata resa disponibile per la creazione di nuovi cluster nel canale Regolare. Questa assistenza include circa 14 mesi di assistenza standard e circa altri 10 mesi di assistenza estesa disponibili con il canale Esteso. Per conoscere la disponibilità di versioni secondarie specifiche, consulta la programmazione delle release di GKE.

Ciclo di vita delle versioni minori di GKE

Il ciclo di vita di una versione secondaria di GKE include i seguenti passaggi chiave:

1. Kubernetes rilascia una nuova versione secondaria.
2. GKE rende disponibile la nuova versione secondaria nel canale rapido.
3. GKE rende disponibile la nuova versione secondaria nel canale regolare (inizio del periodo di assistenza standard).
4. Durante il periodo di assistenza standard, GKE fornisce patch per la versione secondaria che includono nuove funzionalità, correzioni di sicurezza e correzioni di bug.
5. La versione secondaria raggiunge la fine dell'assistenza standard dopo circa 14 mesi in totale, entrando nel periodo di assistenza estesa. Dopo questa data, GKE fornisce patch di sicurezza per i cluster nel canale Extended.
6. La versione secondaria raggiunge la fine del supporto esteso, il che significa che non riceverà ulteriori patch di sicurezza.

Modifiche alla disponibilità delle versioni

GKE potrebbe rivedere la fine del supporto per le versioni GKE, a causa di cambiamenti nelle norme della community OSS di Kubernetes, della scoperta di vulnerabilità o di altri problemi tecnici che non possono essere ragionevolmente risolti. GKE potrebbe anche estendere le date di fine del supporto in corrispondenza di periodi di attività importanti come il Black Friday e il Cyber Monday.

GKE fornisce almeno 14 mesi di assistenza standard e fino a un totale di 24 mesi di assistenza con l'assistenza estesa.

Per ottenere le versioni più recenti disponibili, consulta le note di rilascio di GKE. GKE aggiorna regolarmente la pianificazione dei rilasci in base alle tempistiche degli upgrade automatici.

Periodi di disponibilità nel ciclo di vita delle versioni minori

GKE fornisce i seguenti periodi di disponibilità per una versione secondaria di Kubernetes:

Consulta la seguente tabella che riassume i periodi di disponibilità, descritti in dettaglio nelle sezioni successive:

Periodo di disponibilità solo in modalità Rapida

GKE rilascia prima una nuova versione secondaria nel canale rapido. La versione accumula prima l'utilizzo e dimostra la stabilità tra i cluster di questo canale prima di essere promossa al canale Regolare. Solo i cluster registrati nel canale Rapido possono eseguire una nuova versione secondaria durante questo periodo di disponibilità.

Questo periodo dura in genere circa 1-2 mesi, ma le tempistiche esatte dipendono da ogni versione secondaria. Per maggiori dettagli, consulta la Pianificazione stimata per i canali di rilascio.

Periodo di assistenza standard

Il periodo di assistenza standard per una versione secondaria di GKE inizia quando la versione viene rilasciata nel canale regolare. Tutti i cluster GKE, indipendentemente dalla registrazione al canale di rilascio, possono eseguire una versione secondaria con assistenza standard. Durante questo periodo, GKE esegue regolarmente l'upgrade dei cluster alle nuove versioni patch, che includono nuove funzionalità, correzioni di sicurezza e correzioni di bug.

GKE esegue automaticamente l'upgrade dei cluster nel seguente modo:

• Rapido, Regolare, Stabile, Nessun canale: upgrade automatici ad altre versioni secondarie supportate o versioni delle patch della stessa versione secondaria.
• Esteso: GKE esegue automaticamente l'upgrade solo alle versioni con patch più recenti della stessa versione secondaria.

Per i cluster non registrati nel canale di rilascio esteso, GKE eseguirà automaticamente l'upgrade dei cluster alla versione secondaria supportata successiva prima della fine del supporto standard, in base alla pianificazione del canale di rilascio del cluster. Per maggiori dettagli, consulta la Pianificazione stimata per i canali di rilascio. Tuttavia, GKE non esegue l'upgrade dei cluster durante questo periodo se utilizzano API o funzionalità ritirate. Puoi utilizzare un'esclusione per la manutenzione per impedire temporaneamente a GKE di eseguire l'upgrade del cluster alla versione secondaria successiva.

Fine del supporto standard (in precedenza fine del ciclo di vita)

Al termine del periodo di assistenza standard, la versione secondaria raggiunge la fine del supporto standard (in precedenza fine del ciclo di vita) e non è più supportata e non è più disponibile per tutti i cluster non registrati nel canale esteso.

I clienti che utilizzano una versione in fase di ritiro vengono informati tramite un'email inviata al contatto del progetto prima della fine del supporto di una versione. GKE inizia inoltre a eseguire gradualmente l'upgrade automatico dei nodi (indipendentemente dall'attivazione dell'upgrade automatico) che eseguono versioni non supportate per motivi di sicurezza e compatibilità, poiché non vengono fornite nuove patch di sicurezza o correzioni di bug per le versioni di fine supporto. Prima di contattare l'assistenza clienti Google Cloud per eventuali problemi relativi a un cluster o a nodi in cui è in esecuzione una versione non supportata, devi prima eseguire l'upgrade del cluster e dei nodi a una versione supportata.

Le versioni secondarie di GKE che hanno raggiunto la fine del supporto non ricevono più patch di sicurezza o correzioni di bug. Le versioni patch di una versione secondaria che ha raggiunto la fine del supporto non sono supportate e non sono disponibili. GKE esegue automaticamente l'upgrade di tutti i cluster non registrati nel canale Extended. Per saperne di più, consulta Upgrade automatici al termine del supporto.

Periodo di supporto esteso

Al termine dell'assistenza standard, la versione secondaria raggiunge il periodo di assistenza estesa (dal mese 15 al mese 24). Durante questo periodo, GKE fornisce patch per correzioni di sicurezza, inclusi i seguenti tipi di correzioni:

• Patch di sicurezza di livello medio, alto e critico per i componenti principali di Kubernetes, il sistema operativo dei nodi e i container gestiti da Google in bundle con la versione del cluster GKE.
• Per Container-Optimized OS, il ritiro del sistema operativo del nodo potrebbe avvenire prima del termine del supporto esteso per la versione secondaria di GKE o introdurre modifiche incompatibili. Per scoprire di più su come GKE continua a fornire assistenza, consulta Aggiornamenti di Container-Optimized OS durante il periodo di assistenza esteso.

Verso la fine del supporto esteso, GKE inizia a eseguire l'upgrade dei cluster alla versione secondaria successiva. GKE non eseguirà l'upgrade dei cluster se utilizzano API o funzionalità ritirate. Puoi utilizzare un'esclusione per la manutenzione per impedire temporaneamente a GKE di eseguire l'upgrade del tuo cluster alla versione minore successiva.

Fine del supporto esteso

Al termine del periodo di supporto esteso, GKE non fornisce patch per le correzioni di sicurezza e la versione secondaria è considerata non supportata. GKE esegue l'upgrade dei cluster in cui è ancora in esecuzione la versione secondaria non supportata alla versione secondaria successiva, indipendentemente dall'utilizzo da parte del cluster di API o funzionalità ritirate.

Upgrade automatici al termine del supporto

GKE pianifica gli upgrade automatici dei cluster da una versione secondaria alla versione secondaria supportata successiva prima che la versione secondaria raggiunga la fine del supporto. Le tempistiche di questo upgrade dipendono dalla programmazione del canale di rilascio del cluster. Per maggiori dettagli, consulta la Pianificazione stimata per i canali di rilascio. Ad esempio, l'upgrade dei cluster registrati nel canale stabile alla versione secondaria successiva viene eseguito più vicino alla fine del supporto standard rispetto ai cluster registrati nel canale Rapido.

Durante il periodo di assistenza standard e il periodo di assistenza esteso per i cluster registrati nel canale esteso, puoi impedire questo upgrade della versione secondaria con un'esclusione di manutenzione e GKE non eseguirà l'upgrade dei cluster utilizzando API o funzionalità ritirate.

Tuttavia, al termine dell'assistenza standard o al termine del supporto esteso per i cluster registrati nel canale esteso, GKE esegue automaticamente l'upgrade dei cluster alla versione secondaria supportata successiva per garantire che il cluster rimanga efficiente, disponibile e sicuro.

Ogni versione di GKE è supportata per 14 mesi di assistenza standard e per 24 mesi di assistenza totale, incluso il supporto esteso. Non puoi mantenere il tuo cluster su una versione a tempo indeterminato, perché l'utilizzo di una versione GKE non supportata comporta rischi significativi per la sicurezza, l'affidabilità e la compatibilità, in quanto GKE non fornisce patch di sicurezza o correzioni di bug per le versioni con il ciclo di vita terminato. GKE non può impegnarsi a fornire patch o aggiornamenti per le versioni al termine del supporto.

GKE esegue l'upgrade del cluster nel seguente modo:

• Control plane: GKE esegue automaticamente l'upgrade dei control plane dei cluster alle versioni supportate quando la versione del control plane non è più disponibile per la creazione di nuovi cluster.
• Nodi: GKE esegue automaticamente l'upgrade dei nodi che eseguono una versione non supportata dopo che la versione ha raggiunto la fine del supporto per garantire l'integrità e l'allineamento del cluster con le norme di scostamento della versione GKE. Per i nodi che eseguono versioni non supportate è solitamente pianificato un upgrade automatico a una versione supportata entro un mese dalla data di fine del supporto. Per i nodi che eseguono versioni non supportate, l'upgrade potrebbe non essere eseguito immediatamente al fine del ciclo di vita della versione e le tempistiche effettive possono variare a discrezione di Google.

Identificare i cluster che eseguono una versione secondaria dopo la fine del supporto standard

GKE identifica i cluster che soddisfano entrambe le seguenti condizioni:

• Il control plane esegue una versione secondaria che ha raggiunto la fine dell'assistenza standard.
• Il cluster non è registrato nel canale esteso.

GKE consiglia di eseguire l'upgrade di questi cluster a causa dei rischi associati all'esecuzione di una versione secondaria non supportata. GKE esegue l'upgrade dei cluster alla versione secondaria supportata successiva se la versione esistente non è supportata nel canale di rilascio del cluster.

GKE fornisce queste indicazioni con un approfondimento e un consiglio tramite il servizio di consigli. Queste indicazioni non si applicano ai cluster registrati nel canale esteso, che possono continuare a eseguire una versione secondaria fino alla fine del supporto esteso. Per scoprire di più su come gestire gli approfondimenti e i consigli di Recommender, consulta Ottimizzare l'utilizzo di GKE con approfondimenti e consigli.

Per trovare i cluster in cui il piano di controllo esegue una versione oltre il termine del supporto, puoi utilizzare uno dei seguenti metodi:

• Utilizza la console Google Cloud.
• Utilizza l'interfaccia a riga di comando gcloud o l'API Recommender, specificando il CLUSTER_VERSION_END_OF_LIFE tipo di motore per suggerimenti.

Per istruzioni, scopri come visualizzare approfondimenti e consigli.

Per implementare questo consiglio, esegui l'upgrade del piano di controllo del cluster a una versione secondaria supportata. Per le versioni secondarie supportate e le date di fine dell'assistenza, consulta la programmazione delle release di GKE. In alternativa, modifica il cluster in modo che appartenga al canale Extended se vuoi continuare a utilizzare la versione minore esistente fino al termine del supporto esteso.

Aggiornamenti di Container-Optimized OS durante il periodo di supporto esteso

Durante il periodo di supporto esteso per una versione secondaria di GKE, GKE fornisce upgrade delle patch per il cluster, che potrebbero includere aggiornamenti Container-Optimized OS.

La release LTS di Container-Optimized OS raggiunge la fine del supporto prima della versione secondaria

La release LTS di Container-Optimized OS potrebbe raggiungere il termine del supporto prima del termine del supporto esteso per la versione secondaria che utilizza la release. In questo scenario, GKE utilizza la prossima release LTS di Container-Optimized OS disponibile per gli upgrade futuri delle patch, se possibile. GKE esegue questo aggiornamento prima che la release LTS di Container-Optimized OS utilizzata dalla versione secondaria dei nodi raggiunga la fine del supporto. Gli amministratori del cluster devono valutare se eseguire l'upgrade alla versione successiva della patch GKE, che contiene una nuova release LTS Container-Optimized OS, o rimanere nella stessa versione della patch GKE per non ricevere aggiornamenti nel sistema operativo del nodo e non ricevere nemmeno le patch di sicurezza per i componenti di base di Kubernetes in bundle con la versione del cluster GKE.

La prossima release LTS di Container-Optimized OS introduce modifiche incompatibili con la versione minore esistente

La prossima release LTS di Container-Optimized OS potrebbe introdurre modifiche incompatibili con i componenti di sistema di GKE e GKE non può fornire una versione con patch con gli aggiornamenti del sistema operativo del nodo. Gli amministratori dei cluster devono valutare se eseguire l'upgrade alla versione minore GKE successiva o prendere in considerazione gli stessi compromessi descritti nel paragrafo precedente.

Schema di controllo delle versioni

GKE aggiunge una versione della patch GKE allo standard di settore con versione semantica di Kubernetes(x.y.z-gke.N):

Versione principale di Kubernetes (x)

In genere, le versioni principali vengono incrementate se nell'API pubblica vengono introdotte modifiche non compatibili con le versioni precedenti. Una versione principale incrementa la versione di Kubernetes da x.y a x+1.y.

Versione secondaria di Kubernetes (y)

Kubernetes rilascia una nuova versione secondaria tre volte all'anno. Ogni ciclo di rilascio dura circa 15 settimane. Le API ritirate possono essere rimosse con una nuova versione secondaria, ad esempio con la versione 1.22. Una versione minore incrementa la versione di Kubernetes da 1.y a 1.y+1; ad esempio, Kubernetes 1.32 è la release minore che segue Kubernetes 1.31.

Uscita della patch Kubernetes (z)

In genere, ogni settimana diventano disponibili nuove release patch di Kubernetes (ad esempio 1.32.6) da utilizzare con GKE. Le release delle patch vengono implementate in modo incrementale in ogni zona.

Rilascio della patch GKE (-gke.N)

Una release di patch con il suffisso -gke.N (ad esempio 1.32.6-gke.N) può includere aggiornamenti della sicurezza e correzioni di bug per GKE insieme al software Kubernetes upstream open source. Questi aggiornamenti o correzioni sono necessari per la compatibilità e l'interoperabilità con Google Cloud.

Controllare le versioni disponibili e predefinite

Per informazioni sulle versioni disponibili, consulta le note di rilascio di GKE.

Puoi anche controllare quali versioni di Kubernetes sono disponibili e predefinite in una determinata zona dalla console Google Cloud o utilizzando Google Cloud CLI.

Utilizzare la console Google Cloud per controllare le versioni

Per visualizzare le versioni predefinite e disponibili:

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Fai clic su add_box Crea.

3. Scegli la modalità cluster Standard, quindi fai clic su Configura.

4. Nella sezione Tipo di località, scegli un tipo di località e la località prevista per il cluster.

5. Nella sezione Versione del piano di controllo, seleziona un canale di rilascio. Per il canale vengono elencate tutte le versioni attualmente disponibili. La versione predefinita viene selezionata automaticamente.

Utilizzare gcloud CLI per controllare le versioni

Per vedere quali versioni sono disponibili e quali sono predefinite, esegui uno dei seguenti comandi gcloud per il tipo di cluster. Ogni scheda fornisce comandi per controllare le versioni per un canale di rilascio specifico o per nessun canale (in precedenza statico).

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=RAPID" \
   --format="yaml(channels.channel,channels.defaultVersion)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=RAPID" \
   --format="yaml(channels.channel,channels.validVersions)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=REGULAR" \
   --format="yaml(channels.channel,channels.defaultVersion)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=REGULAR" \
   --format="yaml(channels.channel,channels.validVersions)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=STABLE" \
   --format="yaml(channels.channel,channels.defaultVersion)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=STABLE" \
   --format="yaml(channels.channel,channels.validVersions)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=EXTENDED" \
   --format="yaml(channels.channel,channels.defaultVersion)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --flatten="channels" \
   --filter="channels.channel=EXTENDED" \
   --format="yaml(channels.channel,channels.validVersions)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --format="yaml(defaultClusterVersion)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --format="yaml(validMasterVersions)" \
   --location=COMPUTE_LOCATION

gcloud container get-server-config \
   --format="yaml(validNodeVersions)" \
   --location=COMPUTE_LOCATION

Specificare la versione del cluster

Questa sezione si applica solo ai cluster creati in modalità Standard.

Quando crei o esegui l'upgrade di un cluster utilizzando gcloud CLI, puoi specificare una versione del cluster utilizzando il flag --cluster-version. Puoi utilizzare una versione specifica, ad esempio 1.9.7-gke.N. Puoi anche utilizzare un alias di versione:

• latest: specifica la versione Kubernetes supportata più recente attualmente disponibile su GKE nella zona o nella regione del cluster.
• 1.X: specifica la release della patch+gke.N valida più recente nella versione minore 1.X
• 1.X.Y: specifica la patch gke.N valida più recente nella release della patch 1.X.Y.
• -: per i control plane del cluster, specifica la versione Kubernetes predefinita per i control plane. Per gli upgrade dei nodi, specifica la versione in esecuzione del piano di controllo del cluster.

La creazione o l'upgrade di un cluster specificando la versione latest non fornisce upgrade automatici. Attiva gli upgrade automatici dei nodi per assicurarti che i nodi del tuo cluster siano aggiornati con l'ultima versione stabile.

Specifica della versione del nodo

Questa sezione si applica solo ai cluster creati in modalità standard. Nei cluster Autopilot, l'upgrade dei nodi alla versione del piano di controllo avviene automaticamente e non puoi specificare una versione.

Quando crei o esegui l'upgrade di un pool di nodi, puoi specificarne la versione. Per impostazione predefinita, i nodi eseguono la stessa versione di GKE del piano di controllo. I nodi non possono essere meno recenti dei piani di controllo di più di due versioni secondarie.

A rare eccezioni, le versioni dei nodi rimangono disponibili anche se la versione del cluster non è più disponibile.

Criteri di sfasamento delle versioni GKE

Il criterio di sfasamento della versione GKE garantisce che un cluster GKE mantenga la compatibilità tra il piano di controllo e i nodi. In un cluster GKE, i nodi possono corrispondere alla versione del piano di controllo o eseguire fino a due versioni secondarie precedenti al piano di controllo.

I nodi non possono eseguire versioni successive a quella del piano di controllo. Ad esempio, se il piano di controllo del cluster esegue la versione 1.31, i nodi possono eseguire le seguenti versioni: 1.31, 1.30 o 1.29, ma non 1.28 o versioni precedenti. La versione dei nodi non può essere successiva a quella del piano di controllo a causa del disallineamento delle versioni OSS di Kubernetes.

Per garantire la supportabilità e l'affidabilità, i nodi devono utilizzare una versione supportata, indipendentemente dal fatto che segua uno scostamento di versione valido.

Identificare i cluster con un disallineamento delle versioni non supportato

GKE identifica i cluster in cui i nodi eseguono una versione incompatibile con il piano di controllo a causa di un disallineamento delle versioni. GKE consiglia di eseguire l'upgrade dei nodi che eseguono questa versione non supportata, fornendo queste indicazioni con un'analisi e un consiglio tramite il servizio Recommender. Per scoprire di più su come gestire gli approfondimenti e i consigli di Recommender, consulta Ottimizzare l'utilizzo di GKE con approfondimenti e consigli.

Per trovare cluster con uno scostamento della versione non supportato, puoi utilizzare uno dei seguenti metodi:

• Utilizza la console Google Cloud.
• Utilizza l'interfaccia a riga di comando gcloud o l'API Recommender, specificando il CLUSTER_VERSION_SKEW_UNSUPPORTED tipo di motore per suggerimenti.

Per istruzioni, scopri come visualizzare approfondimenti e consigli.

Per implementare questo consiglio, esegui l'upgrade di tutti i nodi che eseguono una versione secondaria precedente di più di due versioni secondarie rispetto alla versione del piano di controllo.

Supporto per l'omissione delle versioni secondarie

GKE non consente di saltare le versioni secondarie per il piano di controllo del cluster, ma puoi saltare le versioni con patch. I nodi worker possono saltare le versioni secondarie. Ad esempio, è possibile eseguire l'upgrade di un pool di nodi dalla versione 1.32 alla 1.34 ignorando la versione 1.33.

Per eseguire l'upgrade di un cluster a più versioni secondarie, esegui l'upgrade del piano di controllo una versione secondaria alla volta ed esegui l'upgrade dei nodi worker alla stessa versione ogni volta. Ad esempio, per eseguire l'upgrade del piano di controllo dalla versione 1.32 alla versione 1.34, esegui prima l'upgrade dalla versione 1.32 alla versione 1.33, poi esegui l'upgrade dei nodi worker in modo che corrispondano alla versione del piano di controllo e ripeti la procedura per eseguire l'upgrade dalla versione 1.33 alla versione 1.34.

L'upgrade dei nodi worker in modo che corrispondano alle versioni ti aiuta a evitare un disallineamento delle versioni non supportato. Ti consigliamo di evitare di saltare le versioni, se possibile. Saltare le versioni dei nodi worker in genere implica un ambito di test più ampio che, sebbene gestibile, richiede maggiore considerazione.

In alternativa, puoi creare un nuovo cluster con la versione che preferisci e eseguire nuovamente il deployment dei carichi di lavoro.