Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan cara mengupgrade versi Config Sync yang diinstal di
cluster Anda.
Mengupgrade Config Sync secara manual
Agar tetap berada dalam
periode dukungan,
sebaiknya Anda mengupgrade setidaknya setiap sembilan bulan. Namun, Anda dapat mengupgrade lebih sering untuk mendapatkan fitur dan update keamanan terbaru.
Melakukan upgrade dari versi yang tidak didukung
Jika versi Config Sync Anda tidak didukung, Anda dapat mencoba mengupgradenya dengan menggunakan salah satu opsi berikut:
(Direkomendasikan) Lakukan upgrade langkah demi langkah dengan kenaikan tidak lebih dari
dua versi minor sekaligus. Misalnya, jika Anda menggunakan versi N-4 (versi yang tidak didukung), Anda harus mengupgrade ke N-2 (versi yang didukung), lalu Anda dapat mengupgrade ke N (versi yang didukung). Pendekatan ini adalah metode upgrade yang paling aman, tetapi hanya berfungsi jika upgrade inkremental pertama adalah ke versi yang didukung.
Upgrade langsung ke versi yang didukung. Jika tidak dapat melakukan upgrade langkah demi langkah, Anda dapat mencoba melakukan upgrade langsung ke versi yang didukung. Misalnya,
jika Anda menggunakan versi N-6 (versi yang tidak didukung), mencoba melakukan
upgrade inkremental ke N-4 (versi yang tidak didukung) tidak akan berhasil. Dalam
skenario ini, Anda dapat mencoba mengupgrade langsung ke N-2 (versi
paling awal yang didukung).
Jika versi Config Sync Anda jauh tertinggal, dan opsi sebelumnya tidak berfungsi, Anda dapat meng-uninstal dan menginstal ulang Config Sync.
Mengupgrade Config Sync
Sebelum mengupgrade Config Sync, periksa
catatan rilis untuk mengetahui detail tentang perubahan antar-versi.
Untuk mengupgrade Config Sync, selesaikan langkah-langkah berikut:
console
Di konsol Google Cloud , buka halaman Config di bagian Features.
MEMBERSHIP_NAME: nama keanggotaan fleet yang Anda pilih
saat mendaftarkan cluster. Anda dapat menemukan nama keanggotaan dengan menjalankan gcloud container fleet memberships list.
Mengupgrade Config Sync secara otomatis
Menonaktifkan upgrade otomatis
Untuk menonaktifkan upgrade otomatis Config Sync, selesaikan langkah-langkah berikut:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]
