Utilizzare i canali di rilascio

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, vedi Informazioni sui canali di rilascio.

GKE registra tutti i cluster Autopilot in un canale di rilascio e registra i cluster Standard, per impostazione predefinita, in un canale di rilascio. Per tutte le modalità del cluster, puoi scegliere un canale di rilascio specifico. Con i cluster Standard, puoi scegliere di non registrare il cluster in un canale di rilascio.

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

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

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.

• Se vuoi registrare un cluster nel canale esteso, assicurati di aver esaminato i prezzi dell'assistenza estesa. Puoi registrare un cluster nel canale Extended senza costi aggiuntivi se il progetto ha abilitato GKE Enterprise. In alternativa, per i cluster della versione GKE Standard, 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.

Registrare 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.

Registrare un nuovo cluster in un canale di rilascio specifico

Per impostazione predefinita, tutti i cluster sono registrati nel canale di rilascio Regular. Puoi scegliere un canale di rilascio specifico per un cluster quando lo crei oppure 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 annullati in un canale di rilascio. Per il canale esteso, consulta la sezione Ricevere 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.

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

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

Registra un cluster esistente

Puoi registrare un cluster esistente in un canale di rilascio, a condizione che la versione secondaria del control plane del cluster sia disponibile nel canale di rilascio di destinazione. Per verificare se la versione secondaria del control plane del cluster è disponibile nel canale di rilascio di destinazione, visualizza le versioni predefinite e disponibili per i canali di rilascio. Per scoprire di più sull'allineamento della versione del control plane del cluster con le versioni disponibili per il canale di rilascio di destinazione, vedi Selezionare un nuovo canale di rilascio.

GKE non richiede tempi di inattività per modificare la registrazione al canale di rilascio di un cluster. Tuttavia, GKE potrebbe avere upgrade automatici diversi 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.

Per la registrazione, aggiorna il canale di rilascio del cluster alla versione di destinazione CHANNEL.

Al momento della registrazione, GKE non esegue immediatamente l'upgrade del control plane e dei nodi del cluster alla versione secondaria di destinazione dell'upgrade automatico nel canale di rilascio. Vengono invece aggiornati gradualmente tramite la procedura di upgrade automatico di GKE. Per ottenere le destinazioni dell'upgrade automatico per un cluster specifico, consulta Ottenere informazioni sugli upgrade di un cluster.

Registra un cluster esistente non registrato in un canale di rilascio e con l'upgrade automatico dei nodi disattivato

Se hai un cluster Standard esistente non registrato a un canale di rilascio e hai disattivato gli upgrade automatici dei nodi per uno o più pool di nodi del cluster, ma vuoi accedere alle funzionalità aggiuntive dei canali di rilascio, puoi utilizzare le esclusioni di manutenzione per impedire gli upgrade dei nodi. Se passi a un canale di rilascio e utilizzi le esclusioni dalla manutenzione, non puoi impedire gli upgrade automatici dei nodi a livello di pool di nodi, ma solo a livello di cluster. Tuttavia, puoi sempre eseguire l'upgrade manuale dei node pool.

Per registrare un cluster esistente in un canale di rilascio, continuando a impedire gli upgrade automatici dei nodi:

1. Configura un'esclusione dalla manutenzione con un ambito "Nessun upgrade". Questo è l'unico ambito di esclusione della manutenzione disponibile per i cluster non registrati in un canale di rilascio. In questo modo il cluster non viene potenzialmente sottoposto a upgrade automatico immediato se è presente una nuova destinazione di upgrade automatico idonea nel canale di rilascio selezionato.
2. Registra il cluster esistente nel canale di rilascio di destinazione. Con questa modifica, GKE apporta le seguenti modifiche alle impostazioni dei node pool:
   1. GKE abilita l'impostazione di upgrade automatico dei nodi per tutti i node pool in cui la funzionalità è disabilitata, ma non esegue automaticamente l'upgrade dei nodi perché hai configurato l'esclusione dalla manutenzione nel passaggio 1.
   2. GKE abilita la riparazione automatica dei nodi per tutti i node pool in cui la funzionalità è disabilitata, anche se puoi disabilitare di nuovo la riparazione automatica dei nodi con la gcloud CLI se vuoi mantenere la riparazione automatica dei nodi disabilitata.
