Controllo delle versioni e assistenza di GKE

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

Puoi visualizzare l'implementazione delle versioni attuali e la programmazione dell'assistenza nella programmazione delle release di GKE.

Nota: l'API Kubernetes ha un controllo delle versioni separato da Kubernetes stesso. Consulta la documentazione dell'API Kubernetes per informazioni sul controllo delle versioni dell'API Kubernetes.

Supporto delle versioni secondarie

Il supporto di GKE per le versioni secondarie di Kubernetes si basa sulle norme open source di Kubernetes. Per supportare le versioni secondarie disponibili durante il loro ciclo di vita, GKE fornisce versioni patch ed esegue regolarmente upgrade automatici dei cluster per applicare queste patch più recenti. Per informazioni su come GKE supporta le versioni patch, consulta Supporto delle versioni patch.

Oltre a supportare le versioni secondarie disponibili, GKE fornisce anche versioni patch alpha della versione secondaria successiva nel ciclo di rilascio di Kubernetes fino a quattro mesi prima che la versione secondaria diventi disponibile per tutti i cluster nel canale rapido. Queste versioni alpha sono disponibili solo per i cluster alpha di GKE nelcanale rapidod e sono destinate agli early adopter che vogliono sperimentare le funzionalità future.

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. La community di Kubernetes a volte rivede il calendario di assistenza delle versioni, se necessario. Per saperne di più, consulta Periodo di assistenza.

Come GKE supporta una versione secondaria

Prima del rilascio di una nuova versione secondaria stabile, il progetto Kubernetes rilascia versioni patch sperimentali e instabili di quella versione secondaria. GKE introduce versioni patch alpha basate su queste versioni sperimentali nel canale Rapido solo per i cluster GKE alpha. Analogamente ad altre versioni patch nel canale rapidod, le versioni alpha sono escluse dall'SLA di GKE.

Dopo che Kubernetes rilascia la nuova versione secondaria stabile, GKE rimuove le versioni alpha di quella versione secondaria e rende disponibili le versioni patch per quella versione secondaria a qualsiasi cluster nel canale rapido. Poiché il canale rapido fornisce le versioni patch di GKE più recenti, queste versioni sono escluse dallo SLA di GKE e potrebbero contenere problemi senza soluzioni alternative note.

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

Ciclo di vita delle versioni secondarie di GKE

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

1. Fino a quattro mesi prima della data di rilascio di una versione secondaria, GKE rende disponibili le versioni patch alpha per quella versione secondaria nel canale rapido solo per i cluster alpha.
2. Kubernetes rilascia la nuova versione secondaria.
3. GKE rende disponibile la nuova versione secondaria nel canale Rapid e rimuove le versioni patch alpha esistenti per quella versione secondaria.
4. GKE rende disponibile la nuova versione secondaria nel canale Regular (inizio del periodo di assistenza standard).
5. Durante il periodo di assistenza standard, GKE fornisce patch per la versione secondaria che includono nuove funzionalità, correzioni di sicurezza e correzioni di bug.
6. La versione secondaria raggiunge la fine dell'assistenza standard dopo circa 14 mesi in totale, entrando nel periodo di assistenza estesa. Dopo questo periodo, GKE fornisce patch di sicurezza per i cluster nel canale Extended.
7. 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 Kubernetes OSS, della scoperta di vulnerabilità o di altri problemi tecnici che non possono essere risolti in modo ragionevole. GKE potrebbe anche estendere le date di fine del supporto in prossimità di periodi aziendali chiave 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 ultime versioni disponibili, consulta le note di rilascio di GKE. GKE aggiorna regolarmente la pianificazione delle release per riflettere le tempistiche degli upgrade automatici.

