手动升级集群或节点池

标准

---

默认情况下，Google Kubernetes Engine (GKE) 集群和节点池会启用自动升级。

本页面介绍如何为 GKE 集群或其节点手动请求升级或降级。您可以详细了解自动和手动升级集群的工作原理。您还可以通过配置维护期和排除项来控制可以和不能自动升级的时间。

有关术语的注意事项：集群的控制平面（主实例）和节点运行的版本不一定始终相同。在本主题中，集群升级和控制层面升级可互换使用，区别于节点升级。

新版本的 GKE 会定期发布。如要了解可用的版本，请参阅版本控制。如需详细了解集群，请参阅集群架构。如需了解如何升级集群，请参阅升级集群的最佳做法。

准备工作

在开始之前，请确保您已执行以下任务：

• 确保您已启用 Google Kubernetes Engine API。
启用 Google Kubernetes Engine API
• 确保您已安装 Cloud SDK。

使用以下任一方法设定默认的 gcloud 设置：

• 使用 gcloud init（如果您想要在系统引导下完成默认设置）。
• 使用 gcloud config（如果您想单独设置项目 ID、区域和地区）。

使用 gcloud init

如果您收到 One of [--zone, --region] must be supplied: Please specify location 错误，请完成本部分。

1. 运行 gcloud init 并按照说明操作：

   gcloud init

   如果您要在远程服务器上使用 SSH，请使用 --console-only 标志来防止命令启动浏览器：

   gcloud init --console-only

2. 按照说明授权 gcloud 使用您的 Google Cloud 帐号。
3. 创建新配置或选择现有配置。
4. 选择 Google Cloud 项目。
5. 为可用区级集群选择默认 Compute Engine 可用区，或为区域级集群或 Autopilot 集群选择区域。

注意：您可以在 gcloud 命令中使用 --project、--zone 和 --region 标志替换这些默认设置。

使用 gcloud config

• 设置默认项目 ID：

  gcloud config set project PROJECT_ID

• 如果您使用的是可用区级集群，请设置默认计算可用区：

  gcloud config set compute/zone COMPUTE_ZONE

• 如果您使用的是 Autopilot 集群或区域级集群，请设置默认计算区域：

  gcloud config set compute/region COMPUTE_REGION

• 将 gcloud 更新到最新版本：

  gcloud components update

注意：您可以在 gcloud 命令中使用 --project、--zone 和 --region 标志替换这些默认设置。

将数据保存到永久性磁盘

升级节点池之前，请务必将希望保留的所有数据存储在使用永久性磁盘的永久性卷的 Pod 中。 在升级期间，永久性磁盘会被卸载，而不是被清空，并且其数据会在 Pod 之间“移交”。

永久性磁盘存在以下限制：

• 运行 Pod 的节点必须是 Compute Engine 虚拟机
• 这些虚拟机和永久性磁盘必须位于同一 Compute Engine 项目和地区中

如需了解如何将 Persistent Disk 添加到现有节点实例，请参阅 Compute Engine 文档中的添加地区级 Persistent Disk 或调整其大小。

关于升级

集群的控制层面和节点将分别升级。

无论您的集群是否已注册发布版本，集群控制层面都会始终定期升级。

如需了解如何升级的主动通知，请参阅接收集群升级通知。

限制

Alpha 版集群无法升级。

支持的版本

版本说明会通知何时推出新版本以及何时不再提供旧版本。您可以随时使用以下命令列出所有支持的集群和节点版本：

gcloud container get-server-config

降级限制

不建议降级集群控制层面。您无法将集群控制层面从一个次要版本降级到另一个次要版本。例如，如果您的控制层面正在运行 GKE 1.17.17 版，则无法降级到 1.16.15 版。如果您尝试执行此操作，则会看到类似于以下内容的错误：

ERROR: (gcloud.container.clusters.upgrade) ResponseError: code=400,
message=Master cannot be upgraded to "1.16.15-gke.6000": specified version is not
newer than the current version.

