更新集群

本页面介绍您可以在管理员集群和用户集群中更新的设置。

通常情况下,您可以在配置文件中更改单个设置,然后使用适当的参数运行 gkectl update 命令。如需更新多项设置,请一次更改一项设置,然后重复运行该命令。

gkectl update 命令采用以下某种形式,以及适合要您要更新的功能的参数:

集群中可以和不能更新的设置

管理员集群和用户集群中的许多功能都无法在创建集群后更新。

要查看可以更新的管理员集群设置,请运行以下命令:

gkectl update admin --help

要查看可以更新的用户集群设置,请运行以下命令:

gkectl update cluster --help

管理员集群更新

您可以更新管理员集群的各种功能。

更新管理员集群的操作系统映像类型

您可以更新管理员集群的操作系统映像类型以使用 Ubuntu 或 COS。

分配额外的静态 IP 地址

如果您的配置使用静态 IP 地址,则必须在升级管理员工作站或管理员集群时检查使用的 IP 地址数量,并根据需要添加额外的地址。

为用户集群的控制层面节点启用或停用节点大小调整

您可以为用户集群enable停用控制平面节点的自动大小调整。这些节点位于管理员集群中。

启用或停用集群备份

对于管理员集群,您可以启用集群备份停用集群备份

启用或停用 vSphere 资源指标

如果更改管理员集群配置文件中的 stackdriver.disableVsphereResourceMetrics 值,请运行以下命令来更新配置:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

更新管理员集群的 vCenter 证书参考

如果您的 vCenter 证书已更改,请更新 vCenter 证书参考。您必须同时更新管理员集群和所有用户集群。

为管理员集群启用插件节点的自动大小调整功能(预览)

您可以为管理员集群enable停用插件节点的自动大小调整功能。

为管理员集群启用或停用自动节点修复(预览)

要为管理员集群启用或停用自动节点修复功能,您可以更改管理员集群配置文件中的相应设置,并运行 gkectl update admin 命令。

启用或停用反亲和性群组(预览)

如果更改管理员集群配置文件中 antiAffinityGroups.enabled 的值,请运行以下命令来更新配置:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

替换以下内容:

  • ADMIN_CLUSTER_KUBECONFIG:kubeconfig 文件的路径。如果文件位于当前目录中且名称为 kubeconfig,则可以省略此标志。

  • ADMIN_CLUSTER_CONFIG_FILE:管理员集群配置文件的路径。如果文件位于当前目录中且名称为 admin-cluster.yaml,则可以省略此标志。

为管理员集群启用或停用 Cloud Audit Logs 的日志记录

如需启用将日志记录到 Cloud Audit Logs 的功能,请在管理员集群配置文件中填写 cloudAuditLogging 部分,然后更新集群。

如需停用将日志记录到 Cloud Audit Logs 的功能,请从管理员集群配置文件中移除 cloudAuditLogging 部分,然后更新集群。

如果您要在 Google Cloud 控制台中管理用户集群的生命周期,则此部分在管理员集群中是必需的。

要更新集群,请运行以下命令:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

替换以下内容:

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

  • ADMIN_CLUSTER_CONFIG_FILE:管理员集群配置文件的路径。

为管理员集群启用或停用日志记录和监控功能

如需启用 Cloud LoggingCloud Monitoring,请填写管理员集群配置文件中的 stackdriver 部分,然后更新集群:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

替换以下内容:

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

  • ADMIN_CLUSTER_CONFIG_FILE:管理员集群配置文件的路径。

如需停用 Cloud Logging 和 Cloud Monitoring,请从管理员集群配置文件中移除 stackdriver 部分,然后更新您的集群。

默认情况下,stackdriver 部分是必需的;因此,如需移除该部分,您必须添加 --skip-validation-stackdriver 标志:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config ADMIN_CLUSTER_CONFIG_FILE \
    --skip-validation-stackdriver

如果您要在 Google Cloud 控制台中管理用户集群的生命周期,则 stackdriver 部分在管理员集群中是必需的。

注册管理员集群

首次创建管理员集群时,可以通过在创建之前填写管理员集群配置文件中的 gkeConnect 部分来注册集群。如果您在创建集群时未注册集群,可以通过修改配置文件以添加 gkeConnect 部分,并在随后运行 gkectl update admin 命令来注册集群