Periodi di disponibilità nel ciclo di vita della versione secondaria

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à	Intervallo di tempo approssimativo dalla disponibilità del canale regolare	Quale supporto fornisce GKE	Accesso a questo periodo di disponibilità
Periodo di disponibilità della versione alpha	Mese -5 fino al mese -1	GKE introduce nuove versioni patch alpha nel canale rapido fino all'inizio del periodo di disponibilità solo rapida. Le versioni delle patch alpha sono disponibili solo per i cluster alpha, non prevedono assistenza tecnica o SLA e hanno un'alta probabilità di contenere problemi. Quando la versione secondaria diventa disponibile per tutti i cluster nel canale rapido al termine del periodo di disponibilità solo alpha, GKE rimuove tutte le versioni alpha dal canale rapido.	Solo canale rapido (richiede cluster alpha)
Periodo di disponibilità solo per Rapid	Mese -1 al mese 0	GKE rende disponibile la versione secondaria a tutti i cluster nel canale rapido fornendo versioni patch con nuove funzionalità, correzioni di sicurezza e correzioni di bug. Tuttavia, queste versioni sono escluse dall'SLA di GKE e potrebbero contenere problemi senza soluzioni alternative note. GKE rimuove anche eventuali versioni alpha disponibili per quella versione secondaria dal canale Rapido.	Solo canale rapido
Periodo di assistenza standard	Mese 1 - Mese 14	GKE fornisce versioni patch con nuove funzionalità, correzioni di sicurezza e correzioni di bug.	Rapido, Regolare, Stabile, Esteso, Nessun canale (ritirato)
Periodo di assistenza esteso	Dal 15° al 24° mese	GKE fornisce versioni patch con correzioni di sicurezza.	Solo canale esteso (richiede una tariffa aggiuntiva per cluster, vedi Ricevere assistenza a lungo termine con il canale esteso)

Periodo di disponibilità della versione alpha

GKE rilascia le versioni patch alpha di una versione secondaria imminente nel canale rapido fino a quattro mesi prima del rilascio di quella versione secondaria. Le versioni alpha sono disponibili solo per i cluster alpha. GKE rilascia versioni patch alpha aggiuntive nelle settimane successive e in genere mantiene da una a tre versioni alpha attive.

Questo periodo dura fino a quando GKE non rilascia la versione secondaria stabile nel canale rapido. Dopo la release stabile, GKE rimuove tutte le versioni delle patch alpha per quella versione secondaria dal canale rapido perché sono disponibili versioni delle patch stabili da installare.

Periodo di disponibilità solo di Rapid

GKE rilascia prima una nuova versione secondaria nel canale rapido. La versione accumula prima l'utilizzo e dimostra stabilità nei 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 in genere dura circa 1-2 mesi, ma la tempistica esatta dipende da ogni versione secondaria. Per maggiori dettagli, consulta la sezione Programma stimato 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 supporto standard. Durante questo periodo, GKE esegue automaticamente l'upgrade dei cluster a 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 (ritirato): upgrade automatici ad altre versioni secondarie supportate o versioni delle patch della stessa versione secondaria.
• Esteso: GKE esegue automaticamente l'upgrade solo alle versioni patch più recenti della stessa versione secondaria.

Per i cluster non registrati nel canale di rilascio esteso, GKE alla fine esegue automaticamente l'upgrade dei cluster alla successiva versione secondaria supportata prima della fine dell'assistenza standard, in base alla pianificazione del canale di rilascio del cluster. Per maggiori dettagli, consulta la sezione Programma stimato per i canali di rilascio. Tuttavia, GKE non esegue l'upgrade dei cluster durante questo periodo se utilizzano funzionalità o API deprecate. Puoi utilizzare un'esclusione dalla 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)

Nota: GKE in precedenza utilizzava il termine fine del ciclo di vita per indicare la data di fine dell'assistenza standard. Con l'introduzione del supporto esteso, abbiamo aggiornato questo termine per riflettere i diversi periodi di supporto per una versione secondaria di GKE.

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

I clienti che utilizzano una versione alla fine del supporto ricevono una notifica via email al contatto del progetto prima della fine del supporto di una versione. GKE inizia anche a eseguire l'upgrade automatico graduale dei nodi (indipendentemente dall'attivazione dell'upgrade automatico) in esecuzione su versioni non supportate per motivi di sicurezza e compatibilità perché non vengono fornite nuove patch di sicurezza o correzioni di bug per le versioni alla fine del supporto. Prima di contattare l'assistenza clienti Google Cloud per eventuali problemi con un cluster o con nodi che eseguono 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 alla fine del supporto.