不建议降级 Kubernetes 次要版本或补丁程序，您应只将其用作失败升级的缓解措施。

如需缓解集群控制层面升级失败的问题，您可以将集群降级为先前的补丁程序版本（如果该补丁程序版本与您的集群具有相同的次要版本）。例如，如果您的集群正在运行 GKE 1.17.17，则可以降级到 1.17.16（如果该版本仍然可用）。

如需缓解节点池升级失败的问题，您可以将节点池降级为早于集群控制层面版本的补丁程序版本。节点版本不能高于集群控制层面版本后的两个次要版本。

升级集群

Google 会自动升级集群和节点。为了更好地控制集群及其节点接收的自动升级，您可以在发布渠道中注册集群。

如需详细了解如何管理集群的 GKE 版本，请参阅升级。

您可以在新版本推出后的任意时间启动手动升级。

手动升级控制层面

注意：升级集群时，每次不能超过一个次要版本。例如，您可以将集群从 1.12.x 版升级到 1.13.x 版，但不能直接从 1.11.x 版升级到 1.13.x 版。如需了解详情，请参阅版本控制。

启动集群升级时，您有几分钟无法修改集群的配置，直到可再次访问控制平面为止。如果您需要在控制层面升级期间防止停机，请考虑使用地区级集群。

您可以使用 Cloud Console 或 gcloud 命令行工具手动升级集群。升级集群后，您可以升级其节点。默认情况下，使用 Google Cloud Console 创建的节点已启用自动升级，因此该操作会自动执行。

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）。如需了解详情，请参阅指定集群版本。

注意：如果您的集群已订阅发布版本，则 VERSION 必须为发布版本的有效版本。

控制台

如需手动更新集群控制层面，请执行以下步骤：

1. 转到 Cloud Console 中的 Google Kubernetes Engine 页面：

   转到 Google Kubernetes Engine

2. 点击所需的集群名称。

3. 在集群基本信息下，点击版本旁边的 可用升级。

4. 选择所需的版本，然后点击保存更改。

降级集群

注意：不建议对集群进行降级。在尝试降级集群前，请务必了解相关限制。

如需将集群降级为先前的补丁程序版本，请使用以下命令更改集群控制层面版本：

gcloud container clusters upgrade CLUSTER_NAME \
  --master --cluster-version VERSION

注意：如果您的集群已订阅发布版本，则 VERSION 必须为发布版本的有效版本。

停用集群自动升级

基础架构安全性对于 GKE 而言具有较高的优先级，因此，控制层面会定期升级，并且无法停用。但是，您可以通过应用维护期和排除项来临时暂停控制层面和节点的升级。

您可以停用节点自动升级，但我们不建议您这样做。

升级节点池

默认情况下，集群的节点已启用自动升级，我们建议您不要将其停用。

升级节点池后，您可以配置超额配置升级设置，以控制 GKE 同时升级的节点数以及升级对工作负载的干扰程度。默认情况下，GKE 一次升级一个节点。

当某个节点正在升级时，GKE 会停止将新的 Pod 调度到该节点上，并尝试将其正在运行的 Pod 调度到其他节点上。这与重新创建节点的其他事件（例如启用或停用节点池中的功能）类似。

注意：在自动或手动升级节点期间，PodDisruptionBudget (PDB) 最长为 1 小时。如果在节点上运行的 Pod 无法在 1 小时内被调度到新节点上，则不管怎样系统都会启动升级。
如需详细了解在节点终止期间一般会发生什么情况，请参阅有关 Pod 的主题。

只有在重新创建所有节点且集群处于所需状态后，升级才算完成。当新升级的节点向控制层面注册时，GKE 会将该节点标记为可调度。

新节点实例会运行所需的 Kubernetes 版本以及：

• 节点映像
• Docker 守护进程（如果适用）
• kubelet
• kube-proxy

手动升级节点池

