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 esegui automaticamente l'upgrade del cluster alle versioni con il bilanciamento scelto tra disponibilità e stabilità delle funzionalità. A Scopri di più sui canali di rilascio, consulta Informazioni sulla release canali di YouTube.

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 in tutte le modalità cluster, puoi scegliere un canale di rilascio specifico. Con 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 distribuzione:

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

  • Attiva l'API Google Kubernetes Engine.
    • Abilita l'API Google Kubernetes Engine
  • Se vuoi utilizzare Google Cloud CLI per questa attività, install e poi inizializzare con gcloud CLI. Se hai già installato gcloud CLI, scarica la versione più recente eseguendo gcloud components update.
  • Se vuoi registrare un cluster nel canale Extended, assicurati di aver esaminato i prezzi dell'assistenza estesa. Puoi registrare un cluster nel canale esteso senza costi aggiuntivi se nel progetto è attivato GKE Enterprise. In alternativa, per i cluster della versione GKE Standard, i costi con pagamento in base al consumo si applicano quando il cluster è registrato nel canale Extended e la versione secondaria del cluster entra nel periodo di assistenza esteso.

Registra un cluster in un canale di rilascio

Questa sezione mostra come selezionare un canale di rilascio specifico per le nuove cluster o per i cluster esistenti che non utilizzavano in precedenza 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 Normale. Puoi scegli un canale di rilascio specifico per un cluster quando lo crei oppure cambiare il canale di rilascio dopo il cluster viene creato. 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 gli utenti estesi consulta l'articolo Ricevere assistenza a lungo termine con l'estensione canale precedente selezionando questo canale.

Puoi creare e registrare un nuovo cluster in un canale di rilascio specifico utilizzando il console Google Cloud o gcloud CLI.

Console

Crea un cluster seguendo questa procedura, a seconda della modalità del cluster:

  • Per i cluster Autopilot:

    1. Nella 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 per registrare il cluster o lascia il valore predefinito Canale normale.

  • Per i cluster standard:

    1. Nella creazione del cluster Standard Nella sezione Impostazioni di base del cluster, vai alla sezione Release canale:

      Crea un cluster Kubernetes

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

gcloud

Per creare e registrare un cluster Autopilot in un canale di release specifico, esegui il seguente 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 release specifico, esegui il seguente 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: il cluster Compute Engine località del 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 valore predefinito del cluster è il canale di rilascio Regolare nella versione predefinita.

Registra un cluster esistente

Puoi registrare un cluster esistente in un canale di rilascio, a condizione che la versione minore del piano di controllo del cluster sia disponibile nel canale di rilascio di destinazione. Per verificare se la versione secondaria del piano di controllo del cluster è disponibile in il canale di rilascio di destinazione, visualizza le versioni predefinite e disponibili per la release canali di YouTube. Per approfondire l'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 diversi upgrade automatici disponibili in un altro canale di rilascio, 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 registrarti, aggiorna la release del cluster canale di destinazione CHANNEL.

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

Se hai già un cluster standard non registrato in 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 per la 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 pool di nodi.

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". Questa è l'unica manutenzione disponibile ambito di esclusione per i cluster non registrati in un canale di rilascio. Questo impedisce potenzialmente l'upgrade automatico immediato del cluster se è presente un target dell'upgrade automatico appena idoneo nella release selezionata canale.
  2. Registra il cluster esistente nel canale di rilascio di destinazione. Con questa modifica, GKE apporta le seguenti modifiche alle impostazioni sul nodo pool:
    1. GKE abilita l'impostazione di upgrade automatico dei nodi per tutti i pool di nodi in cui la funzionalità è disabilitata, ma non eseguirà automaticamente l'upgrade dei nodi perché hai configurato l'esclusione per la manutenzione nel passaggio 1.
    2. GKE attiva la riparazione automatica dei nodi per tutti i pool di nodi in cui la funzionalità è disattivata, anche se puoi disattivare nuovamente la riparazione automatica dei nodi con la CLI gcloud se vuoi mantenerla disabilitata.
  3. Configura un'esclusione di manutenzione con l'ambito "Nessun elemento secondario o nodo upgrade". In questo modo vengono impediti tutti gli upgrade, ad eccezione degli upgrade delle patch, al piano di controllo. Ora che il cluster è registrato in un canale di rilascio, puoi utilizzare questo ambito di esclusione della manutenzione, che può durare fino alla fine data del supporto 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 per la manutenzione o finché la versione secondaria dei nodi non raggiunge la fine del supporto.

