Utilizzare i canali di rilascio

Autopilot Standard

In qualità di amministratore della piattaforma, puoi scegliere un canale di rilascio specifico per il tuo cluster per assicurarti che GKE esegua automaticamente l'upgrade del cluster alle versioni con il bilanciamento scelto tra disponibilità e stabilità delle funzionalità. Per scoprire di più sui canali di rilascio, consulta Informazioni sui canali di rilascio.

GKE registra tutti i cluster Autopilot in un canale di rilascio e, per impostazione predefinita, registra i cluster Standard in un canale di rilascio. Per tutte le modalità cluster, puoi scegliere un canale di rilascio specifico. Con i cluster Standard, puoi scegliere di non registrare il cluster in un canale di rilascio, ma questa opzione di configurazione è deprecata e verrà rimossa il 14 giugno 2027.

Questa pagina spiega come eseguire le seguenti azioni relative ai canali di rilascio:

• Registra un cluster in un canale di rilascio specifico.
• Trova il canale di rilascio di un cluster.
• Visualizza le versioni predefinite e disponibili per i canali di rilascio.
• Modifica il canale di rilascio di un cluster.
• Annulla la registrazione del cluster ai canali di rilascio.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti attività:

• Abilita l'API Google Kubernetes Engine.
Abilita l'API Google Kubernetes Engine
• Per 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.
  Nota: per le installazioni esistenti di gcloud CLI, assicurati di impostare la proprietà compute/region. Se utilizzi principalmente cluster zonali, imposta invece compute/zone. Se imposti una località predefinita, puoi evitare errori in gcloud CLI come il seguente: One of [--zone, --region] must be supplied: Please specify location. Potresti dover specificare la posizione in determinati comandi se la posizione del cluster è diversa da quella predefinita che hai impostato.

• Se vuoi registrare un cluster nel canale Extended, assicurati di aver esaminato i prezzi per l'assistenza estesa. Per i cluster GKE, i costi con pagamento in base al consumo sono applicati se il cluster è registrato nel canale esteso e per la versione secondaria del cluster inizia il periodo di assistenza esteso.

Registra un cluster in un canale di rilascio

Questa sezione mostra come selezionare un canale di rilascio specifico per i nuovi cluster o per i cluster esistenti che in precedenza non utilizzavano un canale di rilascio. Puoi anche modificare il canale di rilascio per un cluster esistente già registrato in un canale di rilascio.

Registra un nuovo cluster in un canale di rilascio specifico

Per impostazione predefinita, tutti i cluster sono registrati nel canale di rilascio Rapido. Puoi scegliere un canale di rilascio specifico per un cluster quando lo crei o modificare il canale di rilascio dopo la creazione del cluster. I cluster Autopilot devono essere registrati in un canale di rilascio. I cluster Standard possono essere registrati o meno in un canale di rilascio. Per il canale esteso, consulta Ricevi assistenza a lungo termine con il canale esteso prima di selezionare questo canale.

Puoi creare e registrare un nuovo cluster in un canale di rilascio specifico utilizzando la consoleGoogle Cloud o gcloud CLI.

Console

Crea un cluster seguendo questi passaggi, a seconda della modalità del cluster:

• Per i cluster Autopilot:

  1. Nella pagina di creazione del cluster Autopilot, nel riquadro di navigazione, fai clic su Impostazioni avanzate:

     Creare un cluster Autopilot

  2. Nell'elenco a discesa Canale di rilascio, seleziona un canale di rilascio in cui registrare il cluster o lascia il valore predefinito Canale regolare.

• Per i cluster Standard:

  1. Nella pagina di creazione del cluster Standard, nella sezione Impostazioni di base del cluster, vai alla sottosezione Canale di rilascio:

     Crea un cluster Kubernetes

  2. Nell'elenco a discesa Canale di rilascio, seleziona un canale di rilascio in cui registrare il cluster o lascia il valore predefinito Canale regolare.

  Nota: l'upgrade automatico dei nodi e la riparazione automatica dei nodi sono abilitati per impostazione predefinita. L'upgrade automatico dei nodi non può essere disattivato per un cluster iscritto a un canale di rilascio, ma puoi utilizzare periodi di manutenzione ed esclusioni per controllare la tempistica e l'ambito degli upgrade automatici. La riparazione automatica dei nodi può essere disattivata, ma ti consigliamo di mantenere la configurazione predefinita.

