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

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

單一用戶群的進階維護控制項可讓您控制單一用戶群節點群組的預定維護事件，並盡可能減少維護相關中斷情形。這項功能僅適用於單一用戶群節點群組。如要在現有虛擬機器上使用這項功能，您必須先將 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

  To use the REST API samples on this page in a local development environment, you use the credentials you provide to the 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.

  For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

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

單一用戶群的進階維護控制項是選擇加入功能，僅適用於單一用戶群節點群組。如要將這項功能與現有的 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 單一用戶群節點的進階維護控制項內部限制在指定日期和時間超過上限，系統可能會拒絕您所選日期和時間的維護觸發要求。在這種情況下，您必須選取其他日期和時間來維護節點。這個節點的維護狀態為「進行中」，直到維護作業順利完成為止。

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

您可以使用與觸發或排定節點維護作業相同的程序，修改單一租用戶節點的預定維護日期和時間。