如果您要在 Google Cloud 控制台中管理用户集群的生命周期,则此部分在管理员集群中是必需的。

轮替管理员集群的连接和注册服务账号密钥

如需轮替连接和注册服务账号密钥,请使用 gkectl update credentials 命令,如轮替服务账号密钥中所述。

用户集群更新

要更新用户集群,您可以修改用户配置文件中的设置,然后使用适当的参数运行 gkectl update cluster。以下是您可以对用户集群进行的更改。

分配额外的静态 IP 地址

如果您的配置使用静态 IP 地址,则必须在进行以下任何更改时检查使用的 IP 地址数量,并根据需要添加额外的地址。

通过更新 nodePool 设置来调整用户集群的大小

您可以调整用户集群的大小,方法是更新 nodePools 部分中的 replicas 值,然后运行 gkectl update cluster 命令。

启用或停用 vSphere 资源指标

您可以在用户集群配置文件中启用或停用 vSphere 资源指标,然后运行 gkectl update cluster 命令。

更新用户集群的 vCenter 证书参考

如果您的 vCenter 证书已更改,请更新 vCenter 证书参考。您必须同时更新管理员集群和所有用户集群。

注册用户集群

在创建集群时,您可以通过在创建用户集群配置文件中填写 gkeConnect 部分来注册集群,然后再创建集群。如果您在创建集群时未注册集群,可以通过修改配置文件以添加 gkeConnect 部分,并在随后运行 gkectl update cluster 命令来注册现有用户集群

为用户集群启用或停用日志记录和监控(预览版)

如需启用日志记录和监控功能,请填写用户集群配置文件中的 stackdriver 部分,然后更新集群:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

替换以下内容:

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

  • USER_CLUSTER_CONFIG_FILE:用户集群配置文件的路径。

如需停用日志记录和监控,请从用户集群配置文件中移除 stackdriver 部分,然后更新集群。

默认情况下,stackdriver 部分是必需的;因此,如需移除该部分,您必须添加 --skip-validation-stackdriver 标志:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config USER_CLUSTER_CONFIG_FILE
    --skip-validation-stackdriver

为用户集群启用或停用自动节点修复

通过更改用户集群配置文件中的相应设置并运行 gkectl update cluster 命令,您可以为用户启用或停用自动节点修复功能。

自动调整用户集群中的节点大小

要为用户集群中的节点启用自动大小调整功能,请修改用户集群配置文件并运行 gkectl update 命令。

在用户集群上启用或停用 Cloud Audit Logging

您可以启用 Cloud Audit Logging停用 Cloud Audit Logging

停用 vSphere CSI 驱动程序

vSphere CSI 驱动程序默认启用。您可以停用 vSphere CSI 驱动程序

轮替用户集群的连接和注册服务账号密钥

如需轮替连接和注册服务账号密钥,请使用 gkectl update credentials 命令,如轮替服务账号密钥中所述。

更新 Windows Server 配置以使用 containerd 和 Windows Dataplane V2

如果您的配置包含 Windows Server 操作系统节点的节点池,请注意,Docker 和 Flannel 在未来版本中将被弃用。我们建议您立即更新用户集群,以改用 containerd 和 Windows Dataplane V2。

要进行此更新,请执行以下操作:

  1. 用户集群配置文件中,将 enableWindowsDataplaneV2 设置为 true

  2. 运行 gkectl update cluster 命令。

更新 MetalLB 配置

您可以更新用户集群配置文件中的 MetalLB 地址池。您还可以通过更新 nodePools 部分中的 enableLoadBalancer 值来启用或停用任何节点池中的 MetalLB。在配置文件中进行适当的更改,然后调用 gkectl update cluster

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONIFG --config USER_CLUSTER_CONFIG

替换以下内容:

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

  • USER_CLUSTER_CONFIG_FILE:用户集群配置文件的路径。

更新节点池主机组

您可以通过更改用户集群节点池配置中的 vsphere.hostgroups 字段来更新与节点池关联的主机组,其中包括以下操作:

  • 创建具有指定主机组的新节点池。
  • 向没有主机组的现有节点池提供主机组。
  • 将现有节点池从一个主机组更新为另一个主机组。
  • 从节点池中移除现有主机组。

更改 vsphere.hostgroups 字段后,运行 gkectl update cluster 命令以更新节点池。