gcloud

Per creare e registrare un cluster Autopilot in un canale di rilascio specifico, esegui questo comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=COMPUTE_LOCATION
    --release-channel=CHANNEL

Per creare e registrare un cluster Standard in un canale di rilascio specifico, esegui questo comando:

gcloud container clusters create CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --release-channel=CHANNEL

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del nuovo cluster.
• CLUSTER_LOCATION: la località di Compute Engine per il nuovo cluster.
• CHANNEL: il tipo di canale di rilascio, uno tra rapid, regular, stable o, solo per Standard, extended.

Per un elenco di altre opzioni che puoi specificare, consulta la documentazione di riferimento di gcloud container clusters create-auto e gcloud container clusters create.

Puoi anche creare un cluster con una versione specifica utilizzando il flag --cluster-version. Se non specifichi un canale di rilascio, GKE registra il tuo cluster nel canale di rilascio più maturo in cui è disponibile la versione.

In alternativa, se non specifichi il canale di rilascio o la versione del cluster, il cluster utilizza per impostazione predefinita il canale di rilascio regolare nella versione predefinita.

Registra un cluster esistente in un canale di rilascio specifico

Le istruzioni riportate di seguito spiegano come registrare in un canale di rilascio un cluster esistente che non è registrato in un canale di rilascio. Se l'upgrade automatico dei nodi è disattivato per il tuo cluster, consulta invece Registra un cluster esistente non registrato in un canale di rilascio con l'upgrade automatico dei nodi disattivato.

Registra il cluster in un canale di rilascio seguendo questi passaggi:

1. Scegli un canale di rilascio: scegli il canale stabile o un altro canale più adatto alle tue esigenze. Il canale stabile è il canale più maturo e ha tutte le versioni secondarie disponibili per i cluster non registrati in un canale. Se vuoi ricevere le nuove funzionalità prima o hai bisogno di un'assistenza estesa per una versione secondaria, segui questi passaggi:
   1. Scegli il canale di rilascio migliore per il tuo cluster.
   2. Controlla se la versione secondaria del control plane del tuo cluster è disponibile nel canale di rilascio di destinazione visualizzando le versioni predefinite e disponibili per i canali di rilascio. Puoi registrare un cluster esistente, a condizione che la versione secondaria del control plane del cluster sia disponibile nel canale di rilascio di destinazione. Per scoprire di più sull'allineamento della versione del control plane del cluster con le versioni disponibili per il canale di rilascio di destinazione, consulta Modifica il canale di rilascio del cluster.
2. Valuta la possibilità di utilizzare periodi di manutenzione ed esclusioni: GKE non richiede tempi di inattività per modificare la registrazione di un cluster a un canale di rilascio. Tuttavia, GKE potrebbe avere diversi upgrade automatici disponibili in un canale di rilascio diverso, il che significa che, dopo la modifica, GKE potrebbe eseguire automaticamente l'upgrade del cluster. Consigliamo di utilizzare periodi di manutenzione ed esclusioni per controllare la tempistica degli upgrade.
3. Aggiorna il canale di rilascio del cluster al target CHANNEL: seleziona il canale di rilascio target, che può essere qualsiasi opzione diversa da None.

GKE non esegue immediatamente l'upgrade del control plane e dei nodi del cluster alla versione secondaria di destinazione dell'upgrade automatico in quel canale di rilascio al momento della registrazione. Vengono invece sottoposti a un upgrade graduale tramite il processo di upgrade automatico di GKE. Per ottenere i target di upgrade automatico per un cluster specifico, consulta Ottieni informazioni sugli upgrade di un cluster.

Registra un cluster esistente con l'upgrade automatico dei nodi disattivato

Segui queste istruzioni se hai un cluster Standard esistente non registrato in un canale di rilascio e hai disattivato gli upgrade automatici dei nodi per uno o più node pool del cluster. Se vuoi accedere alle funzionalità aggiuntive dei canali di rilascio ed eseguire la migrazione da questa opzione di configurazione deprecata, puoi registrare il cluster in un canale di rilascio senza ulteriori modifiche.

