默认情况下，Google Kubernetes Engine (GKE) 集群和 GKE Standard 节点池会启用自动升级。
本页面介绍如何为 GKE 集群的控制层面或节点手动请求升级或降级。您可以按如下方式手动升级版本：
为了升级集群，GKE 会更新控制层面和节点正在运行的版本。集群会升级到较新的次要版本（例如 1.24 到 1.25）或较新的补丁版本（例如 1.24.2-gke.100 到 1.24.5-gke.200）。如需了解详情，请参阅 GKE 版本控制和支持。
您可以详细了解自动和手动升级集群的工作原理。您还可以通过配置维护期和排除项来控制可以和不能自动升级的时间。
新版本的 GKE 会定期发布，您可以通过集群通知接收有关特定集群可以升级到的新版本的通知。
如需了解可用的版本，请参阅版本控制。如需详细了解集群，请参阅集群架构。如需了解如何升级集群，请参阅升级集群的最佳做法。
准备工作
在开始之前，请确保您已执行以下任务：
- 启用 Google Kubernetes Engine API。 启用 Google Kubernetes Engine API
- 如果您要使用 Google Cloud CLI 执行此任务，请安装并初始化 gcloud CLI。 如果您之前安装了 gcloud CLI，请运行
gcloud components update以获取最新版本。
将数据保存到 Persistent Disk
升级节点池之前，请务必将希望保留的所有数据存储在使用永久性磁盘的永久性卷的 Pod 中。 在升级期间，永久性磁盘会被卸载，而不是被清空，并且其数据会在 Pod 之间“移交”。
永久性磁盘存在以下限制：
- 运行 Pod 的节点必须是 Compute Engine 虚拟机
- 这些虚拟机和永久性磁盘必须位于同一 Compute Engine 项目和地区中
如需了解如何将 Persistent Disk 添加到现有节点实例，请参阅 Compute Engine 文档中的添加地区级 Persistent Disk 或调整其大小。
关于升级
无论您的集群是否已注册发布版本，集群控制平面都会始终定期升级。
如需主动接收升级通知，请参阅接收集群通知。
限制
Alpha 版集群无法升级。
支持的版本
版本说明会通知何时推出新版本以及何时不再提供旧版本。您可以随时使用以下命令列出所有支持的集群和节点版本：
gcloud container get-server-config
如果您的集群已在发布渠道中注册，您可以升级到与发布控制平面具有相同次要版本的其他发布渠道中的补丁版本。例如，您可以将集群从常规渠道中的版本 1.21.12-gke.1700 升级到快速渠道中的 1.21.13-gke.900。如需了解详情，请参阅从较新的渠道运行补丁版本。所有 Autopilot 集群都在发布渠道中注册。
降级限制
在某些情况下，您可以将集群版本降级为较低版本。
如需缓解集群控制平面升级失败的问题，您可以将控制平面降级为之前的补丁版本（如果版本为同一次要版本中的早期补丁版本）。例如，如果集群的控制平面正在运行 GKE 1.25.3-gke.400，则您可以将该控制平面降级为 1.25.2-gke.100（如果该版本仍然可用）。
您无法将 Kubernetes 集群控制平面降级为早期次要版本。例如，如果您的控制平面运行 GKE 1.25 版，则无法降级到 1.24 版。如果您尝试执行此操作，系统会显示以下错误消息：
ERROR: (gcloud.container.clusters.upgrade) ResponseError: code=400,
message=Master cannot be upgraded to "1.24.3-gke.100": specified version is not
newer than the current version.
您无法降级集群的控制平面的次要版本，因此我们建议您在新的次要版本可用但在该版本成为默认版本之前，在测试环境中测试并验证集群的次要版本升级。如果您的集群可能会受到下一个次要版本的重大更改（例如即将移除已弃用的 API 或功能）的影响，则强烈建议您执行这样的操作。
如需缓解节点池升级失败的问题，您可以将节点池降级为早期补丁版本或次要版本。切勿将节点降级为比集群控制平面版本高两个次要版本的版本。
升级集群
Google 会自动升级集群和节点。为了更好地控制集群及其节点接收的自动升级，您可以在发布渠道中注册集群。所有 Autopilot 集群都在发布渠道中自动注册。
如需详细了解如何管理集群的 GKE 版本，请参阅升级。
您可以在新版本推出后的任意时间启动手动升级。
手动升级控制平面
启动集群升级时，您有几分钟无法修改集群的配置，直到可再次访问控制层面为止。 如果您需要在控制层面升级期间防止停机，请考虑使用 Autopilot 集群或区域级 Standard 集群。此操作不会影响运行工作负载的工作器节点的可用性，因为它们在控制层面升级期间仍然可用。
您可以使用 Google Cloud 控制台或 Google Cloud CLI 手动升级 Autopilot 或标准控制平面。
gcloud
如需查看集群的控制平面的可用版本，请运行以下命令：
gcloud container get-server-config
如需升级到默认的集群版本，请运行以下命令：
gcloud container clusters upgrade CLUSTER_NAME --master
如需升级到特定的非默认版本，请按如下方式指定 --cluster-version 标志：
gcloud container clusters upgrade CLUSTER_NAME --master \
--cluster-version VERSION
将 VERSION 替换为您要将集群升级到的版本。您可以使用具体的版本（如 1.18.17-gke.100），也可以使用版本别名（如 latest）。如需了解详情，请参阅指定集群版本。
控制台
如需手动更新集群控制平面，请执行以下步骤：
转到 Google Cloud 控制台中的 Google Kubernetes Engine 页面。
点击所需的集群名称。
在集群基本信息下，点击版本旁边的 edit 可用升级。
选择所需的版本，然后点击保存更改。
升级标准控制平面后，您可以升级其节点。默认情况下，使用 Google Cloud 控制台创建的标准节点已启用自动升级，因此该操作会自动执行。Autopilot 总是自动升级节点。
降级集群
- 请在降级前设置维护排除项，以防止 GKE 在降级后自动升级控制平面。
将集群控制平面降级为早期补丁版本：
gcloud container clusters upgrade CLUSTER_NAME \ --master --cluster-version VERSION
停用集群自动升级
基础架构安全性对于 GKE 而言具有较高的优先级，因此，控制平面会定期升级，并且无法停用。但是，您可以通过应用维护期和排除项来临时暂停控制平面和节点的升级。
您可以停用节点自动升级，但我们不建议您这样做。
升级节点池
默认情况下，集群的节点已启用自动升级，我们建议您不要将其停用。节点自动升级可确保集群的控制平面和节点版本保持同步，并且符合 Kubernetes 版本倾斜支持政策，该政策可确保控制平面与最多比控制平面低两个次要版本的节点兼容。例如，Kubernetes 1.29 控制平面与 Kubernetes 1.27 节点兼容。
借助 GKE 节点池升级，您可以选择两种可配置的升级策略，即超额配置升级和蓝绿升级。
当某个节点正在升级时，GKE 会停止将新的 Pod 调度到该节点上，并尝试将其正在运行的 Pod 调度到其他节点上。这与重新创建节点的其他事件（例如启用或停用节点池中的功能）类似。
只有在重新创建所有节点且集群处于所需状态后，升级才算完成。当新升级的节点向控制平面注册时，GKE 会将该节点标记为可调度。
新节点实例会运行所需的 Kubernetes 版本以及：
手动升级节点池
您可以将节点池版本手动升级为与控制平面版本匹配的版本，或仍然可用且与控制平面兼容的先前版本。您可以手动并行升级多个节点池，而 GKE 一次只能自动升级一个节点池。
手动升级节点池时，GKE 会移除使用 kubectl 添加到各个节点的所有标签。为避免这种情况，请改为将标签应用于节点池。
您可以使用 Google Cloud 控制台或 Google Cloud CLI 将节点池手动升级到与控制平面兼容的版本。
gcloud
本部分的命令中使用以下变量：
CLUSTER_NAME：要升级的节点池的集群的名称。NODE_POOL_NAME：要升级的节点池的名称。VERSION：节点升级到的 Kubernetes 版本。例如--cluster-version=1.7.2或cluster-version=latest。
升级节点池：
gcloud container clusters upgrade CLUSTER_NAME \
--node-pool=NODE_POOL_NAME
如需在节点上指定其他版本的 GKE，请使用可选 --cluster-version 标志：
gcloud container clusters upgrade CLUSTER_NAME \
--node-pool=NODE_POOL_NAME \
--cluster-version VERSION
如需详细了解如何指定版本，请参阅版本控制。
如需了解详情，请参阅 gcloud container clusters upgrade 文档。
控制台
如需使用 Google Cloud 控制台升级节点池，请执行以下步骤：
转到 Google Cloud 控制台中的 Google Kubernetes Engine 页面。
在要修改的集群旁边，点击 more_vert 操作，然后点击 edit 修改。
在集群详情页面上，点击节点标签页。
在节点池部分，点击要升级的节点池的名称。
点击 edit 修改。
点击节点版本下的更改。
从节点版本下拉列表中选择所需的版本，然后点击更改。
降级节点池
例如，您可以降级节点池，以缓解节点池升级失败的问题。在降级节点池之前，请查看限制。
更改超额配置升级参数
如需详细了解如何更改超额配置升级参数，请参阅配置超额配置升级。
检查节点池升级状态
您可以使用 gcloud container operations 检查升级的状态。
查看集群中每个正在运行和已完成的操作的列表：
gcloud container operations list
系统会为每个操作分配操作 ID 和操作类型，以及开始和结束时间、目标集群和状态。该列表类似于以下示例：
NAME TYPE ZONE TARGET STATUS_MESSAGE STATUS START_TIME END_TIME
operation-1505407677851-8039e369 CREATE_CLUSTER us-west1-a my-cluster DONE 20xx-xx-xxT16:47:57.851933021Z 20xx-xx-xxT16:50:52.898305883Z
operation-1505500805136-e7c64af4 UPGRADE_CLUSTER us-west1-a my-cluster DONE 20xx-xx-xxT18:40:05.136739989Z 20xx-xx-xxT18:41:09.321483832Z
operation-1505500913918-5802c989 DELETE_CLUSTER us-west1-a my-cluster DONE 20xx-xx-xxT18:41:53.918825764Z 20xx-xx-xxT18:43:48.639506814Z
如需详细了解特定操作，请按如下命令所示指定操作 ID：
gcloud container operations describe OPERATION_ID
例如：
gcloud container operations describe operation-1507325726639-981f0ed6
endTime: '20xx-xx-xxT21:40:05.324124385Z'
name: operation-1507325726639-981f0ed6
operationType: UPGRADE_CLUSTER
selfLink: https://container.googleapis.com/v1/projects/.../kubernetes-engine/docs/zones/us-central1-a/operations/operation-1507325726639-981f0ed6
startTime: '20xx-xx-xxT21:35:26.639453776Z'
status: DONE
targetLink: https://container.googleapis.com/v1/projects/.../kubernetes-engine/docs/zones/us-central1-a/clusters/...
zone: us-central1-a
检查节点池升级设置
您可以使用 gcloud container node-pools
describe 命令查看有关用于节点池的节点升级策略的详细信息。对于蓝绿升级，该命令还会返回升级的当前阶段。
运行以下命令：
gcloud container node-pools describe NODE_POOL_NAME \
--cluster=CLUSTER_NAME
替换以下内容：
NODE_POOL_NAME：要描述的节点池的名称。CLUSTER_NAME：要描述的节点池集群的名称。
此命令将输出当前升级设置。以下示例演示了使用蓝绿升级策略时的输出。
upgradeSettings:
blueGreenSettings:
nodePoolSoakDuration: 1800s
standardRolloutPolicy:
batchNodeCount: 1
batchSoakDuration: 10s
strategy: BLUE_GREEN
如果您使用的是蓝绿升级策略，则输出还会包含蓝绿升级设置及其当前中间阶段的详细信息。以下示例演示了这种情况的可能情形：
updateInfo:
blueGreenInfo:
blueInstanceGroupUrls:
- https://www.googleapis.com/compute/v1/projects/{PROJECT_ID}/zones/{LOCATION}/instanceGroupManagers/{BLUE_INSTANCE_GROUP_NAME}
bluePoolDeletionStartTime: {BLUE_POOL_DELETION_TIME}
greenInstanceGroupUrls:
- https://www.googleapis.com/compute/v1/projects/{PROJECT_ID}/zones/{LOCATION}/instanceGroupManagers/{GREEN_INSTANCE_GROUP_NAME}
greenPoolVersion: {GREEN_POOL_VERSION}
phase: DRAINING_BLUE_POOL
取消节点池升级
您可以随时取消升级。如需详细了解取消超额配置升级时发生的情况，请参阅取消超额配置升级。如需详细了解取消蓝绿升级时发生的情况，请参阅取消蓝绿升级。
获取升级的操作 ID：
gcloud container operations list取消升级：
gcloud container operations cancel OPERATION_ID
请参阅 gcloud container operations cancel 文档。
恢复升级节点池
您可以通过再次手动启动升级并指定原始升级中的目标版本来恢复升级。
例如，如果您暂停了正在进行的 1.23.1-gke.100 版本升级，则可以通过在节点池上再次启动同一升级来恢复版本 1.23.1-gke.100，从而恢复已取消的升级。
如需详细了解恢复升级时发生的情况，请参阅恢复超额配置升级和蓝绿升级。
要恢复升级，请使用以下命令：
gcloud container clusters upgrade CLUSTER_NAME \
--node-pool=NODE_POOL_NAME \
--cluster-version VERSION
替换以下内容：
NODE_POOL_NAME：要恢复节点池升级的节点池的名称。CLUSTER_NAME：要恢复升级的节点池的集群的名称。VERSION：已取消节点池升级的目标版本。
如需了解详情，请参阅 gcloud container clusters upgrade 文档。
回滚节点池升级
您可以回滚节点池，以将升级后的节点降级为节点池升级之前的原始状态。
如果正在进行的升级被取消、升级失败或升级由于维护窗口超时而未完成，请使用 rollback 命令。或者，如果要指定版本，请按照说明降级节点池。
如需详细了解回滚节点池升级时发生的情况，请参阅回滚超额配置升级或回滚蓝绿升级。
如需回滚升级，请运行以下命令：
gcloud container node-pools rollback NODE_POOL_NAME \
--cluster CLUSTER_NAME
替换以下内容：
NODE_POOL_NAME：要回滚节点池升级的节点池的名称。CLUSTER_NAME：要回滚升级的节点池的集群名称。
请参阅 gcloud container node-pools rollback 文档。
完成节点池升级
如果您使用的是蓝绿升级策略，则可以在过渡阶段完成节点池升级，并跳过其余过渡时间。
如需了解如何完成节点池升级，请参阅完成节点池升级。
如需在使用蓝绿升级策略时完成升级，请运行以下命令：
gcloud container node-pools complete-upgrade NODE_POOL_NAME \
--cluster CLUSTER_NAME
替换以下内容：
NODE_POOL_NAME：要完成升级的节点池的名称。CLUSTER_NAME：要完成升级的节点池的集群名称。
请参阅 gcloud container node-pools complete-upgrade 文档。
已知问题
如果您配置的 PodDisruptionBudget 对象无法允许任何额外的中断，则节点升级可能会在反复尝试后仍无法升级到控制平面版本。为防止此故障，我们建议您扩容 Deployment 或 HorizontalPodAutoscaler，以允许节点排空，同时仍遵循 PodDisruptionBudget 配置。
如需查看不允许出现任何中断的所有 PodDisruptionBudget 对象，请运行以下命令：
kubectl get poddisruptionbudget --all-namespaces -o jsonpath='{range .items[?(@.status.disruptionsAllowed==0)]}{.metadata.name}/{.metadata.namespace}{"\n"}{end}'
虽然自动升级可能会遇到问题，但自动升级过程会强制节点升级。但是，对于 istio-system 命名空间中违反 PodDisableionBudget 的每个节点，升级额外需要一个小时。
问题排查
节点 CPU 使用率高于预期
您可能会遇到一些节点的 CPU 使用率高于正在运行的 Pod 的预期使用率的问题。
如果您的集群或节点未运行受支持的版本，则可能会发生这种情况。查看版本说明，确保您使用的版本可用且受支持。您还可以运行以下命令以列出所有支持的集群和节点版本：
gcloud container get-server-config