Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment mettre à niveau la version de Config Sync installée sur vos clusters.
Mettre à jour Config Sync manuellement
Pour rester dans la période de compatibilité, nous vous recommandons de mettre à niveau votre application au moins tous les neuf mois. Toutefois, vous pouvez effectuer une mise à niveau plus fréquemment pour bénéficier des dernières fonctionnalités et mises à jour de sécurité.
Mettre à niveau à partir d'une version non compatible
Si votre version de Config Sync n'est pas compatible, vous pouvez essayer de la mettre à niveau en utilisant l'une des options suivantes :
(Recommandé) Effectuez une mise à niveau étape par étape, par incréments de deux versions mineures à la fois au maximum. Par exemple, si vous utilisez la version N-4 (une version non compatible), vous devez passer à la version N-2 (une version compatible), puis à la version N (une version compatible). Cette approche est la méthode la plus sûre pour effectuer une mise à niveau, mais elle ne fonctionne que si la première mise à niveau incrémentielle concerne une version compatible.
Passez directement à une version compatible. Si vous ne pouvez pas effectuer une mise à niveau progressive, vous pouvez essayer de passer directement à une version compatible. Par exemple, si vous utilisez la version N-6 (version non compatible), vous ne pourrez pas effectuer de mise à niveau incrémentielle vers la version N-4 (version non compatible). Dans ce scénario, vous pouvez essayer de passer directement à la version N-2 (la version la plus ancienne compatible).
Si votre version de Config Sync est très ancienne et que les options précédentes ne fonctionnent pas, vous pouvez désinstaller et réinstaller Config Sync.
Mettre à jour Config Sync
Avant de mettre à jour Config Sync, consultez les notes de version pour en savoir plus sur les changements entre les versions.
Pour mettre à niveau Config Sync, procédez comme suit :
Console
Dans la console Google Cloud , accédez à la page Configuration sous la section Fonctionnalités.
Dans l'onglet Paramètres, à côté du cluster dont vous souhaitez mettre à niveau la version de Config Sync, sélectionnez Modifier la configuration du cluster.
Dans la liste déroulante Version, sélectionnez la version vers laquelle vous souhaitez effectuer la mise à niveau.
Cliquez sur Mettre à niveau Config Sync.
gcloud
(Facultatif) Si vous souhaitez vérifier quelle version de Config Sync est installée sur vos clusters avant la mise à niveau, exécutez la commande suivante :
VERSION : version vers laquelle vous souhaitez effectuer la mise à jour.
MEMBERSHIP_NAME : nom d'appartenance de parc que vous avez choisi lors de l'enregistrement de votre cluster. Vous pouvez trouver le nom d'appartenance en exécutant la commande gcloud container fleet memberships list.
Mettre à niveau Config Sync automatiquement
Désactiver les mises à niveau automatiques
Pour désactiver les mises à niveau automatiques de Config Sync, procédez comme suit :
Définissez le champ configmanagement.management sur MANAGEMENT_MANUAL dans la ressource GKEHubFeatureMembership.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
