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

Puoi configurare Config Sync per l'upgrade automatico alle versioni più recenti nel tuo GKE su cluster Google Cloud.

L'attivazione degli upgrade automatici per Config Sync semplifica la gestione un'esperienza senza intervento manuale. Google si assume la responsabilità dell'upgrade automatico delle versioni di Config Sync e della supervisione del ciclo di vita dei suoi componenti. Abilitazione in corso... gli upgrade automatici offrono i seguenti vantaggi:

  • Riduzione dell'overhead di manutenzione: evita di monitorare versioni di Config Sync più recenti e l'upgrade manuale di Config Sync nei tuoi cluster.
  • Mantieni le versioni supportate: Google gestisce l'ultima versione supportata nei tuoi cluster, verificando di non utilizzare 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 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 utilizza un canale di rilascio GKE viene considerato come un cluster che utilizza canale di rilascio.

Puoi utilizzare gli upgrade automatici per assicurarti che venga eseguito l'upgrade di Config Sync nei tuoi cluster 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 ulteriori informazioni 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

Rapida

1,18

Normale

1,17

Stabile (o nessun canale)

1,16

Abilita gli upgrade automatici

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

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

Per installare Config Sync e abilitare gli upgrade automatici, segui le istruzioni riportate in Installa 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, accanto al cluster di cui vuoi eseguire la versione upgrade, fai clic su Modifica configurazione cluster.
    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 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.

  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 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 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. Nella scheda Impostazioni, dopo alcune minuti, dovresti vedere Sì nella colonna Upgrade automatici per 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 ti interessano da 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 per completare l'operazione.

    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 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. Lo puoi trovare 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.

      Nella colonna Upgrades viene visualizzato il valore "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 viene visualizzata. ERROR con un messaggio di errore dettagliato.

Cambiare il canale di rilascio

Per informazioni sulla modifica del 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 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 sarà promosso nel canale delle nuove uscite. Man mano che sono disponibili versioni più recenti il nuovo canale di rilascio, Config Sync verrà aggiornato automaticamente in modo automatico.
  • L'annullamento dell'iscrizione a un canale di rilascio non influisce su Config Sync e gli upgrade automatici. Verrà eseguito l'upgrade della versione di Config Sync come se il cluster è stato registrato al canale di rilascio Stabile.

Esegui l'upgrade manuale di Config Sync

Prima di eseguire l'upgrade di Config Sync, controlla note di rilascio per informazioni dettagliate su cosa cambia da una versione all'altra. Se devi eseguire l'upgrade da un una versione di Config Sync non supportata, devi eseguire un upgrade dettagliato con incrementi a non più di tre versioni secondarie alla volta. Ad esempio, se La versione attuale di Config Sync è 1.10.0, esegui l'upgrade alla versione 1.13.0 e e poi alla versione 1.16.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 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 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.