升级节点池时跳过某个版本

1.32 及更高版本

如果目标版本为 1.32 或更高版本，请使用此序列。假设用户集群控制平面和所有节点池都处于次要版本 1.N。使用跳过版本升级将集群从 1.N 升级到 1.N+2 的流程大致如下：

1. 将管理员集群从版本 1.N 升级到中间版本 1.N+1。
2. 将管理员集群从中间版本 1.N+1 升级到目标版本 1.N+2。
3. 仅将用户集群控制平面从来源版本 1.N 升级到中间版本 1.N+1。请将节点池保留为来源版本。之所以需要中间版本，是因为控制平面必须一次升级一个次要版本。
4. 将控制平面和节点池升级到目标版本 1.N+2。

1.31

如果用户集群的版本为 1.29，请使用此特殊序列，这意味着目标版本为 1.31。如果用户集群的版本为 1.29，则管理用户集群的管理员集群的版本可以是 1.27、1.28 或 1.29。

1. 如果管理员集群为 1.27 版，请将其升级到 1.28。
2. 如果管理员集群为 1.28 版，请将其升级到 1.29。
3. 仅将用户集群控制平面从来源版本 1.29 升级到中间版本 1.30。请将节点池保留为来源版本。之所以需要中间版本 1.30，是因为控制平面必须一次升级一个次要版本。
4. 将管理员集群从 1.29 版升级到中间版本 1.30。
5. 将管理员集群升级到目标版本 1.31。
6. 将用户集群控制平面和节点池升级到目标版本 1.31。

1.30 及更低版本

如果目标版本为 1.30 或更低版本，请使用此序列。

假设用户集群控制平面和所有节点池都处于次要版本 1.N。使用跳过版本升级将集群从 1.N 升级到 1.N+2 的流程大致如下：

1. 仅将控制平面从来源版本 1.N 升级到中间版本 1.N+1。请将节点池保留为来源版本。之所以需要中间版本，是因为控制平面必须一次升级一个次要版本。
2. 将控制平面和节点池升级到目标版本 1.N+2。

1.31

如果用户集群的版本为 1.29（意味着目标版本为 1.31），请使用此特殊序列。之所以需要此序列，是因为版本规则在 1.31 版中发生了变化。

如果用户集群的版本为 1.29，则管理用户集群的管理员集群的版本可以是 1.27、1.28 或 1.29。

1. 如果管理员集群的版本为 1.27，请按照相关步骤将管理员工作站升级到 1.28 版并将管理员集群升级到 1.28 版。

2. 如果管理员集群的版本为 1.28，请按照相关步骤将管理员工作站升级到 1.29 版并将管理员集群升级到 1.29 版。

3. 为了节省管理员工作站的空间，请移除已下载的软件包：

   rm /var/lib/gke/bundles/gke-onprem-vsphere-*.tgz
   

如果管理员集群和所有用户集群均为 1.29 版，您可以开始跳过版本升级。

1. 在以下占位变量中定义来源版本 (1.29)、中间版本 (1.30) 和目标版本 (1.31)。所有版本都必须是采用 x.y.z-gke.N 格式的完整版本号，例如 1.29.700-gke.110。

   版本
   获取当前用户集群的 1.29 版。这是来源版本。	SOURCE_VERSION
   选择中间版本 1.30。	INTERMEDIATE_VERSION
   选择目标版本 1.31。从次要版本 1.31 中选择建议的补丁。	TARGET_VERSION

2. 将管理员工作站升级到中间版本 1.30 INTERMEDIATE_VERSION。等待指示升级成功的消息。

3. 安装相应的软件包：

   gkectl prepare \
       --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

4. 再次升级管理员工作站，但这次升级到目标版本 1.31 TARGET_VERSION。等待指示升级成功的消息。

5. 安装相应的软件包：

   gkectl prepare \
       --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

