Esegui l'upgrade di Config Sync

In questa pagina viene spiegato come eseguire l'upgrade della versione di Config Sync installata sul tuo 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 in modo che esegui l'upgrade automatico alle versioni più recenti sui tuoi cluster GKE su Google Cloud.

L'attivazione degli upgrade automatici per Config Sync semplifica la gestione un'esperienza senza intervento manuale. Google si assume la responsabilità di eseguire l'upgrade automatico delle versioni di Config Sync e di supervisionare il ciclo di vita dei relativi componenti. L'attivazione degli upgrade automatici offre i seguenti vantaggi:

• Oneri di manutenzione inferiori: evita di monitorare le versioni più recenti di Config Sync e di eseguire manualmente l'upgrade di Config Sync nei tuoi cluster.
• Mantieni le versioni supportate: Google gestisce la versione supportata più recente nei tuoi cluster, assicurandosi che tu non stia utilizzando una versione non supportata di Config Sync.
• Maggiore affidabilità: Google gestisce i componenti di Config Sync e li riconcilia in caso di alterazioni.

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 non viene utilizzato un canale di rilascio GKE viene considerato come un cluster che utilizza canale di rilascio.

Puoi utilizzare gli upgrade automatici per assicurarti che l'upgrade di Config Sync sui tuoi cluster venga eseguito automaticamente. Quando una nuova versione di Config Sync è disponibile in una release specifico, Config Sync esegue l'upgrade della versione di Config Sync corrispondente al cluster canale di rilascio. Il canale rapido offre la versione più recente di Config Sync non appena sarà disponibile. Il canale regolare offre la versione più recente di Config Sync ragionevolmente presto. Il canale stabile offre la versione più recente di Config Sync solo dopo essere state convalidate sui canali Rapido e Regolare.

Per saperne di più sui canali di rilascio, consulta Informazioni sui canali di rilascio.

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

Canale di rilascio	Versione di Config Sync
Rapido e regolare	1,19
Stabile (o nessun canale)	1.18.3

Attivare gli upgrade automatici

Attiva gli upgrade automatici per assicurarti che venga eseguito l'upgrade di Config Sync sui tuoi cluster automaticamente nel tuo parco risorse.

Puoi abilitare gli upgrade automatici solo su GKE su Cluster Google Cloud con GKE Enterprise abilitato.

Attenzione: non puoi tornare agli upgrade manuali tramite la console Google Cloud dopo aver attivato gli upgrade automatici. Utilizza gcloud o Terraform per tornare indietro.

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

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

1. Conferma che il cluster GKE sia è registrato in un canale di rilascio. Se il cluster GKE non è registrato in un canale di rilascio, Config Sync vengono eseguiti automaticamente come se il cluster utilizzasse il canale di rilascio GKE stabile.
2. Se non hai configurato in precedenza Config Sync per l'invio delle metriche a Cloud Monitoring, concedere autorizzazioni alla 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, fai clic su Modifica configurazione cluster accanto al cluster di cui vuoi eseguire l'upgrade.
   3. Nell'elenco a discesa Versione, seleziona la versione di cui vuoi eseguire l'upgrade a.
   4. Fai clic su Esegui l'upgrade di Config Sync.

   gcloud

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

      gcloud beta container fleet config-management
      

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

      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 quando hai registrato il cluster. Puoi trovare il nome dell'abbonamento in base al con gcloud container fleet memberships list.

4. Attiva gli upgrade automatici di Config Sync:

   console

   Attivare gli upgrade automatici sui singoli cluster

   Per attivare gli upgrade automatici sui singoli cluster, compila i seguenti passaggi:

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

      Vai a Config

   2. Fai clic su Impostazioni di Config Sync.
   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 impostazioni di Config Sync. Nella scheda Impostazioni, dopo alcuni minuti dovresti vedere Sì nella colonna Upgrade automatici per il cluster selezionato.

   Attivare gli upgrade automatici come impostazione predefinita del parco

   Per abilitare gli upgrade automatici nel 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 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 ti interessano da sincronizzare.

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

   gcloud

   Per attivare 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 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 al parco risorse che hai scelto quando hai registrato il cluster. Puoi trovare il nome con gcloud container fleet memberships list.
      • CONFIG_YAML_PATH: il percorso apply-spec.yaml file.
      • 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 "auto" per i cluster con gli upgrade automatici abilitati. Se si verifica un errore durante l'attivazione degli upgrade automatici, la colonna Status viene visualizzata. ERROR con un messaggio di errore dettagliato.

Modificare il canale di uscita

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 attivato gli upgrade automatici per Config Sync, quando modifichi il canale di rilascio devi tenere presente quanto segue:

• Se modifichi il canale di rilascio impostandolo su un canale meno stabile (ad esempio, da stabile a rapido), Config Sync eseguirà l'upgrade automatico dalla versione supportata sul canale di rilascio originale alla versione più recente supportati sul canale delle nuove uscite.
• 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 tempo, la versione più recente supportata sul canale di rilascio originale verrà promossa al nuovo canale di rilascio. Man mano che sono disponibili versioni più recenti il nuovo canale di rilascio, Config Sync verrà aggiornato automaticamente in modo automatico.
• Se annulli l'iscrizione a un canale di rilascio, ciò non influisce sugli upgrade automatici di Config Sync. Verrà eseguito l'upgrade della versione di Config Sync come se il cluster è stato registrato al canale di rilascio Stabile.

Eseguire l'upgrade manuale di Config Sync

Prima di eseguire l'upgrade di Config Sync, controlla note di rilascio per informazioni dettagliate su cosa è cambiato da una versione all'altra. Se devi eseguire l'upgrade da una versione di Config Sync non supportata, devi eseguire un upgrade passo passo con incrementi di massimo tre versioni secondarie alla volta. Ad esempio, se la versione corrente di Config Sync è 1.11.0, il primo upgrade alla versione 1.14.0 e quindi alla versione 1.17.0.

Nota: se utilizzi Config Controller per installare e gestire Config Sync, eseguire l'upgrade manualmente. Config Controller è un servizio gestito, quindi Google ne esegue automaticamente l'upgrade. Per informazioni dettagliate sulle modifiche 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 Config

2. Nella scheda Impostazioni, accanto al cluster di cui vuoi eseguire l'upgrade della versione di Config Sync, seleziona Modifica configurazione cluster.
3. Dall'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 quando hai registrato il cluster. Puoi trovare il nome dell'abbonamento in base al con gcloud container fleet memberships list.