GKE non attiva automaticamente l'impostazione degli upgrade automatici dei nodi per i node pool quando registra il cluster in un canale. In ogni caso, questa impostazione è una configurazione legacy e, quando registri il cluster in un canale, ti consigliamo anche di utilizzare le esclusioni di manutenzione del node pool per impedire gli upgrade pool di nodi a livello di pool di nodi nello stesso modo.

Per registrare un cluster esistente in un canale di rilascio, segui questi passaggi:

1. Registra il cluster esistente nel canale di rilascio di destinazione aggiornando il canale, specificando stable. Il canale stabile è il canale più maturo e dispone di tutte le versioni secondarie disponibili per i cluster non registrati in un canale.
2. Facoltativo: segui questi passaggi aggiuntivi per eseguire la migrazione all'utilizzo delle esclusioni di manutenzione anziché alla configurazione precedente di disattivazione degli upgrade automatici dei nodi con l'impostazione. Puoi eseguire questi passaggi in qualsiasi momento dopo aver registrato il cluster in un canale di rilascio:
   1. Impedisci gli upgrade automatici dei nodi in uno dei seguenti modi:
      1. Solo per alcuni node pool: configura un'esclusione dalla manutenzione del pool di nodi pool per tutti i node pool in cui hai disattivato gli upgrade automatici dei nodi. La disabilitazione degli upgrade automatici dei nodi con questa esclusione impedisce tutti gli upgrade automatici dei pool di nodi, ad eccezione degli upgrade automatici al termine del supporto, che vengono eseguiti indipendentemente dalla registrazione al canale di rilascio e dalla modalità di disabilitazione degli upgrade automatici dei nodi.
      2. Per tutti i node pool: configura un'esclusione dalla manutenzione con l'ambito "Nessun upgrade secondario o dei nodi". Questa esclusione impedisce tutti gli upgrade, ad eccezione degli upgrade delle patch al control plane. Ora che il tuo cluster è registrato in un canale di rilascio, puoi utilizzare questo ambito di esclusione dalla manutenzione, che può durare fino alla data di fine del supporto per la versione secondaria nel canale di rilascio del tuo cluster.
   2. Rimuovi l'utilizzo del campo legacy per disattivare gli upgrade automatici dei nodi, perché le esclusioni dalla manutenzione configurate nel passaggio precedente ora eseguono questa funzione. Per ogni pool di nodi, segui le istruzioni per abilitare gli upgrade automatici dei nodi per un node pool esistente.

Trova il canale di rilascio del cluster

Puoi determinare il canale di rilascio del tuo cluster utilizzando la console Google Cloud o gcloud CLI.

Console

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

   Vai a Google Kubernetes Engine

2. Fai clic sul nome del cluster che vuoi ispezionare.

3. In Impostazioni di base del cluster, controlla il valore nel campo Canale di rilascio (ad esempio, Canale regolare).

Se il valore è Nessuno, il cluster non è registrato in un canale di rilascio.

gcloud

gcloud container clusters describe CLUSTER_NAME \
    --location=COMPUTE_LOCATION --format="value(releaseChannel.channel)"

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del tuo cluster.
• COMPUTE_LOCATION: una località di Compute Engine per il tuo cluster.

Se l'output è vuoto, il cluster non è registrato in un canale di rilascio.

Visualizza le versioni predefinite e disponibili per i canali di rilascio

Per verificare quali versioni sono disponibili in un canale di rilascio specifico con la consoleGoogle Cloud o gcloud CLI, segui le istruzioni per controllare le versioni disponibili e predefinite.

Modifica il canale di rilascio del cluster

Puoi modificare il canale di rilascio del cluster se la versione secondaria del control plane è disponibile nel canale di rilascio di destinazione. Potresti dover eseguire l'upgrade o il downgrade del control plane del cluster a una versione disponibile.

Per verificare se la versione del control plane del tuo cluster è disponibile nel canale di rilascio di destinazione, visualizza le versioni predefinite e disponibili per i canali di rilascio. La versione deve essere disponibile nel canale di destinazione.

