更新集群

本文档介绍如何执行不包含版本更改的集群更新。

集群更新是指对集群配置的更改。

集群升级是集群更新的特殊情况，其中包括对控制平面版本或节点池版本的更改。如需了解如何升级，请参阅升级 GKE on VMware。

可以更新的内容

集群创建后，您可以更新部分集群功能和设置，但无法更新其他功能和设置。如需了解哪些功能可以更新，请查看管理员集群配置文件和用户集群配置文件的参考页面。可更新的字段标记为“可变”，而无法更新的字段标记为“不可变”。

您还可以通过运行 gkectl 命令来查看哪些功能和设置可以更新。

如需查看可以在管理员集群中更新的内容，请执行以下操作：

gkectl update admin --help

输出示例：

Update the admin cluster. Only the following updates are supported and they can
only be updated one at a time:
- Enabling/Disabling Vsphere Resource Metrics
- Adding static IPs
- Updating vCenter CA certificate
- Registering Admin Cluster
- Enabling/Disabling Cloud Audit Logging
- Enabling/Disabling Stackdriver
- Enabling/Disabling Auto Repair
- Enabling/Disabling Auto Resize for Addon Nodes
- Enabling/Disabling GKE OnPrem API
- Updating OS Image Type
- Enabling/Disabling AntiAffinityGroups
- Update Secrets Encryption Configuration
- [Preview] Enabling/Disabling Cluster Backup
- [Preview] Update Cluster Backup configs

如需查看可以在用户集群中更新的内容，请执行以下操作：

gkectl update cluster --help

输出示例：

Update a GKE On-Prem cluster. Only the following updates are supported and they
can only be updated one at a time:
- Adding static IPs
- Updating node pool
- Updating user master cpu and memory
- Enabling/Disabling Vsphere Resource Metrics
- Enabling/Disabling vSphere CSI deployment
- Enabling/Disabling Auto Repair
- Enabling/Disabling Cloud Audit Logging
- Enabling/Disabling Stackdriver
- Enabling/Disabling GKE OnPrem API
- Registering User Cluster
- Updating vCenter CA certificate
- Updating MetalLB Address Pools
- Enabling/Disabling Auto Resizing on user master
- Updating NodePoolUpdatePolicy
- Enabling/Disabling AntiAffinityGroups
- [Preview] Enabling/Disabling Node Network Policy
- Updating Secrets Encryption
- Enabling/Disabling DataplaneV2 forwardMode

一次更新一项

一次只能更新一项功能或设置。例如，假设您想要更新主 CPU 和内存，还想停用自动修复。

然后，您需要执行两次单独的更新：一次用于主 CPU 和内存更新，另一次是自动修复。在进行第二次更新之前，验证第一次更新是否成功。

更新过程

您可以使用 gkectl、Google Cloud 控制台或 Google Cloud CLI 对用户集群进行更新。如果您使用 Terraform 创建了用户集群，则可以使用 Terraform 来更新集群。几乎在所有情况下，您都必须使用 gkectl 来更新管理员集群。

以下示例展示了如何更新集群。

gkectl

gkectl update 命令采用以下其中一种形式：

管理员集群示例 (gkectl update admin)

假设您要将管理员集群中 gkeOnPremAPI.enabled 的值从 false 更改为 true。首先，修改管理员集群配置文件，并将值设置为 true：

gkeOnPremAPI:
  enabled: true

然后更新管理员集群：

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

替换以下内容：

  • ADMIN_CLUSTER_KUBECONFIG：管理员集群 kubeconfig 文件的路径

  • ADMIN_CLUSTER_CONFIG：管理员集群配置文件的路径

用户集群示例 (gkectl update cluster)

假设您要将用户集群中 stackdriver.vSphereDisableResourceMetrics 的值从 false 更改为 true。首先，修改用户集群配置文件，并将值设置为 true：

stackdriver:
  disableVsphereResourceMetrics: true

然后更新用户集群：

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG

替换以下内容：

  • ADMIN_CLUSTER_KUBECONFIG：管理员集群 kubeconfig 文件的路径

  • USER_CLUSTER_CONFIG：用户集群配置文件的路径

