安排叢集升級作業的推出時程

機群

如要建立以機群為準的推出作業順序，請先將叢集分組為機群。您可以依部署環境 (例如測試、預備和正式環境) 整理叢集，如以機群為基礎的推出作業排序範例所示。

根據所選分組，將每個叢集註冊至機群。

團隊

如要建立以團隊為單位的推出順序，請將叢集分組到團隊範圍。如要這麼做，請先依部署環境 (例如測試、預備和正式環境) 將叢集劃分為多個機群，如範例範圍式推出順序所示。然後，您可以進一步將叢集細分為不同團隊叢集的範圍。

1. 針對序列中的每個叢集，向機群註冊叢集。叢集應註冊至專案中的機群，您將在該專案中為這個叢集建立團隊範圍。如要將叢集註冊至其他主專案的機群，請務必為跨專案註冊設定必要權限。

2. 建立 2 到 3 個團隊範圍，方便整理叢集。在團隊各自機群的主專案中建立每個範圍。在推出序列中，您最多可以有三個團隊範圍。

   如需完整旗標清單，請參閱 gcloud container fleet scopes create 參考資料。使用 create 指令時，您可以搭配使用指令中的旗標建立推出順序。

3. 將每個叢集新增至範圍。

車隊 - gcloud

下列操作說明使用 gcloud container fleet clusterupgrade update 指令，但您也可以使用 gcloud container fleet clusterupgrade create 指令設定相同屬性。

請在下列每個指令中，將 SOAK_TIME 替換為要更新的機群浸泡時間。

建立推出作業序列：

1. 設定序列中第一個機群的浸泡時間：

   gcloud container fleet clusterupgrade update \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_FLEET_PROJECT_ID
   

   將 FIRST_FLEET_PROJECT_ID 替換為車隊主專案的專案 ID。

2. 設定上游機群，以及序列中第二個機群的浸泡時間：

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=FIRST_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_FLEET_PROJECT_ID
   

   將 FIRST_FLEET_PROJECT_ID 替換為第一個車隊託管專案的專案 ID，並將 SECOND_FLEET_PROJECT_ID 替換為車隊託管專案的專案 ID。

3. 選用步驟：如要在推出序列中加入超過兩個機群，請為序列中的下一個機群設定上游機群。

   下列指令會為序列中的第三個機群設定上游機群。如要新增第四或第五個機群，請重複這個步驟，並按照相同模式，將變數替換為相應機群主機專案的專案 ID (前一個機群和下一個機群)。

   為序列中的下一個機群設定上游機群：

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=SECOND_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_FLEET_PROJECT_ID
   

   將 SECOND_FLEET_PROJECT_ID 替換為第二個車隊主專案的專案 ID，並將 THIRD_FLEET_PROJECT_ID 替換為車隊主專案的專案 ID。

機群 - 控制台

1. 前往 Google Cloud 控制台的「推出順序」頁面。

   前往「推出作業排序功能」

2. 按一下「建立推出作業序列」。

3. 在「建立推出序列」窗格中，選取序列中的前兩個車隊：

   1. 在「機群 1」部分中，選取序列中的第一個機群。
   2. 在「Soak time for upstream fleet」(上游車隊的浸泡時間) 部分，使用「Days」(天)、「Hours」(小時) 和「Minutes」(分鐘) 欄位，為第一個車隊設定浸泡時間。
   3. 在「車隊 2」部分中，選取序列中的第二個車隊。
   4. 點選「建立」。

4. 選用：如要在這次發布程序中加入三個以上的車隊，請完成下列額外步驟：

   1. 在「推出作業圖表」中，按一下第二個機群的元素。
   2. 按一下 add「新增下游機群」。
   3. 在「Soak time for upstream fleet」(上游機群的浸泡時間) 區段，使用「Days」(天)、「Hours」(小時) 和「Minutes」(分鐘) 欄位，設定第二個機群的浸泡時間。
   4. 在「序列中的下一個機群」部分，選取序列中的第三個機群。
   5. 按一下 [儲存]。
   6. 如要新增第四或第五支車隊，請重複上述步驟。

機群 - Terraform

本節說明如何使用 Terraform 建立以車隊為基礎的序列。您也可以使用這項資源更新序列。詳情請參閱 google_gke_hub_feature 的參考說明文件。

請在下列每個指令中，將 SOAK_TIME 替換為要更新的機群浸泡時間。

建立推出作業序列：

1. 在 Terraform 設定中新增下列區塊，為序列中的第一個機群設定浸泡時間：

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = []
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "FIRST_FLEET_PROJECT_ID"
   }
   

   將 FIRST_FLEET_PROJECT_ID 替換為車隊主專案的專案 ID。