Trovare il canale di rilascio del cluster

Puoi determinare il canale di rilascio del cluster utilizzando la console Google Cloud oppure con 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 da ispezionare.

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

Se il valore è None, 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 release specifico con la console Google Cloud o gcloud CLI, segui le istruzioni per controllare le versioni disponibili e predefinite.

Cambiare il canale di rilascio del cluster

Puoi modificare il canale di rilascio del tuo cluster se il piano di controllo sia disponibile nel canale di rilascio di destinazione. Potresti dover eseguire l'upgrade o il downgrade del piano di controllo del cluster a una versione disponibile.

Per verificare se la versione del piano di controllo 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 piano di controllo del tuo cluster è già disponibile nel canale di rilascio di destinazione, puoi selezionare il nuovo canale di rilascio.
  • Se la versione del piano di controllo del cluster non è disponibile nel canale di rilascio di destinazione, puoi eseguire l'upgrade del piano di controllo del cluster a una versione disponibile. In alternativa, se il canale di destinazione ha solo versioni precedenti disponibile, puoi eseguire il downgrade del cluster, a condizione che la versione di destinazione sia una release patch precedente dalla stessa versione secondaria.

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

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

  1. Configura un'esclusione di manutenzione con l'ambito "Nessun upgrade di minore entità".
  2. Attendi che il canale di rilascio di destinazione renda disponibile la versione minore 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 carichi di lavoro.

Passare al canale esteso

Per ricevere assistenza a lungo termine, il cluster su quella versione il più a lungo possibile, puoi nel tuo cluster nel canale Extended.

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

Modificare il cluster dal canale esteso

Se un cluster viene registrato nel canale Extended durante il supporto esteso periodo, il cluster può continuare a eseguire una versione secondaria che non è supportata altri canali. Se vuoi cambiare il cluster dal canale esteso, in cui la versione secondaria non è supportata, devi seguire questi passaggi:

  1. Completa questi due passaggi, che possono essere eseguiti in qualsiasi ordine:
    1. Eseguire manualmente l'upgrade dei cluster a una versione secondaria del servizio standard disponibile sul canale di rilascio target.
    2. Rimuovi o modifica qualsiasi esclusione di manutenzione con una data di fine che superi la data di fine del supporto standard per la versione minore più recente 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 console Google Cloud oppure con 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 da esaminare.

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

Annullare l'iscrizione a un canale di rilascio

Sebbene tu possa annullare la registrazione del tuo 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 tuo cluster in un canale di rilascio.

Puoi eseguire questa azione con la console Google Cloud, gcloud CLI o l'API Kubernetes Engine. 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 ai cluster Autopilot da 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 da esaminare.

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

  4. Seleziona Versione statica dal menu a discesa.

  5. Leggi e accetta l'avviso selezionando Sono consapevole 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 un valore None:

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

API

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

Identifica i cluster non registrati in un canale di rilascio

Se hai un cluster GKE Standard non registrato in un canale di rilascio e in tutti i pool di nodi è abilitato l'upgrade automatico dei nodi, 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. Questo le 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 il metodo nella console Google Cloud oppure puoi cercare queste indicazioni con gcloud CLI o l'API Recommender, specificando Motore per suggerimenti CLUSTER_RELEASE_CHANNEL_UNSPECIFIED predefinito. Per istruzioni, scopri come visualizzare approfondimenti personalizzati.

Per implementare questo suggerimento, segui le istruzioni per registrare account esistenti cluster. Per saperne di più su come decidere se implementare questo consiglio, consulta Informazioni sui canali di rilascio. Per un confronto di funzionalità tra un cluster registrato o non registrato in un canale di rilascio, esamina il confronto tra cluster registrati e non registrati in una release di destinazione.

Passaggi successivi