升级 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.19

稳定（或无渠道）

1.18.3

启用自动升级

启用自动升级可确保 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. 在 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. 点击 Change Config Sync settings（更改 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 列会显示“auto”。如果启用自动升级时出错，Status 列会显示 ERROR 以及详细错误消息。

更改发布渠道

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

  • 如果您将发布渠道更改为不太稳定的渠道（例如从稳定渠道更改为快速渠道），则 Config Sync 将自动从原始发布渠道支持的最新版本升级到新发布渠道支持的最新版本。
  • 如果您将发布渠道更改为更稳定的渠道（例如从快速渠道更改为稳定渠道），Config Sync 不会降级版本。随着时间的推移，原始发布渠道支持的最新版本将提升到新发布渠道。当新发布渠道提供较新版本时，Config Sync 将正常自动升级。
  • 如果您退订发布渠道，这不会影响 Config Sync 自动升级。Config Sync 版本的升级行为会如同您的集群注册到稳定版发布渠道一样。

手动升级 Config Sync

在升级 Config Sync 之前，请查看版本说明以详细了解版本之间的变化。如果您需要从不受支持的 Config Sync 版本升级，则必须执行分步升级，每次的增量不超过三个次要版本。例如，如果当前 Config Sync 版本为 1.11.0，请先升级到 1.14.0 版，然后再升级到 1.17.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 找到成员资格名称。