Esegui l'upgrade di Config Sync

Questa pagina spiega come eseguire l'upgrade della versione di Config Sync installata sui tuoi cluster.

Upgrade automatico di Config Sync

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Puoi configurare Config Sync per l'upgrade automatico alle versioni più recenti nei tuoi cluster GKE on Google Cloud.

L'attivazione degli upgrade automatici per Config Sync semplifica l'esperienza di gestione. Google si assume la responsabilità dell'upgrade automatico delle versioni di Config Sync e della supervisione del ciclo di vita dei suoi componenti. L'attivazione degli upgrade automatici offre i seguenti vantaggi:

• Riduzione dell'overhead di manutenzione: evita di monitorare le versioni più recenti di Config Sync ed eseguire manualmente l'upgrade di Config Sync nei tuoi cluster.
• Mantieni le versioni supportate: Google gestisce l'ultima versione supportata nei tuoi cluster, assicurandoti di non utilizzare una versione di Config Sync non supportata.
• Maggiore affidabilità: Google gestisce i componenti di Config Sync e li riconcilia in caso di modifiche.

Versioni di Config Sync e canali di rilascio GKE

Config Sync sceglie la versione di cui eseguire l'upgrade in base al canale di rilascio del cluster Google Kubernetes Engine. Un cluster che non utilizza un canale di rilascio GKE viene considerato come un cluster che utilizza il canale di rilascio GKE stabile.

Puoi utilizzare gli upgrade automatici per assicurarti che l'upgrade di Config Sync nei tuoi cluster venga eseguito automaticamente. Quando è disponibile una nuova versione di Config Sync in un canale di rilascio, Config Sync esegue l'upgrade di quella che corrisponde al canale di rilascio del cluster. Il canale rapido offre la versione più recente di Config Sync non appena disponibile. Il canale regolare offre a breve l'ultima versione di Config Sync. Il canale stabile offre la versione più recente di Config Sync solo dopo essere stata convalidata sui canali Rapido e Regolare.

Per ulteriori informazioni sui canali di rilascio, consulta Informazioni sui canali di rilascio.

La tabella seguente mostra la versione corrente di Config Sync disponibile in ciascun canale di rilascio:

Canale di rilascio	Versione di Config Sync
Rapido	1,18
Normale	1,17
Stabile (o nessun canale)	1,16

Abilita gli upgrade automatici

Abilita gli upgrade automatici per garantire che l'upgrade di Config Sync venga eseguito automaticamente nei cluster in tutto il parco risorse.

Puoi abilitare gli upgrade automatici solo su GKE su cluster Google Cloud in cui è abilitato GKE Enterprise.

Attenzione: non puoi tornare agli upgrade manuali dopo aver abilitato gli upgrade automatici.

Per installare Config Sync e abilitare gli upgrade automatici, segui le istruzioni in Installare Config Sync.

Per abilitare gli upgrade automatici in un cluster in cui Config Sync è già installato, completa questi passaggi:

1. Verifica che il cluster GKE sia registrato in un canale di rilascio. Se il cluster GKE non è registrato in un canale di rilascio, Config Sync esegue automaticamente l'upgrade come se il cluster utilizzasse il canale di rilascio GKE stabile.
2. Se non hai già configurato Config Sync per l'invio delle metriche a Cloud Monitoring, concedi le autorizzazioni di scrittura delle metriche. Questa operazione è necessaria per gli upgrade automatici.

3. Assicurati che Config Sync sia in una versione supportata:

   console

   1. Nella console Google Cloud, vai alla pagina Configurazione nella sezione Funzionalità.

      Vai a Configurazione

   2. Nella scheda Impostazioni, accanto al cluster di cui vuoi eseguire l'upgrade della versione, fai clic su Modifica configurazione cluster.
   3. Nell'elenco a discesa Versione, seleziona la versione a cui vuoi eseguire l'upgrade.
   4. Fai clic su Esegui l'upgrade di Config Sync.

   gcloud

   1. (Facoltativo) Se vuoi verificare quale versione di Config Sync è installata sui tuoi cluster prima di eseguire l'upgrade, esegui questo comando:

      gcloud beta container fleet config-management
      

   2. Per eseguire l'upgrade di Config Sync, esegui questo comando:

      gcloud beta container fleet config-management upgrade \
          --version=VERSION \
          --membership=MEMBERSHIP_NAME
      

      Sostituisci quanto segue:

      • VERSION: la versione a cui vuoi eseguire l'upgrade
      • MEMBERSHIP_NAME: il nome dell'appartenenza al parco risorse che hai scelto al momento della registrazione del cluster. Puoi trovare il nome dell'abbonamento eseguendo gcloud container fleet memberships list.

