升級節點集區時略過某個版本

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 版。

2. 如果管理員叢集是 1.28 版，請按照步驟升級管理員工作站和管理員叢集至 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