您可以将节点池版本手动升级为与控制层面版本匹配的版本，或仍然可用且与控制层面兼容的先前版本。Kubernetes 版本和版本倾斜支持政策可保证控制层面与最多比控制层面低两个次要版本的节点兼容。例如，Kubernetes 1.13 控制层面与 Kubernetes 1.11 节点兼容。

手动升级节点池时，GKE 会移除使用 kubectl 添加到各个节点的所有标签。为避免这种情况，请改为将标签应用于节点池（预览版）。

注意：升级节点池可能会中断在该节点池中运行的工作负载。为避免出现此情况，您可以创建具有所需版本的新节点池并迁移工作负载。迁移后，您可以删除旧的节点池。

注意：如果升级某个 Ingress 处于错误状态的节点池，则实例组不会同步。如需解决此问题，请先使用 kubectl get ing 命令检查状态。如果未同步实例组，您可以重新应用用于创建 Ingress 的清单来解决该问题。

您可以使用 Google Cloud Console 或 gcloud 命令行工具手动将节点池升级到与控制平面兼容的版本。

gcloud

如需将所有节点更新为与控制平面相同的版本，请运行 gcloud container clusters upgrade 命令：

gcloud container clusters upgrade CLUSTER_NAME

将 CLUSTER_NAME 替换为要升级的集群的名称。

要更新特定节点池，请指定 --node-pool 标志：

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

将 VERSION 替换为节点已升级的 Kubernetes 版本。例如 --cluster-version=1.7.2 或 cluster-version=latest。

如需详细了解如何指定版本，请参阅版本控制。

如需了解详情，请参阅 gcloud container clusters upgrade 文档。

控制台

如需使用 Cloud Console 升级节点池，请执行以下步骤：

要升级节点池，请执行以下步骤：

1. 转到 Cloud Console 中的 Google Kubernetes Engine 页面：

   转到 Google Kubernetes Engine

2. 在要修改的集群旁边，点击 操作，然后点击 修改。

3. 在集群详情页面上，点击节点标签页。

4. 在节点池部分，点击要升级的节点池的名称。

5. 点击 修改。

6. 点击节点版本下的更改。

7. 从节点版本下拉列表中选择所需的版本，然后点击更改。

注意：节点版本可能需要几分钟才能更改。

降级节点池

注意：不建议降级节点池。您只应在节点池升级失败时尝试降级节点池来进行修复。

检查节点池升级状态

Beta 版

本产品或功能受《Google Cloud Platform 服务条款》的正式发布前产品条款约束。对正式发布前产品和功能的支持可能有限，并且对正式发布前产品和功能的变更可能不兼容其他正式发布前版本。 如需了解详情，请参阅发布阶段说明。

您可以使用 gcloud beta container operations 检查升级的状态。

注意：如需使用 gcloud beta 命令，您必须配置 gcloud 以使用 v1beta1 API。

如需查看集群中每个正在运行和已完成的操作的列表，请运行以下命令：

gcloud beta 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 beta container operations describe OPERATION_ID

例如：

gcloud beta 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

取消节点池升级

Beta 版 — gcloud container operations

此功能受《Google Cloud Platform 服务条款》的正式发布前产品条款约束。对正式发布前功能的支持可能有限，并且对正式发布前功能的变更可能不兼容其他正式发布前版本。 如需了解详情，请参阅发布阶段说明。

您可以随时取消升级。取消升级时，情况如下：

• 已经开始升级的节点会完成升级。
• 尚未开始升级的节点不会升级。
• 已成功完成升级的节点不受影响且不会回滚。

1. 使用以下命令获取升级的操作 ID：

   gcloud container operations list
   

2. 运行以下命令可以取消升级：

   gcloud beta container operations cancel OPERATION_ID
   

请参阅 gcloud container operations cancel 文档。

回滚节点池升级

您可以将无法升级或已取消升级的节点池回滚到其先前版本的 Kubernetes。升级成功后，您无法回滚节点池。尚未开始升级的节点不受影响。