用户集群示例 (gkectl update credentials)

假设您要更改用户集群用于调用 vCenter Server 的凭据。

用户集群配置文件包含一个指向凭据配置文件的 vCenter.credentials.fileRef.path 字段。在凭据配置文件中，更新 username 和 password 的值。例如：

items:
- name: "vcenter-creds"
  username: "new-vcenter-account"
  password: "U$icUKEW#INE"

然后更新凭据：

gkectl update credentials vsphere \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

替换以下内容：

  • USER_CLUSTER_CONFIG：用户集群配置文件的路径

  • ADMIN_CLUSTER_KUBECONFIG：管理员集群 kubeconfig 文件的路径

控制台

  1. 在控制台中，前往 Google Kubernetes Engine 集群概览页面。

    转到 GKE 集群

  2. 选择 Google Cloud 项目，然后选择要更新的集群。

  3. 在详细信息面板中，点击更多详细信息。

  4. 可在 Google Cloud 控制台中更新的字段带有铅笔图标。点击其中一个铅笔图标。在打开的框中，根据需要更改字段值，然后点击完成。

  5. 在页面顶部的进度条中，点击显示详细信息。等待更新完成。

gcloud CLI

运行适用的更新命令。请仅指定您要修改的配置的标志：

更新用户集群上的管理员用户

每个集群的 Kubernetes API 服务器都需要能够对其收到的请求进行授权。如需配置授权，您需要在每个集群上配置 Kubernetes 基于角色的访问权限控制 (RBAC) 政策。管理员用户是指在用户集群中被授予 cluster-admin 角色的用户。此角色可向用户授予对集群的完整管理员权限。

假设 Alice 和 Bob 是 us-west1 区域中名为 cluster-1 的用户集群，其中仅有管理员用户。并且假设 Alice 想要将 Trent 添加为额外的管理员用户。Alice 可以运行以下命令：

gcloud container vmware clusters update cluster-1 \
    --project example-project-id-12345 \
    --location us-west1 \
    --admin-users alice@example.com \
    --admin-users bob@example.com \
    --admin-users trent@example.com

上述命令会将 Alice 和 Bob 保留在管理员用户列表中，并将 Trent 添加到管理员用户列表中。请注意，必须在该命令中列出 Alice 和 Bob，因为该命令使用该命令中指定的列表覆盖当前的管理员用户列表。另请注意，每个 --admin-users 标志仅指定一位用户。您不能在一个标志中指定多个用户。

Terraform

  1. 更改用于创建集群或节点池的 Terraform 配置文件中适用字段的值。如需了解详细的字段说明，请参阅 Terraform 参考文档：

  2. 运行 terraform apply 以更新配置。

更新用户集群上的管理员用户

每个集群的 Kubernetes API 服务器都需要能够对其收到的请求进行授权。如需配置授权，您需要在每个集群上配置 Kubernetes 基于角色的访问权限控制 (RBAC) 政策。管理员用户是指在用户集群中被授予 cluster-admin 角色的用户。此角色可向用户授予对集群的完整管理员权限。

假设 Alice 和 Bob 是某个特定用户集群中仅有的管理员用户。并且假设 Alice 想要将 Trent 添加为额外的管理员用户。Alice 可以按如下方式调整 Terraform 配置，然后运行 terraform apply：

authorization {
  admin_users {
    username = "alice@example.com"
    username = "bob@example.com"
    username = "trent@example.com"
  }
}

上述调整可将 Alice 和 Bob 保留在管理员用户列表中，并将 Trent 添加到管理员用户列表中。请注意，Alice 和 Bob 必须列在新配置中，因为 terraform apply 命令会使用配置中指定的列表覆盖当前的管理员用户列表。

更多信息

本部分列出的文档提供了有关更新集群的更多详细信息。

更新集群/管理员

以下文档详细介绍了如何使用 gkectl update admin 和 gkectl update cluster 更新功能和设置：

更新凭据

以下文档详细介绍了如何使用 gkectl update credentials 更新密钥和证书：

后续步骤

升级集群