Periodo di supporto esteso

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

• Patch di sicurezza medie, alte e critiche per i componenti principali di Kubernetes, il sistema operativo del nodo e i container gestiti da Google inclusi nella versione del cluster GKE.
• Per Container-Optimized OS, la fine del supporto del sistema operativo del nodo potrebbe verificarsi prima della fine 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 l'upgrade dei cluster alla versione secondaria successiva. GKE non esegue l'upgrade dei cluster che utilizzano API o funzionalità deprecate. Puoi utilizzare un'esclusione della manutenzione per impedire temporaneamente a GKE di eseguire l'upgrade del cluster alla successiva versione secondaria.

Fine del supporto esteso

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

Upgrade automatici al termine del supporto

GKE pianifica gli upgrade automatici dei cluster da una versione secondaria alla successiva supportata prima che la versione secondaria raggiunga la fine del supporto. La tempistica di questo upgrade dipende dalla pianificazione del canale di rilascio del cluster. Per maggiori dettagli, consulta la sezione Programma stimato per i canali di rilascio. Ad esempio, i cluster registrati nel canale stabile vengono sottoposti all'upgrade alla versione secondaria successiva 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 esclusioni di manutenzione a livello di cluster oppure scegliendo i tipi di upgrade che GKE esegue in una sequenza di implementazione. Inoltre, GKE non esegue l'upgrade dei cluster che utilizzano funzionalità o API deprecate.

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

Ogni versione secondaria di GKE è supportata per 14 mesi di assistenza standard e per 24 mesi di assistenza totale, inclusa l'assistenza estesa. Non puoi mantenere il cluster su una versione secondaria a tempo indeterminato, perché l'utilizzo di un cluster che utilizza una versione secondaria di 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 secondarie alla fine del supporto. GKE non può impegnarsi a fornire patch o aggiornamenti per le versioni secondarie al termine del supporto.

GKE esegue l'upgrade del cluster nel seguente modo:

• Control plane: GKE esegue automaticamente l'upgrade dei control plane del 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 secondaria non supportata dopo che la versione secondaria ha raggiunto la fine del supporto per garantire l'integrità del cluster e l'allineamento con le norme di asimmetria delle versioni di GKE. I nodi che eseguono versioni secondarie non supportate vengono in genere pianificati per un upgrade automatico a una versione secondaria supportata entro un mese dalla data di fine del supporto. I nodi che eseguono versioni secondarie non supportate potrebbero non essere sottoposti a upgrade immediatamente alfine del ciclo di vitaa della versione secondaria e i tempi effettivi possono variare a discrezione di Google.

Allo stesso modo, GKE esegue l'upgrade dei control plane dei cluster che non sono stati aggiornati a una nuova versione entro 90 giorni. Per saperne di più, consulta Norme relative alle patch del piano di controllo di 90 giorni.

Prevenzione temporanea e di emergenza degli upgrade automatici al termine del supporto

Come misura temporanea, da utilizzare solo in caso di emergenze in cui non sono disponibili altre opzioni, puoi ritardare gli upgrade automatici al termine del supporto fino a 90 giorni dopo la data di fine del supporto configurando un'esclusione dalla manutenzione con l'ambito predefinito "Nessun upgrade". Non consigliamo questa pratica a causa dei rischi associati all'esecuzione di una versione non supportata. Al termine dell'esclusione dalla manutenzione, GKE esegue l'upgrade del cluster.

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 successiva versione secondaria supportata se la versione esistente non è supportata nel canale di rilascio del cluster.

GKE fornisce queste indicazioni con un insight e un suggerimento tramite il servizio Recommender. 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 approfondimenti e suggerimenti di Recommender, consulta Ottimizzare l'utilizzo di GKE con approfondimenti e suggerimenti.

Per trovare i cluster in cui il control plane esegue una versione oltre la fine del supporto, puoi utilizzare uno dei seguenti modi:

• Utilizza la console Google Cloud .
• Utilizza gcloud CLI o l'API Recommender specificando il CLUSTER_VERSION_END_OF_LIFE sottotipo di motore per suggerimenti.

