升级 Config Sync

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

自动升级 Config Sync

您可以配置 Config Sync，使其在 GKE on Google Cloud 集群上自动升级为较新版本。

为 Config Sync 启用自动升级有助于简化您的管理体验。Google 承担自动升级 Config Sync 版本和监督其组件的生命周期。启用自动升级功能具有以下优势：

  • 降低维护开销：避免监控较新的 Config Sync 版本，并在集群中手动升级 Config Sync。
  • 继续使用受支持的版本：Google 会在您的集群中维护最新的受支持版本，以确保您没有使用不受支持的 Config Sync 版本。
  • 提高可靠性：Google 管理 Config Sync 组件，并在发生任何变更时协调组件。

Config Sync 版本和 GKE 发布渠道

Config Sync 会根据 Google Kubernetes Engine 集群发布渠道选择要升级的版本。不使用 GKE 发布渠道的集群被视为使用稳定 GKE 发布渠道的集群。

您可以使用自动升级功能来确保在您的集群上自动升级 Config Sync。当发布渠道上提供了新版本的 Config Sync 时，Config Sync 会升级与集群发布渠道匹配的 Config Sync 版本。快速渠道版会在最新版本的 Config Sync 推出后立即提供。常规渠道很快将提供最新版本的 Config Sync。稳定渠道仅在通过快速渠道和常规渠道验证后才提供最新版本的 Config Sync。

如需详细了解发布渠道，请参阅关于发布渠道。

下表显示了每个发布渠道中可用的当前 Config Sync 版本：

发布渠道

Config Sync 版本

快速

1.17

普通

1.16

稳定版（或无渠道）

1.15

启用自动升级

启用自动升级功能，以确保在舰队的集群上自动升级 Config Sync。

您只能在启用了 GKE Enterprise 的 GKE on Google Cloud 集群上启用自动升级功能。

如需安装 Config Sync 并启用自动升级功能，请按照安装 Config Sync 中的说明操作。

如需在已安装 Config Sync 的集群上启用自动升级功能，请完成以下步骤：

  1. 确认您的 GKE 集群已在发布渠道中注册。如果 GKE 集群未在发布渠道中注册，则 Config Sync 会自动升级，就像集群使用稳定 GKE 发布渠道一样。
  2. 如果您之前未将 Config Sync 配置为向 Cloud Monitoring 发送指标，请授予指标写入权限。这是自动升级的必要条件。

  3. 如果 Config Sync 的版本低于 1.15.0，请手动将其升级到版本 1.15.0 或更高：

    控制台

    1. 在 Google Cloud 控制台中，前往功能部分下的配置页面。

      前往“配置”

    2. 在设置标签页下，点击您要升级其版本的集群旁边的修改集群配置。
    3. 从版本下拉列表中，选择要升级到的版本。
    4. 点击升级 Config Sync。

    gcloud

    1. （可选）如果要在升级之前检查集群上安装的 Config Sync 版本，请运行以下命令：

      gcloud beta container fleet config-management

    2. 如需升级 Config Sync，请运行以下命令：

      gcloud beta container fleet config-management upgrade \
    --version=VERSION \
    --membership=MEMBERSHIP_NAME

      替换以下内容：

      • VERSION：要升级到的版本
      • MEMBERSHIP_NAME：您在注册集群时选择的舰队成员资格名称。您可以通过运行 gcloud container fleet memberships list 找到成员资格名称。

  4. 启用 Config Sync 自动升级：

    控制台

    对个别集群启用自动升级

    如需在单个集群上启用自动升级功能，请完成以下步骤：

    1. 在 Google Cloud 控制台中，前往功能部分下的配置页面。

      前往“配置”

    2. 点击 Config Sync 设置。
    3. 为要更新的集群选择修改集群配置。
    4. 在随即显示的设置窗格中，选择自动升级。
    5. 点击更改 Config Sync 设置。几分钟后，在设置标签页中，您应该会在所选集群的自动升级列看到是。

    启用自动升级作为舰队默认设置

    如需为集群舰队启用自动升级功能，请完成以下步骤：

    1. 在 Google Cloud 控制台中，前往 Feature Manager 页面。

      前往 Feature Manager

    2. 在 Config Sync 窗格中，点击配置。

    3. 如需更改默认设置，请点击自定义舰队设置。

    4. 在显示的对话框中，选择自动升级。

    5. 点击保存更改。

    6. 可选：将现有集群同步到默认设置：

      1. 前往 Feature Manager 页面。

        前往 Feature Manager

      2. 在 Config Sync 窗格中，点击查看详细信息。

      3. 在舰队中的集群列表中，选择您要同步的集群。

      4. 点击同步到舰队设置，然后在出现的确认对话框中点击确认。此操作可能需要几分钟才能完成。

    gcloud

    如需为单个集群启用自动升级功能，请完成以下步骤：

    1. 将 Google Cloud CLI 更新到最新版本：

      gcloud components update

    2. 更新现有的 Config Sync apply spec 文件以包含 upgrades: auto 字段，例如：

      applySpecVersion: 1
