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

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

Prima di iniziare

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

  • Abilitare l'API Google Kubernetes Engine.
    • Abilita l'API Google Kubernetes Engine
  • Se vuoi 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 gcloud components update comando. Le versioni precedenti di gcloud CLI potrebbero non supportare l'esecuzione dei comandi in questo documento.
  • Se vuoi registrare un cluster nel canale esteso, 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.

Registrare un cluster in un canale di rilascio

Questa sezione spiega 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 Regolare. 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 non registrati in un canale di rilascio. Per il canale esteso, prima di selezionare questo canale, consulta Ottenere assistenza a lungo termine con il canale esteso.

Puoi creare e registrare un nuovo cluster in un canale di rilascio specifico utilizzando la Google Cloud console 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 , fai clic su Impostazioni avanzate nel riquadro di navigazione:

      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.

gcloud

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

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 il comando seguente:

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: rapid, regular, stable o, solo per Standard, extended.

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

Puoi anche creare un cluster con una versione specifica utilizzando il flag --cluster-version. Se non specifichi un canale di rilascio, GKE registra il 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 con la versione predefinita.

Registrare 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 saperne di più sull'allineamento della versione del control plane del cluster con le versioni disponibili per il canale di rilascio di destinazione, consulta Selezionare un nuovo canale di rilascio.

GKE non richiede tempi di inattività per modificare la registrazione del 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. Ti consigliamo di utilizzare periodi di manutenzione ed esclusioni per controllare la tempistica degli upgrade.

Per la registrazione, aggiorna il canale di rilascio del cluster al target CHANNEL.

Quando esegui la registrazione, 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. Vengono invece sottoposti a upgrade graduale dal processo di upgrade automatico di GKE. Per ottenere i target di upgrade automatico per un cluster specifico, consulta Visualizzare le informazioni sugli upgrade di un cluster.

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

Se hai un cluster Standard esistente non registrato in un canale di rilascio e hai disabilitato gli upgrade automatici dei nodi per uno o più node pool del cluster, ma vuoi accedere alle funzionalità aggiuntive dei canali di rilascio, puoi utilizzare le esclusioni dalla 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 manualmente l'upgrade dei node pool.

Segui questi passaggi 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 dalla manutenzione disponibile per i cluster non registrati in un canale di rilascio. In questo modo, il cluster non verrà sottoposto a upgrade automatico immediato se nel canale di rilascio selezionato è presente un nuovo target di upgrade automatico idoneo.
  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 gcloud CLI se vuoi mantenerla disabilitata.
  3. Configura un'esclusione dalla manutenzione con l'ambito "Nessun upgrade secondario o di 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 dalla manutenzione, che può durare fino alla data di fine dell'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 rimuovi l'esclusione dalla manutenzione o la versione secondaria dei nodi non raggiunge la fine dell'assistenza.

Trovare il canale di rilascio del cluster

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

Console

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

    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:

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

Visualizzare le versioni predefinite e disponibili per i canali di rilascio

Per verificare quali versioni sono disponibili in un canale di rilascio specifico con la Google Cloud console o gcloud CLI, segui le istruzioni per verificare 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 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 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 release 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 dalla manutenzione prima di selezionare il nuovo canale.

Se non riesci a selezionare il canale di rilascio di destinazione perché il 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 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.

Passare il cluster al canale esteso

Per ottenere assistenza a lungo termine, mantenendo il cluster su quella versione il più a lungo possibile, puoi registrarlo 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 utilizza determinate funzionalità.

Rimuovere il cluster dal canale esteso

Se un cluster è registrato nel canale esteso durante il periodo di assistenza esteso, può continuare a eseguire una versione secondaria non supportata in altri canali. Se vuoi rimuovere il cluster dal canale 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 manualmente l'upgrade 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 superi la data di fine dell' assistenza standard per la versione secondaria più recente e supportata.
  2. Aggiorna il canale di rilascio del cluster.

Aggiornare il canale di rilascio del cluster

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

Console

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

    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. Nell'elenco a discesa Canale di rilascio, seleziona il canale di rilascio di destinazione.

  5. Leggi e riconosci l'avviso selezionando Comprendo che potrebbero verificarsi tempi di inattività durante gli upgrade delle versioni.

  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 rapid, regular, stable e, solo per Standard, extended o None.

Annullare l'iscrizione a un canale di rilascio

Sebbene tu possa annullare l'iscrizione del cluster Standard a 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 Google Cloud console, 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 Google Cloud console.

    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 riconosci l'avviso selezionando Comprendo che potrebbero verificarsi tempi di inattività durante gli upgrade delle versioni.

  6. Fai clic su Salva modifiche.

gcloud

Aggiorna il canale di rilascio del cluster al valore None:

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

API

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

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 node pool 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 consiglio 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:

  • Utilizzare la Google Cloud console.
  • Utilizzare gcloud CLI o l'API Recommender, specificando il CLUSTER_RELEASE_CHANNEL_UNSPECIFIED sottotipo di Recommender.

Per istruzioni, consulta come visualizzare approfondimenti e consigli.

Per implementare questo consiglio, segui le istruzioni per registrare i cluster esistenti. Per saperne di più sull'opportunità di implementare questo consiglio, consulta 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 --patch-update=accelerated flag con gcloud CLI quando crei il cluster o esegui l' upgrade del cluster.

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

Disabilitare gli upgrade automatici delle patch accelerati

Puoi aggiornare il cluster per disabilitare gli upgrade automatici delle patch accelerati, in modo che il cluster riceva le versioni patch solo dopo che GKE ha impostato la versione patch come target di upgrade automatico. Questa azione ripristina l'impostazione predefinita del cluster e non disabilita gli upgrade automatici.

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

Passaggi successivi