Per istruzioni, scopri come visualizzare approfondimenti e consigli.

Per implementare questo consiglio, esegui l'upgrade del control plane del cluster a una versione secondaria supportata. Per le versioni secondarie supportate e le date di fine del supporto, consulta la programmazione delle release di GKE. In alternativa, passa il cluster al canale Extended se vuoi continuare a utilizzare la versione secondaria esistente fino alla fine del supporto esteso.

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

Durante il periodo di supporto esteso per una versione secondaria di GKE, GKE fornisce upgrade delle patch per il cluster. Questi upgrade delle patch potrebbero includere aggiornamenti di Container-Optimized OS alla milestone di Container-Optimized OS esistente utilizzata dalla versione secondaria di GKE. Le versioni secondarie di GKE in genere utilizzano un traguardo durante il periodo di assistenza standard fino all'inizio del periodo di supporto esteso.

Tuttavia, il traguardo di Container-Optimized OS utilizzato dalla versione secondaria di GKE raggiunge la fine del supporto, in genere durante il periodo di assistenza esteso per una versione secondaria di GKE. Quando si verifica questo problema, GKE crea tutte le versioni patch GKE successive con la successiva milestone di Container-Optimized OS. Per scoprire di più sui cicli di vita delle milestone, consulta lo schema di controllo delle versioni per Container-Optimized OS.

Esamina lo scenario seguente per capire come procedono gli upgrade automatici e quali decisioni devono prendere gli amministratori del cluster quando GKE non può più introdurre aggiornamenti di Container-Optimized OS nella stessa milestone per una versione secondaria di GKE.

La milestone di Container-Optimized OS raggiunge la fine del supporto prima della fine del supporto esteso della versione secondaria

Il traguardo di Container-Optimized OS raggiunge la propria fine del supporto prima della fine del supporto esteso per la versione secondaria che utilizza il traguardo. In questo scenario, GKE utilizza la prossima milestone disponibile di Container-Optimized OS per i futuri upgrade delle patch. GKE esegue questo aggiornamento prima che la milestone di Container-Optimized OS utilizzata dalla versione secondaria raggiunga la fine del supporto.

Gli amministratori del cluster devono valutare se eseguire l'upgrade dei nodi worker del cluster, perché GKE non eseguirà automaticamente l'upgrade di questi nodi alla versione patch successiva con il nuovo traguardo. Puoi eseguire l'upgrade manuale dei nodi alla successiva versione patch di GKE, che contiene un nuovo traguardo. In alternativa, puoi mantenere i nodi che eseguono la stessa versione patch di GKE per non utilizzare il nuovo traguardo. Tuttavia, i nodi non riceveranno patch di sicurezza fino all'upgrade alla patch o alla versione secondaria successiva.

Upgrade automatici per la nuova milestone di Container-Optimized OS

La successiva versione patch per una versione secondaria di GKE nel periodo di assistenza esteso utilizza una milestone di Container-Optimized OS più recente rispetto alle versioni patch precedenti. GKE esegue automaticamente l'upgrade dei cluster nei seguenti modi quando la nuova versione patch diventa un target di upgrade automatico:

• Upgrade dei control plane:
  • GKE esegue l'upgrade del control plane alla patch successiva, come di consueto.
• Upgrade dei nodi:
  • GKE non esegue l'upgrade dei nodi alla versione patch successiva.
  • GKE esegue l'upgrade dei nodi alla versione secondaria successiva verso la fine del supporto esteso, come di consueto. Per saperne di più, consulta Upgrade automatici alla fine del supporto.

Poiché la nuova versione milestone potrebbe introdurre modifiche incompatibili con i tuoi workload, GKE mette in pausa gli upgrade automatici dei nodi alla versione patch successiva. Puoi eseguire l'upgrade manuale alla nuova versione della patch se hai determinato che i tuoi carichi di lavoro sono compatibili con la successiva milestone di Container-Optimized OS. Se esegui l'upgrade manuale dei nodi a una versione patch che utilizza il nuovo traguardo di Container-Optimized OS, GKE riprende gli upgrade automatici delle patch dei nodi perché ora i nodi eseguono il nuovo traguardo.