如需回滚升级，请运行以下命令：

gcloud container node-pools rollback NODE_POOL_NAME \
  --cluster CLUSTER_NAME

请替换以下内容：

• NODE_POOL_NAME：要回滚的节点池的名称。
• CLUSTER_NAME：要从中回滚节点池的集群的名称。

请参阅 gcloud container node-pools rollback 文档。

更改超额配置升级参数

借助超额配置升级，您可以更改 GKE 同时升级的节点数以及升级对工作负载造成的中断时长。

我们为每个节点池定义了 max-surge-upgrade 和 max-unavailable-upgrade 标志。如需详细了解如何选择正确的参数，请参阅确定最佳超额配置。

注意：所有新节点池都会自动配置为使用超额配置升级maxSurge=1 maxUnavailable=0。如需调整配置，请参阅确定最佳超额配置。

警告：对于使用 Spot 虚拟机的节点（预览版），由于没有可用性保证，因此超额配置升级值会被忽略。升级期间，旧节点会直接排空，而无需等待使用 Spot 虚拟机的超额配置节点准备就绪。

您可以在创建或更新集群或节点池时更改这些设置。

以下变量将用于下文提到的命令：

• CLUSTER_NAME：节点池的集群名称。
• COMPUTE_ZONE：集群的区域。
• NODE_POOL_NAME：节点池的名称。
• NUMBER_NODES：每个集群的区域的节点池中的节点数。
• SURGE_NODES：每次升级节点池时要创建的额外（超额配置）节点的数量。
• UNAVAILABLE_NODES：是每次升级节点池时不可用的节点数。

创建具有特定超额配置参数的集群

如需创建具有特定超额配置升级设置的集群，请使用 max-surge-upgrade 和 max-unavailable-upgrade 标志。

gcloud container clusters create CLUSTER_NAME \
  --max-surge-upgrade=SURGE_NODES --max-unavailable-upgrade=UNAVAILABLE_NODES

创建停用超额配置升级的集群

如需创建停用超额配置升级的集群，请将 max-surge-upgrade 标志的值设置为 0。

gcloud container clusters create CLUSTER_NAME \
  --max-surge-upgrade=0 --max-unavailable-upgrade=1

创建具有特定超额配置参数的节点池

如需在现有集群中创建具有特定超额配置升级设置的节点池，请使用 max-surge-upgrade 和 max-unavailable-upgrade 标志。

gcloud container node-pools create NODE_POOL_NAME \
  --num-nodes=NUMBER_NODES --cluster=CLUSTER_NAME \
  --max-surge-upgrade=SURGE_NODES --max-unavailable-upgrade=UNAVAILABLE_NODES

为现有节点池启用或停用超额配置升级

如需更新现有节点池的升级设置，请使用 max-surge-upgrade 和 max-unavailable-upgrade 标志。如果将 max-surge-upgrade 设置为大于 0，则 GKE 会创建超额配置节点。如果将 max-surge-upgrade 设置为 0，则 GKE 不会创建超额配置节点。

gcloud beta container node-pools update NODE_POOL_NAME \
  --cluster=CLUSTER_NAME \
  --max-surge-upgrade=SURGE_NODES --max-unavailable-upgrade=UNAVAILABLE_NODES

检查节点池上是否启用了超额配置升级

如需查看节点池上是否启用了超额配置升级，请使用 gcloud 描述集群的参数：

gcloud container node-pools describe NODE_POOL_NAME \
--cluster=CLUSTER_NAME

注意：重新创建节点时不需要额外的 Compute Engine 资源，但超额配置升级节点需要额外的资源。资源分配受 Compute Engine 配额限制。根据您的配置，此配额可能会限制并行升级的数量，甚至可能导致升级失败。

如需详细了解配额，请参阅节点升级和配额

已知问题

如果您配置的 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

后续步骤

• 了解集群架构。
• 了解发布渠道。