spec:
  upgrades: auto
  configSync:
    enabled: true
# other fields intentionally omitted

    3. 应用更新后的 apply-spec.yaml 文件：

      gcloud beta container fleet config-management apply \
    --membership=MEMBERSHIP_NAME \
    --config=CONFIG_YAML_PATH \
    --project=PROJECT_ID

      替换以下内容：

      • MEMBERSHIP_NAME：您在注册集群时选择的舰队成员资格名称。您可以通过 gcloud container fleet memberships list 找到该名称。
      • CONFIG_YAML_PATH：apply-spec.yaml 文件的路径。
      • PROJECT_ID：您的项目 ID。

    4. 确认已启用自动升级：

      gcloud beta container fleet config-management status \
  --project=PROJECT_ID

      将 PROJECT_ID 替换为您的项目 ID。

      对于已启用自动升级的集群，Upgrades 列显示“自动”。如果启用自动升级时出错，Status 列将显示 ERROR 以及详细的错误消息。

更改发布渠道

如需了解如何更改集群的发布渠道，请参阅 GKE 文档中的更改集群的发布渠道。如果您启用了 Config Sync 自动升级，则在更改发布渠道时应考虑以下事项：

  • 如果您将发布渠道更改为不太稳定的版本（例如，从稳定渠道更改为 Rapid），则 Config Sync 将自动从原始发布渠道支持的最新版本升级到新发布渠道支持的最新版本。
  • 如果您将发布渠道更改为更稳定的渠道（例如，从快速渠道更改为稳定渠道），Config Sync 不会降级版本。原始发布渠道支持的最新版本将升级为新的发布渠道。随着新版本的发布渠道，Config Sync 将正常自动升级。
  • 如果您退订发布渠道，则不会影响 Config Sync 自动升级。Config Sync 版本将升级，就像您的集群已在稳定发布渠道中注册一样。

手动升级 Config Sync

在升级 Config Sync 之前，请查看版本说明，详细了解各个版本之间发生的变化。如果您需要从不受支持的 Config Sync 版本进行升级，则必须执行分步升级，每次升级不超过三个次要版本。例如，如果当前的 Config Sync 版本是 1.10.0，请继续升级到版本 1.13.0，然后升级到版本 1.16.0。

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

控制台

  1. 在 Google Cloud 控制台中，前往功能部分下的配置页面。

    前往“配置”

  2. 在设置标签页下，在您要升级其 Config Sync 版本的集群旁边，选择修改集群配置。
  3. 从版本下拉列表中，选择要升级到的版本。
  4. 点击升级 Config Sync。

gcloud

  1. （可选）如果要在升级之前检查集群上安装的 Config Sync 版本，请运行以下命令：

    gcloud beta container fleet config-management version

  2. 运行以下命令：

    gcloud beta container fleet config-management upgrade \
    --version=VERSION \
    --membership=MEMBERSHIP_NAME

    替换以下内容：

    • VERSION：要升级到的版本。
    • MEMBERSHIP_NAME：您在注册集群时选择的舰队成员资格名称。您可以通过运行 gcloud container fleet memberships list 找到成员资格名称。