Notifica del cluster quando le nuove versioni delle patch utilizzano il nuovo traguardo

GKE invia una notifica del cluster per informarti quando si verifica questa situazione. Questa notifica viene inviata quando la prima versione della patch che utilizza il nuovo traguardo di Container-Optimized OS diventa disponibile nel canale Extended.

Quando ricevi questa notifica, valuta se vuoi eseguire l'upgrade manuale dei nodi alla patch o alla versione secondaria successiva oppure non ricevere versioni patch successive per questa versione secondaria durante il periodo di supporto esteso. Per saperne di più, consulta Le nuove versioni delle patch passano al nuovo traguardo di Container-Optimized OS durante il supporto esteso.

Schema di controllo delle versioni

Le release di Kubernetes utilizzano lo standard di controllo delle versioni semantico per i numeri di versione (X.Y.Z). GKE aggiunge un numero di versione patch GKE alla versione di Kubernetes (X.Y.Z-gke.N).

Versione principale di Kubernetes (X)

Le versioni principali vengono in genere incrementate se vengono introdotte modifiche non compatibili con le versioni precedenti nell'API pubblica. 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 deprecate potrebbero essere rimosse con una nuova versione secondaria, ad esempio con 1.22. Una release di versione secondaria incrementa la versione di Kubernetes da 1.Y a 1.Y+1. Ad esempio, Kubernetes 1.32 è la release secondaria successiva a Kubernetes 1.31.

Versione patch di Kubernetes (Z)

Kubernetes rilascia versioni patch durante il periodo di 12 mesi successivo al rilascio di una versione secondaria. Una release della versione patch incrementa la versione di Kubernetes da X.Y.Z a X.Y.Z+1. Ad esempio, 1.32.6 è la release di patch che segue 1.32.5.

Versione patch GKE (-gke.N)

GKE rilascia versioni patch che corrispondono alle versioni patch di Kubernetes upstream. Le versioni patch di GKE possono includere aggiornamenti della sicurezza, modifiche delle funzionalità e correzioni di bug per GKE insieme al software Kubernetes open source. Questi aggiornamenti o correzioni sono necessari per la compatibilità e l'interoperabilità con Google Cloud.

GKE potrebbe rilasciare più versioni patch di GKE per ogni versione patch di Kubernetes. Ad esempio, la patch di Kubernetes versione 1.35.6 ha patch GKE come 1.35.6-gke.1638000, 1.35.6-gke.1641000 e 1.35.6-gke.1250000.

Le versioni patch di GKE diventano in genere disponibili ogni settimana. Le release delle patch vengono implementate in modo incrementale in ogni zona.

Versione patch alpha di GKE (X.Y+1.Z-gke.N+preview) - solo cluster alpha

GKE rilascia versioni patch alpha per una versione secondaria di Kubernetes in arrivo fino a quattro mesi prima della data di rilascio di quella versione secondaria. Queste versioni delle patch pre-release sono disponibili per la sperimentazione e il test nei cluster GKE alpha registrati nel canale di rilascio rapido. Le versioni patch alpha hanno sempre come target la successiva versione secondaria nel ciclo di rilascio di Kubernetes prima del rilascio della versione secondaria. Ad esempio, se la versione secondaria 1.36 è l'ultima release stabile e la 1.37 non è ancora stata rilasciata, le versioni delle patch alpha sono per la versione 1.37.

Controllare le versioni disponibili e predefinite

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

Per controllare le versioni di GKE predefinite e disponibili, seleziona una delle seguenti opzioni:

Console

1. Nella console Google Cloud , vai alla pagina Crea un cluster Kubernetes:

   Vai a Crea un cluster Kubernetes

2. Nella sezione Tipo di località, scegli un tipo di località e la regione o la zona per il piano di controllo del cluster.

3. Nell'elenco Canale di rilascio di destinazione, seleziona un canale di rilascio.

4. Apri l'elenco Versione target. Questo elenco mostra tutte le versioni patch di GKE disponibili per il canale di rilascio. La versione patch predefinita per il canale di rilascio viene selezionata automaticamente. Se selezioni il canale di rilascio rapido, vedrai anche le versioni patch alpha disponibili per la versione secondaria imminente.

