Esegui l'upgrade di Config Sync

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

Esegui l'upgrade automatico di Config Sync

Anteprima

Questo prodotto è soggetto ai "Termini delle offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti 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 in modo che venga eseguito l'upgrade automatico alle versioni più recenti sui tuoi cluster GKE su Google Cloud.

L'attivazione degli upgrade automatici per Config Sync aiuta a semplificare 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 componenti. L'attivazione degli upgrade automatici offre i seguenti vantaggi:

• Minore overhead di manutenzione: evita il monitoraggio delle versioni più recenti di Config Sync ed esegui manualmente l'upgrade di Config Sync nei tuoi cluster.
• Mantieni le versioni supportate: Google gestisce l'ultima versione supportata nei tuoi cluster, garantendo che non utilizzi una versione non supportata di Config Sync.
• Maggiore affidabilità: Google gestisce i componenti di Config Sync e riconcilia i componenti in caso di modifiche.

Versioni di Config Sync e canali di rilascio di 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 trattato come un cluster utilizzando il canale di rilascio GKE stabile.

Puoi utilizzare gli upgrade automatici per garantire che Config Sync venga eseguito automaticamente sui tuoi cluster. Quando una nuova versione di Config Sync è disponibile su un canale di rilascio, Config Sync esegue l'upgrade della versione di Config Sync 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 offrirà la versione più recente di Config Sync a breve. Il canale stabile offre la versione più recente di Config Sync solo dopo essere stato convalidato sui canali Rapida e Regola.

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

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

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

Abilita gli upgrade automatici

Abilita gli upgrade automatici per assicurarti che Config Sync venga eseguito automaticamente sui tuoi 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 su un cluster in cui è già installato Config Sync, completa questi passaggi:

1. Verifica che il tuo 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. Questo passaggio è obbligatorio per gli upgrade automatici.

3. Se Config Sync è in una versione precedente alla 1.15.0, eseguine l'upgrade manuale almeno alla versione 1.15.0:

   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, 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 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 del 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 su singoli cluster

   Per abilitare gli upgrade automatici su singoli cluster, completa i seguenti 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 sincronizzazione).
   3. Seleziona Modifica configurazione cluster per il cluster che vuoi aggiornare.
   4. Nel riquadro delle impostazioni visualizzato, seleziona Upgrade automatici.
   5. Fai clic su Modifica le impostazioni di Config Sync. Dopo alcuni minuti, nella scheda Impostazioni dovresti vedere Sì nella colonna Upgrade automatici per il cluster che hai selezionato.

   Attiva gli upgrade automatici come impostazione predefinita per il parco risorse

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

   1. Nella console Google Cloud, vai alla pagina Gestione 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 Gestione 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. Questa operazione può richiedere alcuni minuti.

   gcloud

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

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

      gcloud components update
      

   2. Aggiorna il file apply spec di Config Sync esistente in modo da 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 del 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 file apply-spec.yaml.
      • PROJECT_ID: il tuo ID progetto.

   4. Verifica che l'upgrade automatico sia abilitato:

      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 con upgrade automatici abilitati. Se si verifica un errore durante l'attivazione degli upgrade automatici, la colonna Status mostra ERROR con un messaggio di errore dettagliato.

Modificare 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, valuta i seguenti aspetti 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 all'ultima versione supportata sul nuovo canale di rilascio.
• Se modifichi 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 sul nuovo canale di rilascio. Man mano che versioni più recenti diventano disponibili sul nuovo canale di rilascio, Config Sync eseguirà automaticamente l'upgrade normalmente.
• L'annullamento dell'iscrizione a un canale di rilascio non influisce sugli upgrade automatici di Config Sync. La versione di Config Sync verrà aggiornata come se il cluster fosse stato registrato nel canale di rilascio stabile.

Esegui manualmente l'upgrade di Config Sync

Prima di eseguire l'upgrade di Config Sync, consulta le note di rilascio per i dettagli sulle modifiche apportate da una versione all'altra. Se devi eseguire l'upgrade da una versione di Config Sync non supportata, devi eseguire un upgrade dettagliato con incrementi fino a un massimo di tre versioni secondarie alla volta. Ad esempio, se la versione corrente di Config Sync è 1.10.0, passa 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 ne esegue l'upgrade automatico. Per maggiori dettagli sulle modifiche apportate a 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 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 del parco risorse che hai scelto al momento della registrazione del cluster. Puoi trovare il nome dell'abbonamento eseguendo gcloud container fleet memberships list.