2. 在 Terraform 設定中新增下列區塊，為序列中的第二個車隊設定上游車隊和浸泡時間：

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["FIRST_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "SECOND_FLEET_PROJECT_ID"
   }
   

   將 FIRST_FLEET_PROJECT_ID 替換為第一個車隊託管專案的專案 ID，並將 SECOND_FLEET_PROJECT_ID 替換為車隊託管專案的專案 ID。

3. 選用：如要在推出順序中加入三個機群，請在 Terraform 設定中新增下列區塊，為順序中的機群設定上游機群：

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["SECOND_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "THIRD_FLEET_PROJECT_ID"
   }
   

   將 SECOND_FLEET_PROJECT_ID 替換為第二個車隊託管專案的專案 ID，並將 THIRD_FLEET_PROJECT_ID 替換為車隊託管專案的專案 ID。

   如要新增第四或第五支車隊，請重複這個步驟。

Teams - gcloud

您可以在建立或更新團隊範圍時設定這些屬性。下列操作說明使用 gcloud container fleet scopes update 指令，但您也可以使用 gcloud container fleet scopes create 指令建立團隊範圍時，設定相同的屬性。

請針對每個指令替換下列項目：

• 變數，其中包含相應團隊範圍的名稱或團隊範圍的 Fleet 主機專案 ID。
• 您要更新的團隊範圍的浸泡時間。SOAK_TIME

建立推出作業序列：

1. 為序列中的第一個範圍設定浸泡時間：

   gcloud container fleet scopes update projects/FIRST_SCOPE_PROJECT_ID/locations/global/scopes/FIRST_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_SCOPE_PROJECT_ID
   

2. 在序列中設定第二個範圍的上游範圍和浸泡時間：

   gcloud container fleet scopes update projects/SECOND_SCOPE_PROJECT_ID/locations/global/scopes/SECOND_SCOPE_NAME \
       --upstream-scope=projects/FIRST_SCOPE_PROJECT_ID/locations/global/scopes/FIRST_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_SCOPE_PROJECT_ID
   

3. 選用：如要在推出順序中加入三個團隊範圍，請為順序中的第三個範圍設定上游範圍：

   gcloud container fleet scopes update projects/THIRD_SCOPE_PROJECT_ID/locations/global/scopes/THIRD_SCOPE_NAME \
       --upstream-scope=projects/SECOND_SCOPE_PROJECT/locations/global/scopes/SECOND_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_SCOPE_PROJECT_ID
   

機群

查看以車隊為準的推出順序狀態：

gcloud container fleet clusterupgrade describe \
    --show-linked-cluster-upgrade --project=FLEET_PROJECT_ID

將 FLEET_PROJECT_ID 替換為序列中任何車隊的託管專案專案 ID。

如需完整旗標清單，請參閱參考資料 gcloud container fleet clusterupgrade describe。

團隊

查看以團隊為準的推出順序狀態：

gcloud container fleet scopes describe SCOPE_NAME \
    --show-linked-cluster-upgrade
    --project=SCOPE_PROJECT_ID

將 SCOPE_NAME 替換為推出順序中的任何團隊範圍名稱，並將 SCOPE_PROJECT_ID 替換為這個團隊範圍的專案 ID。

如需完整旗標清單，請參閱 gcloud container fleet scopes describe 參考資料。

gcloud

如要變更群組的預設浸泡時間，請使用「建立推出程序」一節中的 gcloud CLI 指令，並省略設定上游群組的標記。

機群 - 控制台

1. 前往 Google Cloud 控制台的「推出順序」頁面。

   前往「推出作業排序功能」

2. 如要查看序列，請參閱「監控推出作業序列」一節。如果沒有看到推出順序，請改用其他推出順序，或建立推出順序 (如尚未建立)。

3. 在「推出圖表」中，按一下要更新浸泡時間的機群元素後方的「浸泡時間」元素。

4. 按一下 edit「編輯浸泡時間」。

5. 在「設定新的浸泡時間」部分，使用「天」、「時」和「分」欄位輸入新的浸泡時間。

6. 如要儲存設定，請按一下「儲存」。

車隊 - gcloud

在車隊的主專案中執行這項指令，覆寫特定版本推出時使用的浸泡時間。

變更機群的浸泡時間：

gcloud container fleet clusterupgrade update
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

機群 - Terraform

在 clusterupgrade 區塊中，將下列 gke_upgrades_overrides 區塊新增至 Terraform 設定，即可覆寫特定版本推出時使用的浸泡時間：

gke_upgrade_overrides {
    upgrade {
      name = "UPGRADE_NAME"
      version = "VERSION"
    }
    post_conditions {
      soaking = "SOAK_TIME"
    }
  }