Nota: se utilizzi la console Google Cloud per creare un cluster prima del completamento dell'implementazione di una versione, gli elenchi delle versioni disponibili potrebbero non essere accurati per la tua zona.

gcloud

Per controllare le versioni disponibili e predefinite per un canale di rilascio specifico, esegui uno dei seguenti comandi:

• Controlla le versioni disponibili:

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

  Sostituisci quanto segue:

  • RELEASE_CHANNEL: il nome del canale di rilascio. Specifica uno dei seguenti valori:

    • RAPID
    • REGULAR
    • STABLE
    • EXTENDED

  • COMPUTE_LOCATION: la posizione di Compute Engine che vuoi controllare.

  L'output è simile al seguente:

  channels:
    channel: RAPID
    validVersions:
    - 1.36.2-gke.2064000
    - 1.36.2-gke.1498000
    - 1.35.6-gke.1641000
    - 1.35.6-gke.1638000
    - 1.35.6-gke.1258000
    - 1.34.9-gke.1610000
    - 1.34.9-gke.1322000
    - 1.33.13-gke.1269000
    - 1.33.13-gke.1109000
  

  Nel canale rapido, il campo previewVersions indica le versioni patch alpha di GKE per la versione secondaria di Kubernetes in arrivo. Queste versioni sono disponibili solo per i cluster alpha.

• Controlla la versione predefinita:

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

  L'output è simile al seguente:

  channels:
    channel: RAPID
    defaultVersion: 1.36.2-gke.1498000
  

• Controlla le versioni alpha della patch disponibili nel canale Rapid:

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

  L'output è simile al seguente:

  channels:
    channel: RAPID
    previewVersions:
    - 1.37.0-gke.2064000+preview
  

Per controllare le versioni disponibili e predefinite per i cluster che non utilizzano alcun canale (ritirato), esegui uno dei seguenti comandi:

• Controlla la versione predefinita:

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

  Sostituisci COMPUTE_LOCATION con la posizione di Compute Engine che vuoi controllare.

  L'output è simile a 1.35.6-gke.1127000.

• Controlla le versioni del control plane disponibili:

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

  L'output è simile al seguente:

  validMasterVersions:
  - 1.36.2-gke.2064000
  - 1.36.2-gke.1498000
  - 1.36.2-gke.1346000
  - 1.36.0-gke.4681000
  - 1.36.0-gke.4447000
  - 1.35.6-gke.1641000
  - 1.35.6-gke.1638000
  - 1.35.6-gke.1258000
  - 1.35.6-gke.1250000
  - 1.35.6-gke.1127000
  - 1.35.6-gke.1049000
  

• Controlla le versioni di Node disponibili:

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

  L'output è simile al seguente:

  validNodeVersions:
  - 1.36.2-gke.2064000
  - 1.36.2-gke.1498000
  - 1.36.2-gke.1346000
  - 1.36.0-gke.4681000
  - 1.36.0-gke.4447000
  - 1.35.6-gke.1641000
  - 1.35.6-gke.1638000
  - 1.35.6-gke.1258000
  - 1.35.6-gke.1250000
  - 1.35.6-gke.1127000
  - 1.35.6-gke.1049000
  # Multiple lines are omitted here
  

Nota: per la manipolazione avanzata dell'output get-server-config, consulta la documentazione di gcloud CLI su filtraggio e formattazione.

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 di Kubernetes più recente supportata disponibile su GKE nella zona o nella regione del cluster.
• 1.X: specifica la release della patch patch+gke.N valida più recente nella versione secondaria 1.X
• 1.X.Y: specifica la patch gke.N valida più recente nella release di patch 1.X.Y.
• -: Per i control plane del cluster, specifica la versione predefinita di Kubernetes per i control plane. Per gli upgrade dei nodi, specifica la versione in esecuzione del control plane del cluster.

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

Specifica della versione del nodo

Questa sezione si applica solo ai cluster creati in modalità Standard. Nei cluster Autopilot, i nodi vengono aggiornati automaticamente alla versione del piano di controllo e non puoi specificare una versione.

