Esegui l'upgrade di Config Sync

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

Eseguire l'upgrade automatico di Config Sync

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 tua esperienza di gestione. 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 che non utilizza un canale di rilascio GKE viene trattato come un cluster che utilizza il canale di rilascio GKE stabile.

Puoi utilizzare gli upgrade automatici per assicurarti che l'upgrade di Config Sync sui tuoi cluster venga eseguito automaticamente. Quando è disponibile una nuova versione di Config Sync in un canale di rilascio, Config Sync esegue l'upgrade della versione corrispondente al canale di rilascio del cluster. Il canale Rapid offre l'ultima versione di Config Sync non appena è disponibile. Il canale regolare offre l'ultima versione di Config Sync in tempi ragionevolmente brevi. Il canale stabile offre la versione più recente di Config Sync solo dopo la convalida nei 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 ogni canale di rilascio:

Canale di rilascio

Versione Config Sync

Rapida o normale

1,20

Stabile (o nessun canale)

1.19.2

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 attivare gli upgrade automatici solo su GKE su Google Cloud cluster in cui è abilitato GKE Enterprise.

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

Per abilitare gli upgrade automatici su un cluster in cui è già installato Config Sync, completa i seguenti 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 l'upgrade automatico come se il cluster utilizzasse il canale di rilascio GKE stabile.
  2. Se non hai ancora configurato Config Sync per inviare le metriche a Cloud Monitoring, concedi le autorizzazioni di scrittura delle metriche. Questo è necessario per gli upgrade automatici.

  3. Assicurati che Config Sync sia installato su una versione supportata:

    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, fai clic su Modifica configurazione cluster.
    3. Nell'elenco a discesa Versione, seleziona la versione di cui vuoi eseguire l'upgrade.
    4. Fai clic su Esegui l'upgrade di Config Sync.

    gcloud

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

      gcloud beta container fleet config-management

    2. Per eseguire l'upgrade di Config Sync, esegui il seguente 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 eseguendo gcloud container fleet memberships list.

  4. Attiva gli upgrade automatici di Config Sync:

    console

    Attivare gli upgrade automatici sui singoli cluster

    Per abilitare 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 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 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 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 del apply-spec.yaml file.
      • 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 tuo 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, nella colonna Status viene visualizzato 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 cambi il canale di rilascio con uno 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 cambi il canale di rilascio con uno 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 le versioni più recenti diventano disponibili nel nuovo canale di rilascio, Config Sync eseguirà l'upgrade automatico normalmente.
  • 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 fosse registrato al canale di rilascio Stabile.

Eseguire l'upgrade manuale di Config Sync

Prima di eseguire l'upgrade di Config Sync, consulta le note di rilascio per approfondire le modifiche apportate tra le versioni. 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.14.0, esegui prima l'upgrade alla versione 1.17.0 e poi alla versione 1.20.0.

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 controllare quale versione di Config Sync è installata sui tuoi cluster prima di eseguire l'upgrade, esegui il seguente 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 eseguendo gcloud container fleet memberships list.