升级 Config Sync

本页面介绍如何升级集群上安装的 Config Sync 版本。

手动升级 Config Sync

为了确保不超出支持期，我们建议您至少每 9 个月升级一次。不过，您可以更频繁地升级，以获取最新的功能和安全更新。

如果您的 Config Sync 版本不受支持，您可以尝试使用以下选项之一进行升级：

（推荐）执行分步升级，每次的增量不超过两个次要版本。例如，如果您使用的是版本 N-4（不受支持的版本），则应先升级到 N-2（受支持的版本），然后再升级到 N（受支持的版本）。此方法是最安全的升级方法，但仅当第一个增量升级是升级到受支持的版本时才有效。
直接升级到受支持的版本。如果您无法执行分步升级，可以尝试直接升级到受支持的版本。例如，如果您使用的是版本 N-6（不受支持的版本），则尝试执行增量升级到 N-4（不受支持的版本）将不起作用。在这种情况下，您可以尝试直接升级到 N-2（最早支持的版本）。
如果您的 Config Sync 版本明显落后，并且之前的选项不起作用，您可以卸载并重新安装 Config Sync。

在升级 Config Sync 之前，请查看版本说明以详细了解版本之间的变化。

如需升级 Config Sync，请完成以下步骤：

（可选）如果要在升级之前检查集群上安装的 Config Sync 版本，请运行以下命令：
```
gcloud beta container fleet config-management version
```
运行以下命令：
```
gcloud beta container fleet config-management upgrade \
    --version=VERSION \
    --membership=MEMBERSHIP_NAME
```
请替换以下内容：
- VERSION：要升级到的版本。
- MEMBERSHIP_NAME：您在注册集群时选择的舰队成员资格名称。您可以通过运行 gcloud container fleet memberships list 找到成员资格名称。

如需停用 Config Sync 自动升级，请完成以下步骤：

在 google_gke_hub_feature_membership 资源中将 configmanagement.management 字段设置为 MANAGEMENT_MANUAL。

在 GKEHubFeatureMembership 资源中将 configmanagement.management 字段设置为 MANAGEMENT_MANUAL。