Quando crei o esegui l'upgrade di un node pool, puoi specificarne la versione. Per impostazione predefinita, i nodi eseguono la stessa versione di GKE del control plane. I nodi non possono essere più vecchi di due versioni secondarie rispetto ai control plane.

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

Policy di applicazione delle patch del control plane di 90 giorni

Per garantire che un cluster GKE riceva patch di sicurezza critiche e altre correzioni in modo tempestivo, GKE richiede che il control plane di un cluster venga aggiornato a una nuova versione patch (o secondaria) almeno ogni 90 giorni. Per impostazione predefinita, GKE esegue automaticamente l'upgrade del control plane dei cluster più frequentemente di ogni 90 giorni. Tuttavia, puoi ritardare questi upgrade del control plane configurando le esclusioni della manutenzione o scegliendo i tipi di upgrade che GKE esegue in una sequenza di implementazione. Tuttavia, in modo simile agli upgrade automatici al termine dell'assistenza, se hai un cluster GKE che non è stato sottoposto all'upgrade come richiesto, GKE esegue automaticamente l'upgrade del cluster a una versione patch successiva indipendentemente dalle norme che hai configurato.

Policy di asimmetria delle versioni di GKE

I criteri di asimmetria delle versioni di GKE garantiscono che un cluster GKE mantenga la compatibilità tra il control plane e i nodi. In un cluster GKE, i nodi possono corrispondere alla versione del control plane o eseguire fino a due versioni secondarie precedenti a quella del control plane.

I nodi non possono eseguire versioni più recenti di quella del control plane. Ad esempio, se il control plane 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 più recente di quella del control plane a causa delle norme sul disallineamento delle versioni OSS di Kubernetes.

Per garantire la compatibilità e l'affidabilità, i nodi devono utilizzare una versione supportata indipendentemente dal fatto che seguano una distorsione di versione valida.

Identificare i cluster con un disallineamento delle versioni non supportato

GKE identifica i cluster in cui i nodi eseguono una versione incompatibile con il control plane a causa del disallineamento delle versioni. GKE consiglia di eseguire l'upgrade dei nodi che eseguono questa versione non supportata, fornendo queste indicazioni con un approfondimento e un suggerimento tramite il servizio Recommender. Per scoprire di più su come gestire approfondimenti e suggerimenti di Recommender, consulta l'articolo Ottimizzare l'utilizzo di GKE con approfondimenti e suggerimenti.

Per trovare cluster con una distorsione della versione non supportata, puoi utilizzare uno dei seguenti modi:

• Utilizza la console Google Cloud .
• Utilizza gcloud CLI o l'API Recommender specificando il CLUSTER_VERSION_SKEW_UNSUPPORTED sottotipo 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 control plane.

Supporto per l'omissione delle versioni secondarie

GKE non consente di ignorare le versioni secondarie per il control plane del cluster, ma puoi ignorare le versioni patch. I nodi worker possono saltare le versioni secondarie. Ad esempio, un pool di nodi può essere aggiornato dalla versione 1.32 alla 1.34 saltando la versione 1.33.

Per eseguire l'upgrade di un cluster in più versioni secondarie, esegui l'upgrade del control plane una versione secondaria alla volta ed esegui l'upgrade dei nodi worker alla stessa versione ogni volta. Ad esempio, per eseguire l'upgrade del control plane 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 control plane e poi ripeti la procedura per eseguire l'upgrade dalla versione 1.33 alla versione 1.34.

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

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

Supporto delle versioni patch

GKE introduce prima una versione patch nel canale rapido, per poi promuoverla gradualmente negli altri canali di rilascio. Quando GKE rende disponibile una versione patch in un canale di rilascio, puoi creare, eseguire l'upgrade o, in casi specifici, eseguire il downgrade del cluster a questa versione. Mentre una versione secondaria è supportata, GKE continua a introdurre nuove versioni patch della versione secondaria in un canale di rilascio.