4. Abilita gli upgrade automatici di Config Sync:

   console

   Abilita gli upgrade automatici sui singoli cluster

   Per abilitare gli upgrade automatici sui singoli cluster, completa questi passaggi:

   1. Nella console Google Cloud, vai alla pagina Configurazione nella sezione Funzionalità.

      Vai a Configurazione

   2. Fai clic su Config Sync settings (Impostazioni di configurazione di sincronizzazione).
   3. Seleziona Modifica configurazione cluster per il cluster che vuoi aggiornare.
   4. Nel riquadro delle impostazioni che viene visualizzato, seleziona Upgrade automatici.
   5. Fai clic su Modifica le impostazioni di Config Sync. Dopo alcuni minuti della scheda Impostazioni, dovresti vedere Sì nella colonna Upgrade automatici per il cluster selezionato.

   Abilita gli upgrade automatici come impostazione predefinita del parco risorse

   Per abilitare gli upgrade automatici nel parco risorse di cluster, completa i seguenti passaggi:

   1. Nella console Google Cloud, vai alla pagina Gestore funzionalità.

      Vai a Gestore funzionalità

   2. Nel riquadro Config Sync, fai clic su Configura.

   3. Per modificare le impostazioni predefinite, fai clic su Personalizza le impostazioni del parco risorse.

   4. Nella finestra di dialogo visualizzata, seleziona Upgrade automatici.

   5. Fai clic su Salva modifiche.

   6. (Facoltativo) Sincronizza i cluster esistenti con le impostazioni predefinite:

      1. Vai alla pagina Gestore funzionalità.

         Vai a Gestore funzionalità

      2. Nel riquadro Config Sync, fai clic su Visualizza dettagli.

      3. Nell'elenco Cluster nel parco risorse, seleziona i cluster che vuoi sincronizzare.

      4. Fai clic su Sincronizza con le impostazioni del parco risorse e fai clic su Conferma nella finestra di dialogo di conferma visualizzata. Il completamento di questa operazione può richiedere alcuni minuti.

   gcloud

   Per abilitare gli upgrade automatici per un singolo cluster, completa i seguenti passaggi:

   1. Aggiorna Google Cloud CLI alla versione più recente:

      gcloud components update
      

   2. Aggiorna il file Config Sync apply spec esistente per includere il campo upgrades: auto, ad esempio:

      applySpecVersion: 1
      spec:
        upgrades: auto
        configSync:
          enabled: true
      # other fields intentionally omitted
      

   3. Applica il file apply-spec.yaml aggiornato:

      gcloud beta container fleet config-management apply \
          --membership=MEMBERSHIP_NAME \
          --config=CONFIG_YAML_PATH \
          --project=PROJECT_ID
      

      Sostituisci quanto segue:

      • MEMBERSHIP_NAME: il nome dell'appartenenza al parco risorse che hai scelto al momento della registrazione del cluster. Puoi trovare il nome con gcloud container fleet memberships list.
      • CONFIG_YAML_PATH: il percorso del tuo file apply-spec.yaml.
      • PROJECT_ID: il tuo ID progetto.

   4. Verifica che l'upgrade automatico sia attivato:

      gcloud beta container fleet config-management status \
        --project=PROJECT_ID
      

      Sostituisci PROJECT_ID con l'ID del progetto.

      La colonna Upgrades mostra "automatico" per i cluster in cui sono abilitati gli upgrade automatici. Se si verifica un errore durante l'attivazione degli upgrade automatici, la colonna Status mostra ERROR con un messaggio di errore dettagliato.

Cambiare il canale di rilascio

Per informazioni su come modificare il canale di rilascio del cluster, consulta Modificare il canale di rilascio del cluster nella documentazione di GKE. Se hai abilitato gli upgrade automatici per Config Sync, tieni presente quanto segue quando modifichi il canale di rilascio:

• Se modifichi il canale di rilascio impostandolo su un canale meno stabile (ad esempio, da Stabile a Rapido), Config Sync eseguirà l'upgrade automatico dall'ultima versione supportata sul canale di rilascio originale alla versione più recente supportata sul nuovo canale di rilascio.
• Se cambi il canale di rilascio impostandolo su un canale più stabile (ad esempio, da Rapido a Stabile), Config Sync non eseguirà il downgrade delle versioni. Nel corso del tempo, l'ultima versione supportata sul canale di rilascio originale verrà promossa nel nuovo canale di rilascio. Man mano che versioni più recenti diventano disponibili sul nuovo canale di rilascio, l'upgrade di Config Sync avverrà automaticamente.
• L'annullamento dell'iscrizione a un canale di rilascio non influisce sugli upgrade automatici di Config Sync. Verrà eseguito l'upgrade della versione di Config Sync come se il cluster fosse registrato nel canale di rilascio Stabile.

Esegui l'upgrade manuale di Config Sync

Prima di eseguire l'upgrade di Config Sync, consulta le note di rilascio per i dettagli sulle modifiche tra le versioni. Se devi eseguire l'upgrade da una versione di Config Sync non supportata, devi eseguire un upgrade passo passo con incrementi a un massimo di tre versioni secondarie alla volta. Ad esempio, se la versione corrente di Config Sync è 1.10.0, procedi con l'upgrade alla versione 1.13.0 e poi alla versione 1.16.0.

Nota: se utilizzi Config Controller per installare e gestire Config Sync, non è necessario eseguire l'upgrade manualmente. Config Controller è un servizio gestito, quindi Google lo esegue automaticamente. Per maggiori dettagli sulle modifiche di Config Controller, consulta le note di rilascio di Config Controller.

Per eseguire l'upgrade di Config Sync, completa i seguenti passaggi:

console

1. Nella console Google Cloud, vai alla pagina Configurazione nella sezione Funzionalità.

   Vai a Configurazione

2. Nella scheda Impostazioni, accanto al cluster di cui vuoi eseguire l'upgrade di Config Sync, seleziona Modifica configurazione cluster.
3. Nell'elenco a discesa Versione, seleziona la versione a cui vuoi eseguire l'upgrade.
4. Fai clic su Esegui l'upgrade di Config Sync.

gcloud

1. (Facoltativo) Se vuoi verificare quale versione di Config Sync è installata sui tuoi cluster prima di eseguire l'upgrade, esegui questo comando:

   gcloud beta container fleet config-management version
   

2. Esegui questo comando:

   gcloud beta container fleet config-management upgrade \
       --version=VERSION \
       --membership=MEMBERSHIP_NAME
   

   Sostituisci quanto segue:

   • VERSION: la versione a cui vuoi eseguire l'upgrade.
   • MEMBERSHIP_NAME: il nome dell'appartenenza al parco risorse che hai scelto al momento della registrazione del cluster. Puoi trovare il nome dell'abbonamento eseguendo gcloud container fleet memberships list.