Teams - gcloud

在團隊範圍機群的主專案中執行這項指令。將 SCOPE_NAME 替換為您要覆寫特定版本推出時所用浸泡時間的團隊範圍名稱。

變更團隊範圍的浸泡時間：

gcloud container fleet scopes update SCOPE_NAME \
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

車隊 - gcloud

請使用 gcloud container fleet clusterupgrade update 指令，並加上 --upstream-fleet 旗標，新增或變更上游車隊。使用 --reset-upstream-fleet 旗標移除上游車隊。

你可以執行下列動作：

• 在發布序列開頭新增另一個機群，方法是在序列中的第一個機群新增上游機群。
• 如要變更推出作業序列中的機群順序，請變更上游機群關聯。
• 移除第二個機群的上游機群，即可移除推出序列中的第一個機群。

機群 - 控制台

1. 前往 Google Cloud 控制台的「推出順序」頁面。

   前往「推出作業排序功能」

2. 如要查看序列，請參閱「監控推出作業序列」一節。如果沒有看到推出順序，請改用其他推出順序，或建立推出順序 (如尚未建立)。

3. 在「推出圖表」中，按一下序列中現有車隊的元素。點選這些元素後，您可以執行下列部分動作來進行變更：

   • 按一下 add「新增下游機群」。
   • 按一下「新增上游機群」add。
   • 按一下 delete「移除機群」。

你可以執行下列動作：

• 在發布序列結尾新增另一個機群，方法是在序列中的最後一個機群新增下游機群。
• 在發布序列開頭新增另一個機群，方法是在序列中的第一個機群新增上游機群。
• 如要變更推出作業序列中的機群順序，請移除機群，然後使用不同的上游或下游機群重新新增機群。
• 移除推出序列中的第一個機群。
• 移除推出序列中的最後一個機群。
• 移除序列中的第一個或最後一個機群後，即可移除序列中的中間機群。

Teams - gcloud

使用 gcloud container fleet scopes update 指令搭配 --upstream-scope 旗標，新增或變更上游團隊範圍。使用 --reset-upstream-scope 旗標移除上游團隊範圍。

你可以執行下列動作：

• 在推出順序的開頭新增另一個團隊範圍，方法是在順序中的第一個團隊範圍新增上游團隊範圍。
• 如要變更推出順序中的團隊範圍順序，請變更上游團隊範圍關聯。
• 移除第二個團隊範圍的上游團隊範圍，即可移除推出作業序列中的第一個團隊範圍。

從車隊到團隊

如要將叢集從機群推出作業排序改為團隊推出作業排序，請按照下列步驟操作：

1. 為每個機群中的所有叢集設定維護排除項目，防止您修改設定時進行任何升級。
2. 請確認您已在機群主專案中啟用 GKE Enterprise。
3. 在每個機群中，建立一或多個團隊範圍，將該機群中的叢集群組細分。
4. 在每個機群中，建立一或多個推出作業序列，並在相符的團隊範圍之間進行。
5. 將叢集新增至新的團隊範圍。
6. 移除為這項變更設定的維護作業排除時段。

團隊到機群

如要將叢集從以團隊為準的推出作業順序，變更為以機群為準的推出作業順序，請按照下列步驟操作：

1. 為每個機群中的所有叢集設定維護排除項目，防止在修改設定時進行任何升級。
2. 在機群之間建立推出作業序列。
3. 將叢集從團隊範圍中移除。 現在，這些叢集只會註冊至範圍各自的機群，也就是您在上一步驟中加入推出作業序列的機群。
4. 刪除團隊範圍。
5. 移除為這項變更設定的維護作業排除時段。

車隊 - gcloud

在推出順序中，除了第一個車隊以外，請在每個車隊的車隊主機專案中執行下列指令：

gcloud container fleet clusterupgrade update --reset-upstream-fleet

機群 - 控制台

1. 前往 Google Cloud 控制台的「推出順序」頁面。

   前往「推出作業排序功能」

2. 如要查看序列，請參閱「監控推出作業序列」一節。如果沒有看到推出順序，請改用其他推出順序，或建立推出順序 (如尚未建立)。

3. 在「推出圖表」中，按一下最後一個機群的元素。

4. 按一下 delete「移除機群」。

5. 如要移除車隊，請按一下「移除」。

6. 重複上述三個步驟，直到只剩下第一個車隊為止。

Teams - gcloud

在推出順序的第二和第三個團隊範圍中，於車隊主機專案執行下列指令：

gcloud container fleet scopes update SCOPE_NAME --reset-upstream-scope

將 SCOPE_NAME 分別替換為第二個和第三個範圍的名稱。