Le versioni precedenti delle patch rimangono disponibili nel canale di rilascio per i nodi finché la versione secondaria non raggiunge la fine del supporto, ma vengono rimosse e rese non disponibili per l'utilizzo con il control plane prima di questa data. Quando GKE rimuove una versione patch per l'utilizzo con il control plane, non puoi creare, eseguire l'upgrade o il downgrade del control plane del cluster alla versione patch rimossa. Se il control plane del cluster esegue una versione patch rimossa, ti consigliamo di eseguire l'upgrade del control plane all'ultimo target di upgrade automatico.

Deprecazione delle versioni patch per il control plane

Le seguenti informazioni si applicano a qualsiasi versione patch in cui la versione secondaria è già stata introdotta nel canale regolare.

Prima di rimuovere le versioni delle patch da un canale di rilascio per l'utilizzo con un control plane del cluster, GKE ritira la versione della patch. Sebbene le versioni patch ritirate non siano più elencate come disponibili per il control plane, puoi comunque utilizzarle per creare, eseguire l'upgrade o il downgrade del control plane.

Ti consigliamo di eseguire l'upgrade a una versione patch più recente il prima possibile. Utilizza le versioni ritirate solo se la procedura di implementazione del tuo ambiente ti impedisce di eseguire l'upgrade prima. GKE ritira una versione patch per 90 giorni o finché la versione secondaria non raggiunge la fine del supporto standard (canale Regular, Stable, No channel) o la fine del supporto esteso (canale Extended).

Supporto della versione alpha

Attenzione: le versioni alpha sono versioni instabili di Kubernetes destinate alla sperimentazione. Queste versioni hanno le stesse aspettative di supporto tecnico e stabilità della fase di lancio Anteprima.

Le versioni alpha sono versioni patch GKE di una futura versione secondaria di Kubernetes che GKE rilascia fino a quattro mesi prima che la versione secondaria sia disponibile per tutti i cluster nel canale rapido. Queste versioni alpha sono disponibili solo nei cluster alpha di GKE e sono destinate ai primi utenti che vogliono sperimentare le funzionalità future senza aspettative di stabilità o assistenza.

Il canale rapido ha a disposizione da una a tre versioni patch alpha per la prossima versione secondaria. Nei mesi precedenti alla disponibilità della versione secondaria per tutti i cluster nel canale rapido, GKE introduce nuove versioni patch alpha e rimuove quelle esistenti. Poiché le versioni patch alpha sono disponibili solo nei cluster alpha, si applicano le seguenti considerazioni:

• Non puoi eseguire l'upgrade dei cluster alpha alle nuove versioni. Per testare una nuova versione alpha, crea un cluster alpha che esegua quella versione.
• I cluster alpha che eseguono una versione alpha rimossa continuano a esistere fino alla scadenza dei cluster 30 giorni dopo la creazione o fino a quando non li elimini.
• Le correzioni per CVE e bug in componenti di sistema specifici non vengono applicate retroattivamente alle versioni patch alpha esistenti. Per ottenere queste correzioni, devi creare un cluster alpha che esegua una versione patch alpha più recente.

Dopo che GKE rilascia una versione secondaria stabile nel canale rapido, rimuove le versioni delle patch alpha per quella versione secondaria. Le versioni alpha della successiva versione secondaria nel ciclo di rilascio diventano disponibili nel canale rapido fino a quattro mesi prima della data di rilascio della versione secondaria.

Ciclo di vita della versione alpha

Il ciclo di vita della versione alpha prevede le seguenti tappe fondamentali:

1. Kubernetes rilascia la prima versione di sviluppo per la prossima versione secondaria (X.Y+1.0-alpha.0).
2. Fino a quattro mesi prima della data di rilascio della versione secondaria imminente, GKE introduce le versioni patch alpha per quella versione secondaria nel canale rapido (X.Y+1.0-gke.N+preview).
3. Kubernetes rilascia la versione secondaria stabile (X.Y.0).
4. GKE rende disponibile la versione secondaria stabile nel canale rapido (X.Y.0-gke.N). GKE rimuove le versioni alpha per quella versione secondaria dal canale rapido.

Il ciclo di vita di una versione alpha non influisce sul ciclo di vita della versione secondaria di GKE.