為單一用戶群節點啟用進階維護控制項

單一用戶群的進階維護控制項可讓您控制單一用戶群節點群組的預定維護事件，並盡量減少維護作業造成的服務中斷。這項功能僅適用於單一租戶節點群組。如要搭配現有虛擬機器使用這項功能，請先將 VM 移至已啟用進階維護控制項的單一租戶節點群組。

單一用戶群的進階維護控制項功能可讓您：

• 提前 28 天查看排定在單一租戶節點執行的維護作業。
• 立即觸發維護作業，或安排稍後執行。請注意，如果立即觸發維護作業，系統會在觸發要求後的 6 小時內執行維護作業。

以下是建立單一租戶節點群組的程序，可進行進階維護控制：

1. 在相容的單一用戶群節點群組中，選擇啟用進階維護控制項。這項功能僅適用於單一租戶節點群組。如要搭配現有 VM 或單一用戶群工作負載使用這項功能，您必須先將 VM 遷移至已啟用進階維護控制項的單一用戶群節點群組。

2. 檢查單一用戶群節點的近期維護作業。單一租戶節點的維護作業最多每 28 天執行一次。您可以在節點預定維護作業的 6 小時維護期間開始前 28 天，查看節點的維護事件。

3. 如果單一租戶節點已排定維護作業，您可以在排定的維護期間開始前執行下列操作：

   • 立即觸發維護作業，或安排日後執行。 如果您選擇立即觸發維護作業，系統會在您觸發要求後的 6 小時內執行維護作業。請注意，您選擇的排定日期和時間必須早於初始維護期間的開始時間。

   • 如果您未立即觸發維護作業或安排稍後執行，系統會在初始維護時段內執行維護作業。

您可以選擇啟用進階維護控制項，自動調度單一用戶群節點群組的資源。系統一律會產生稽核記錄。

支援的機器系列

單一租戶節點的進階維護控制項支援 C2、C3、C3D、C4、G2、H3、M1、M2 和 M3 機器系列，且已正式推出。

限制

單一用戶群的進階維護控制項功能有以下限制：

• 本機 SSD 和 GPU：這項功能不支援本機 SSD 和 GPU。
• 維護政策：這項功能支援預設維護政策 (即時遷移)。系統不支援其他維護政策，例如就地重新啟動和在節點群組內遷移。
• 節點：這項功能在每個可用區的每個專案中，最多可支援 20 個節點。
• 現有單一用戶群節點群組的進階維護控制項： 您無法為現有單一用戶群節點群組選擇啟用進階維護控制項。如要在啟用進階維護控制項的單一租戶節點群組上執行現有工作負載，請先建立啟用進階維護控制項的新節點群組，然後將工作負載遷移至這個群組。同樣地，如要停用進階維護控制項，您必須將單一用戶群節點遷移至未啟用進階維護控制項的單一用戶群節點群組。
• 對目前維護政策的影響：選擇啟用這項功能後，系統會覆寫與單一租戶節點相關聯的現有維護時段。

費用

在單一租戶節點上使用進階維護控制項不會產生額外費用。

事前準備

• 在單一租戶節點上佈建 VM 前，請先檢查配額。視您預留的節點數量和大小而定，您可能需要申請額外配額。
• 如果尚未設定驗證，請先完成設定。 「驗證」是指驗證身分的程序，確認您有權存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，請選取下列其中一個選項，向 Compute Engine 進行驗證：
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。

在單一用戶群節點上啟用進階維護控制項

單一用戶群的進階維護控制項是選擇性功能，僅適用於單一用戶群節點群組。如要搭配現有 VM 或單一用戶群工作負載使用這項功能，請先將 VM 移至已啟用進階維護控制項的單一用戶群節點群組。

gcloud compute sole-tenancy node-groups create NODE_GROUP_NAME \
--node-template=NODE_TEMPLATE_NAME \
--zone=NODE_GROUP_ZONE \
--target-size=NODE_GROUP_SIZE \
--maintenance-interval=RECURRENT

POST https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups
{
"name": "NODE_GROUP_NAME",
"nodeTemplate": "NODE_TEMPLATE_URL",
"zone": "NODE_GROUP_ZONE",
"size": "NODE_GROUP_SIZE",
"maintenanceInterval": "RECURRENT"
}

查看近期維護作業

單一租戶節點的維護作業最多每 28 天執行一次。您可以在 6 小時維護期間開始前 28 天，查看節點的維護事件。維護作業預定會在該期間內進行。

gcloud compute sole-tenancy node-groups list-nodes NODE_GROUP_NAME \
--format "table(name, status, node_type, instances, server_id, upcoming_maintenance)"

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes

{
  …
  "items": [
    …
    {
      "name": string,
      "status": string,
      …
      "upcomingMaintenance": {
        "canReschedule": boolean,
        "maintenanceType": enum, // SCHEDULED | UNSCHEDULED
        "windowStartTime": string, // RFC 3339 timestamp string
        "windowEndTime": string, // RFC 3339 timestamp string
        "latestWindowStartTime": string, // RFC 3339 timestamp string
        "maintenanceStatus": enum // PENDING | ONGOING
      },
      …
    },
    …
  ],
  …
}

如果沒有看到任何維護事件，表示節點群組中沒有任何節點即將進行維護。

立即觸發維護作業或為節點安排維護作業

瞭解單一租戶節點群組中排定維護作業的節點後，您可以採取下列任一做法：

• 立即觸發維護作業。如果您選擇立即觸發維護作業，系統會在您觸發要求後的 6 小時內執行維護作業。

• 根據需求安排稍後進行維護作業。

如果您未立即觸發維護作業，或排定日後的時間，系統會在初始維護期間執行維護作業。節點維護作業開始後，就無法暫停或重新安排。

gcloud compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \
--zone=NODE_GROUP_ZONE \
--nodes=NODE_NAMES \
--window-start-time=WINDOW_START_TIME

POST
https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/performMaintenance
{
"nodes": "NODE_NAMES" // [Required] The user needs to list at least 1 node
"windowStartTime":  "WINDOW_START_TIME" // [Optional] RFC 3339 timestamp string
}

節點的「維護狀態」欄位會在維護程序期間顯示下列狀態：

• 待處理：維護作業尚未開始，但已排定時間。
• 進行中：維護期間已開始。節點維護作業順利完成前，維護事件會維持「進行中」狀態。

確認維護作業是否已完成

如要查詢具有進階維護控制項的節點維護狀態，請使用 gcloud compute sole-tenancy node-groups list-nodes 指令或 nodeGroups.listNodes 方法。

詳情請參閱檢查維護狀態。

• 維護作業成功：如果單一租戶節點的維護作業成功，系統會移除維護通知。查詢節點群組名稱時，節點不會再顯示 upcomingMaintenance 區段。
• 維護作業失敗：如果維護作業未在 6 小時內完成，維護事件會維持「進行中」狀態，直到節點維護作業順利完成為止。完成後，維護通知就會移除。

有時，如果您選擇的日期和時間超出單一用戶群節點的進階維護控制項內部限制，系統可能會拒絕維護觸發要求。 Google Cloud 在這種情況下，您必須為節點維護作業選取其他日期和時間。這個節點的「維護狀態」為「進行中」，且在維護作業順利完成前，狀態不會改變。

變更排定的維護日期和時間

如要修改單一租戶節點的排定維護日期和時間，請按照觸發或排定節點維護作業的相同程序操作。