3. Configura un'esclusione della manutenzione con l'ambito "Nessun upgrade secondario o dei nodi". In questo modo vengono impediti tutti gli upgrade, ad eccezione degli upgrade delle patch, al control plane. Ora che il cluster è registrato in un canale di rilascio, puoi utilizzare questo ambito di esclusione della manutenzione, che può durare fino alla fine della data di assistenza per la versione secondaria nel canale di rilascio del cluster.
4. Rimuovi l'esclusione dalla manutenzione creata nel passaggio 1 ora che hai aggiunto la nuova esclusione dalla manutenzione nel passaggio precedente.

Dopo aver completato questi passaggi, avrai un cluster in cui GKE non eseguirà automaticamente l'upgrade dei nodi finché non rimuoverai l'esclusione dalla manutenzione o finché la versione secondaria dei nodi non raggiungerà la fine del supporto.

Trovare il canale di rilascio del cluster

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

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

Visualizza le versioni predefinite e disponibili per i canali di rilascio

Per controllare 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.

Modificare 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 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 patch precedente della stessa versione secondaria.

Per selezionare un nuovo canale di rilascio, aggiorna il canale di rilascio del cluster al CHANNEL di destinazione. Se vuoi impedire temporaneamente l'upgrade automatico del cluster quando selezioni il nuovo canale, configura un'esclusione della 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 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 e migrare i carichi di lavoro.

Passare al canale esteso per il cluster

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 tuo cluster nel canale esteso e le limitazioni delle funzionalità. Non puoi registrare il cluster nel canale esteso se il cluster utilizza determinate funzionalità.

Modificare il cluster dal canale esteso

Se un cluster viene registrato nel canale esteso durante il periodo di supporto esteso, può continuare a eseguire una versione secondaria non supportata in altri canali. Se vuoi cambiare il cluster dal canale esteso, dove la versione secondaria non è supportata, devi procedere nel seguente modo:

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 sul canale di rilascio di destinazione.
   2. Rimuovi o modifica qualsiasi esclusione della manutenzione con una data di fine successiva alla data di fine dell'assistenza standard per quella versione secondaria più recente e supportata.
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 l'interfaccia alla gcloud CLI.

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

Annullare l'iscrizione a un canale di rilascio

Anche se puoi annullare la registrazione del cluster Standard da un canale di rilascio, ti consigliamo vivamente di esaminare il confronto tra i cluster registrati e non registrati in un canale di rilascio per assicurarti 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 di non voler registrare il cluster Standard in un canale di rilascio durante la creazione del cluster. Non puoi annullare l'iscrizione ai cluster Autopilot da un canale di rilascio.

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

Identificare i cluster non registrati in un canale di rilascio

Se hai un cluster GKE Standard non registrato in un canale di rilascio e tutti i pool di nodi hanno l'upgrade automatico dei nodi abilitato, ti consigliamo di registrare il cluster in un canale di rilascio. GKE fornisce queste indicazioni con un approfondimento 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 metodi:

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

Per istruzioni, scopri come visualizzare approfondimenti e consigli.

Per implementare questo consiglio, segui le istruzioni per registrare i cluster esistenti. Per saperne di più su se vuoi implementare questo consiglio, vedi Informazioni sui canali di rilascio. Per un confronto delle funzionalità tra un cluster registrato o non registrato in un canale di rilascio, consulta il confronto tra i cluster registrati e non registrati in un canale di rilascio.

Utilizzare 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 delle patch accelerati, 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.

Disattivare gli upgrade automatici delle patch accelerate

Puoi aggiornare il cluster per disattivare gli upgrade automatici delle patch accelerati per il tuo cluster, in modo che il cluster riceva le versioni patch solo dopo che GKE le ha impostate come destinazione dell'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