Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina spiega come eseguire l'upgrade della versione di Config Sync installata sui tuoi cluster.
Esegui l'upgrade manuale di Config Sync
Per rimanere all'interno del
periodo di assistenza,
ti consigliamo di eseguire l'upgrade almeno ogni nove mesi. Tuttavia, puoi
eseguire l'upgrade più spesso per ottenere le funzionalità e gli aggiornamenti della sicurezza più recenti.
Eseguire l'upgrade da una versione non supportata
Se la tua versione di Config Sync non è supportata, puoi provare a eseguirne l'upgrade
utilizzando una delle seguenti opzioni:
(Consigliato) Esegui un upgrade passo passo con incrementi non superiori a
due versioni secondarie alla volta. Ad esempio, se utilizzi la versione N-4 (una versione non supportata), devi eseguire l'upgrade alla versione N-2 (una versione supportata) e poi puoi eseguire l'upgrade alla versione N (una versione supportata). Questo approccio è il metodo più sicuro per l'upgrade, ma funziona solo se il primo upgrade incrementale è a una versione supportata.
Esegui l'upgrade direttamente a una versione supportata. Se non riesci a eseguire un upgrade
passo passo, puoi provare a eseguire l'upgrade direttamente a una versione supportata. Ad esempio,
se utilizzi la versione N-6 (una versione non supportata), il tentativo di eseguire un
aggiornamento incrementale alla versione N-4 (una versione non supportata) non andrà a buon fine. In questo
scenario, puoi provare a eseguire l'upgrade direttamente alla versione N-2 (la versione
supportata meno recente).
Se la versione di Config Sync è molto precedente e le opzioni precedenti non funzionano, puoi disinstallare e reinstallare Config Sync.
Esegui l'upgrade di Config Sync
Prima di eseguire l'upgrade di Config Sync, controlla le
note di rilascio per
informazioni dettagliate sulle modifiche apportate tra le versioni.
Per eseguire l'upgrade di Config Sync, completa i seguenti passaggi:
console
Nella console Google Cloud , vai alla pagina Config nella sezione Funzionalità.
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.
Esegui l'upgrade automatico di Config Sync
Disattivare gli upgrade automatici
Per disattivare gli upgrade automatici di Config Sync, completa i seguenti passaggi:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-31 UTC."],[],[],null,["# Upgrade Config Sync\n\nThis page explains how to upgrade the Config Sync version installed on your\nclusters.\n\nManually upgrade Config Sync\n----------------------------\n\nTo stay within the\n[support window](/kubernetes-engine/enterprise/config-sync/docs/get-support-config-sync#recommended_version),\nwe recommend that you upgrade at least every nine months. However, you can\nupgrade more frequently to get the latest features and security updates.\n\n### Upgrade from an unsupported version\n\nIf your version of Config Sync is unsupported, you can try to upgrade it by\nusing one of the following options:\n\n- (Recommended) Perform a step-by-step upgrade with increments of no more than two minor versions at a time. For example, if you're on version N-4 (an unsupported version), you should upgrade to N-2 (a supported version), and then you can upgrade to N (a supported version). This approach is the safest method to upgrade, but only works if the first incremental upgrade is to a supported version.\n- Upgrade directly to a supported version. If you can't perform a step-by-step upgrade, you can try upgrading directly to a supported version. For example, if you're on version N-6 (an unsupported version), trying to perform an incremental upgrade to N-4 (an unsupported version) won't work. In this scenario, you can try upgrading directly to N-2 (the earliest supported version).\n- If your Config Sync version is significantly behind, and the previous options don't work, you can uninstall and reinstall Config Sync.\n\nUpgrade Config Sync\n-------------------\n\nBefore you upgrade Config Sync, check the\n[release notes](/kubernetes-engine/enterprise/config-sync/docs/release-notes) for\ndetails on what's changed between versions.\n| **Note:** If you use Config Controller to install and manage Config Sync, you don't need to manually upgrade. Config Controller is a managed service, so Google upgrades it automatically. For details on Config Controller changes, see the [Config Controller release notes](/kubernetes-engine/enterprise/config-controller/docs/release-notes).\n\nTo upgrade Config Sync, complete the following steps: \n\n### console\n\n1. In the Google Cloud console, go to the **Config** page under the **Features** section.\n\n \u003cbr /\u003e\n\n [Go to Config](https://console.cloud.google.com/kubernetes/config_management)\n2. Under the **Settings** tab, next to the cluster whose Config Sync version you want to upgrade, select **Edit cluster config**.\n3. From the **Version** drop-down list, select the version that you want to upgrade to.\n4. Click **Upgrade Config Sync**.\n\n### gcloud\n\n1. (Optional) If you want to check which Config Sync version is installed on your clusters before you upgrade, run the following command:\n\n gcloud beta container fleet config-management version\n\n2. Run the following command:\n\n gcloud beta container fleet config-management upgrade \\\n --version=\u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e \\\n --membership=\u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e: the version that you want to upgrade to.\n - \u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e: the fleet membership name that you chose when you registered your cluster. You can find the membership name by running `gcloud container fleet memberships list`.\n\nAuto-upgrade Config Sync\n------------------------\n\n| **Caution:** The Config Sync auto-upgrades feature is unavailable starting in Config Sync version 1.21.0. You can no longer configure auto-upgrade settings and must [manually upgrade the Config Sync version](/kubernetes-engine/enterprise/config-sync/docs/how-to/upgrade-config-sync#manually-upgrade). If you currently use auto-upgrades, you must first [disable auto-upgrades](/kubernetes-engine/enterprise/config-sync/docs/how-to/upgrade-config-sync#disable-auto-upgrades) before you can manually update Config Sync.\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\n### Disable auto-upgrades\n\nTo disable Config Sync auto-upgrades, complete the following steps:\n**Important:** You can't disable Config Sync auto-upgrades through the Google Cloud console. Use the gcloud CLI or Terraform instructions instead. \n\n### gcloud\n\nRemove the `upgrades` field from your [Google Cloud CLI `apply spec`\nfile](/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields#config_sync).\n\n### Terraform\n\nSet the `configmanagement.management` field to `MANAGEMENT_MANUAL` in the\n[google_gke_hub_feature_membership](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/gke_hub_feature_membership#configmanagement-1)\nresource.\n| **Important:** Don't remove the `configmanagement.management` field from the `google_gke_hub_feature_membership` resource. Removing the field doesn't disable Config Sync auto-upgrades since Terraform can't detect the change.\n\n### Config Connector\n\nSet the `configmanagement.management` field to `MANAGEMENT_MANUAL` in the\n[`GKEHubFeatureMembership`](/config-connector/docs/reference/resource-docs/gkehub/gkehubfeaturemembership)\nresource.\n| **Important:** Don't remove the `configmanagement.management` field from the `GKEHubFeatureMembership` resource. Removing the field doesn't disable Config Sync auto-upgrades and causes the fields to become [externally-managed](/config-connector/docs/concepts/managing-fields-externally) instead of managed by Config Connector."]]