• Se la versione del control plane del tuo cluster è già disponibile nel canale di rilascio di destinazione, puoi selezionare il nuovo canale di rilascio.
• Se la versione del control plane del tuo cluster non è disponibile nel canale di rilascio di destinazione, puoi eseguire l'upgrade del control plane del cluster a una versione disponibile. In alternativa, se il canale di destinazione ha solo versioni precedenti disponibili, puoi eseguire il downgrade del cluster, a condizione che la versione di destinazione sia una release patch precedente della stessa versione secondaria.

Per selezionare un nuovo canale di rilascio, aggiorna il canale di rilascio del cluster al target CHANNEL. Se vuoi impedire temporaneamente l'upgrade automatico del cluster quando selezioni il nuovo canale, configura un'esclusione dalla manutenzione prima di selezionare il nuovo canale.

Se non riesci a selezionare il canale di rilascio di destinazione perché il tuo cluster esegue una versione non disponibile in quel canale di rilascio, puoi procedere nel seguente modo:

1. Configura un'esclusione dalla manutenzione con un ambito "Nessun upgrade secondario".
2. Attendi che il canale di rilascio di destinazione renda disponibile la versione secondaria di Kubernetes del tuo cluster.
3. Registra il cluster esistente nel canale di rilascio di destinazione.

In alternativa, puoi creare un nuovo cluster nel canale di destinazione ed eseguire la migrazione dei workload.

Cambia il canale del cluster in Esteso

Per ricevere assistenza a lungo termine, mantenendo il cluster su quella versione il più a lungo possibile, puoi registrare il cluster nel canale esteso.

Assicurati di esaminare i prezzi per la registrazione del cluster nel canale Extended e le limitazioni delle funzionalità. Non puoi registrare il cluster nel canale esteso se utilizza determinate funzionalità.

Cambia il canale del cluster da Esteso

Se un cluster è registrato nel canale Extended durante il periodo di assistenza estesa, può continuare a eseguire una versione secondaria non supportata in altri canali. Se vuoi cambiare il canale del cluster da Esteso, dove la versione secondaria non è supportata, devi seguire questi passaggi:

1. Completa questi due passaggi, che possono essere eseguiti in qualsiasi ordine:
   1. Esegui l'upgrade manuale del cluster a una versione secondaria nel periodo di assistenza standard disponibile nel canale di rilascio di destinazione.
   2. Rimuovi o modifica qualsiasi esclusione dalla manutenzione con una data di fine che supera la data di fine del supporto standard per la versione secondaria supportata più recente.
2. Aggiorna il canale di rilascio del cluster.

Aggiorna il canale di rilascio del cluster

Puoi modificare il canale di rilascio del cluster utilizzando la console Google Cloud o gcloud CLI.

Console

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

   Vai a Google Kubernetes Engine

2. Fai clic sul nome del cluster che vuoi ispezionare.

3. In Impostazioni di base del cluster, nel campo Canale di rilascio, fai clic su .

4. Nel menu a discesa Canale di rilascio, seleziona il canale di rilascio di destinazione.

5. Leggi e accetta l'avviso selezionando Comprendo che potrebbero verificarsi tempi di inattività durante gli upgrade della versione.

6. Fai clic su Salva modifiche.

gcloud

Modifica la proprietà del canale di rilascio di un cluster esistente:

gcloud container clusters update CLUSTER_NAME \
  --release-channel CHANNEL

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del tuo cluster.
• CHANNEL: il canale di rilascio di destinazione, che può essere uno tra rapid, regular, stable e, solo per Standard, extended o None.

Annulla l'iscrizione a un canale di rilascio

Avviso: la mancata registrazione del cluster in un canale di rilascio (noto come Nessun canale e, in precedenza, come Statico) è un'opzione di configurazione deprecata, consentita solo per i clienti esistenti, e verrà rimossa il 14 giugno 2027. I nuovi clienti non possono creare o aggiornare il proprio cluster per utilizzare questa opzione di configurazione. Per i cluster non registrati in un canale di rilascio, ti consigliamo di registrarli prima di questa data. Dopo la data di rimozione, GKE registra tutti i cluster rimanenti nel canale stabile. Per ulteriori informazioni su questo ritiro e su come ottenere la stessa funzionalità con i canali di rilascio, consulta Cluster non registrati in un canale di rilascio.