6. 仅将用户集群控制平面升级到中间版本，如下所示：

   1. 在用户集群配置文件中进行以下更改：

      • 将 gkeOnPremVersion 字段设置为中间版本 INTERMEDIATE_VERSION。

      • 将 nodePools[i].gkeOnPremVersion 中的所有节点池版本设置为来源版本 SOURCE_VERSION。

      更新配置文件后，该文件应如下所示：

      gkeOnPremVersion: INTERMEDIATE_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: SOURCE_VERSION
        ...
      - name: pool-2
        gkeOnPremVersion: SOURCE_VERSION
        ...
      

   2. 升级控制平面：

      gkectl upgrade cluster \
          --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
          --config USER_CLUSTER_CONFIG_FILE
      

      将 USER_CLUSTER_CONFIG 替换为用户集群配置文件的路径。

7. 将管理员集群配置文件中的 bundlePath 字段设置为软件包的中间版本 1.30：

   bundlePath="/var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz"
   

8. 将管理员集群升级到中间版本 1.30：

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG_FILE
   

9. 将管理员集群配置文件中的 bundlePath 字段设置为软件包的目标版本 1.31：

   bundlePath="/var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz"
   

10. Upgrade the admin cluster to the target 1.31 version:

    gkectl upgrade admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG_FILE
    

11. 将控制平面和节点池升级到目标版本，具体如下：

    1. 在用户集群配置文件中进行以下更改：

       • 将 gkeOnPremVersion 字段设置为目标版本 TARGET_VERSION。

       • 将所有 nodePools[i].gkeOnPremVersion 设置为空字符串。

       更新配置文件后，该文件应如下所示：

       gkeOnPremVersion: TARGET_VERSION
       ...
       nodePools:
       - name: pool-1
         gkeOnPremVersion: ""
         ...
       - name: pool-2
         gkeOnPremVersion: ""
         ...
       

    2. 升级控制平面和节点池：

       gkectl upgrade cluster \
           --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
           --config USER_CLUSTER_CONFIG_FILE
       

1.30 及更低版本

如果目标版本为 1.30 或更低版本，请使用此序列。

1. 在以下占位变量中定义来源版本 (1.N)、中间版本 (1.N+1) 和目标版本 (1.N+2)。所有版本都必须是采用 x.y.z-gke.N 格式的完整版本号，例如 1.16.11-gke.25。

   版本
   获取当前的集群版本。这是来源版本 (1.N)。	SOURCE_VERSION
   选择中间版本 (1.N+1)。	INTERMEDIATE_VERSION
   选择目标版本 (1.N+2)。从目标次要版本中选择建议的补丁。	TARGET_VERSION

2. 将管理员工作站升级到中间版本 INTERMEDIATE_VERSION。等待指示升级成功的消息。

3. 安装相应的软件包：

   gkectl prepare \
       --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

   将 ADMIN_CLUSTER_KUBECONFIG 替换为管理员集群 kubeconfig 文件的路径。

4. 再次升级管理员工作站，但这次升级到目标版本 TARGET_VERSION。等待指示升级成功的消息。

5. 安装相应的软件包：

   gkectl prepare \
       --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

6. 仅将控制平面升级到中间版本，具体如下：

   1. 在用户集群配置文件中进行以下更改：

      • 将 gkeOnPremVersion 字段设置为中间版本 INTERMEDIATE_VERSION。

      • 将 nodePools[i].gkeOnPremVersion 中的所有节点池版本设置为来源版本 SOURCE_VERSION。

      更新配置文件后，该文件应如下所示：

      gkeOnPremVersion: INTERMEDIATE_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: SOURCE_VERSION
        ...
      - name: pool-2
        gkeOnPremVersion: SOURCE_VERSION
        ...
      

   2. 升级控制平面：

      gkectl upgrade cluster \
          --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
          --config USER_CLUSTER_CONFIG_FILE
      

      将 USER_CLUSTER_CONFIG 替换为用户集群配置文件的路径。

7. 将控制平面和节点池升级到目标版本，具体如下：

   1. 在用户集群配置文件中进行以下更改：

      • 将 gkeOnPremVersion 字段设置为目标版本 TARGET_VERSION。

      • 将所有 nodePools[i].gkeOnPremVersion 设置为空字符串。

      更新配置文件后，该文件应如下所示：

      gkeOnPremVersion: TARGET_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: ""
        ...
      - name: pool-2
        gkeOnPremVersion: ""
        ...
      

   2. 升级控制平面和节点池：

      gkectl upgrade cluster \
          --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
          --config USER_CLUSTER_CONFIG_FILE