Sebbene sia possibile annullare l'iscrizione del cluster Standard a un canale di rilascio fino al 14 giugno 2027, questa è un'opzione di configurazione deprecata e ti consigliamo vivamente di esaminare il confronto tra i cluster registrati e non registrati in un canale di rilascio. Assicurati di comprendere i compromessi tra la registrazione e la mancata registrazione del cluster in un canale di rilascio.

Puoi eseguire questa azione con la console Google Cloud , gcloud CLI o l'API GKE. Puoi anche specificare che non vuoi registrare il cluster Standard in un canale di rilascio durante la creazione del cluster. Non puoi annullare l'iscrizione dei cluster Autopilot a un canale di rilascio.

Console

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

   Vai a Google Kubernetes Engine

2. Fai clic sul nome del cluster che vuoi ispezionare.

3. In Impostazioni di base del cluster, nel campo Canale di rilascio, fai clic su .

4. Seleziona la versione Nessun canale dal menu a discesa.

5. Leggi e accetta l'avviso selezionando Comprendo che potrebbero verificarsi tempi di inattività durante gli upgrade della versione.

6. Fai clic su Salva modifiche.

gcloud

Aggiorna il canale di rilascio del cluster impostandolo su None:

gcloud container clusters update CLUSTER_NAME \
  --release-channel None

API

Specifica "releaseChannel": { "channel": UNSPECIFIED} quando crei o aggiorni un cluster.

Identifica i cluster non registrati in un canale di rilascio

Avviso: la mancata registrazione del cluster in un canale di rilascio (noto come Nessun canale e, in precedenza, come Statico) è un'opzione di configurazione deprecata, consentita solo per i clienti esistenti, e verrà rimossa il 14 giugno 2027. I nuovi clienti non possono creare o aggiornare il proprio cluster per utilizzare questa opzione di configurazione. Per i cluster non registrati in un canale di rilascio, ti consigliamo di registrarli prima di questa data. Dopo la data di rimozione, GKE registra tutti i cluster rimanenti nel canale stabile. Per ulteriori informazioni su questo ritiro e su come ottenere la stessa funzionalità con i canali di rilascio, consulta Cluster non registrati in un canale di rilascio.

Se hai un cluster GKE Standard non registrato in un canale di rilascio e tutti i node pool hanno l'upgrade automatico dei nodi abilitato, GKE consiglia di registrare il cluster in un canale di rilascio, fornendo questa indicazione con un insight e un suggerimento tramite il servizio Recommender. Queste indicazioni non si applicano ai cluster Autopilot, che sono sempre registrati in un canale di rilascio.

Per trovare i cluster non registrati in un canale di rilascio, puoi utilizzare uno dei seguenti modi:

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

Per istruzioni, consulta la sezione su come visualizzare insight e consigli.

Per implementare questo suggerimento, segui le istruzioni per registrare i cluster esistenti. Per scoprire di più sull'implementazione di questo suggerimento, consulta Informazioni sui canali di rilascio. Per un confronto delle funzionalità tra un cluster registrato o meno in un canale di rilascio, consulta il confronto tra i cluster registrati e non registrati in un canale di rilascio.

Utilizza gli upgrade automatici delle patch accelerati

Puoi utilizzare gli upgrade automatici delle patch accelerati in modo che GKE esegua automaticamente l'upgrade del cluster alle versioni patch non appena sono disponibili in un canale di rilascio, anziché quando GKE imposta le versioni come target di upgrade automatico almeno una settimana dopo.

Per utilizzare gli upgrade automatici rapidi delle patch, imposta il flag --patch-update=accelerated con gcloud CLI quando crei il cluster o aggiorni il cluster.

Questa impostazione è disponibile solo per i cluster registrati in un canale di rilascio e non influisce sugli upgrade delle versioni secondarie.

Disabilita gli upgrade automatici rapidi delle patch

Puoi aggiornare il cluster per disattivare gli upgrade automatici rapidi delle patch per il tuo cluster, in modo che riceva le versioni patch solo dopo che GKE le ha impostate come target di upgrade automatico. Questa azione ripristina l'impostazione predefinita del cluster e non disattiva gli upgrade automatici.

Per aggiornare il cluster, imposta il flag --patch-update=default.

Passaggi successivi

• Informazioni sui canali di rilascio