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

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

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

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

如要建立具有進階維護控制項的單一租戶節點群組，請按照下列步驟操作：

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

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

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

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

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

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

支援的機器家族

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

限制

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

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

費用

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

事前準備

  • 在單一租戶節點上佈建 VM 前，請先檢查配額。視您預留的節點數量和大小而定，您可能需要申請額外配額。

  • 如果尚未設定驗證，請先完成設定。 驗證可確認您的身分，以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，請選取下列其中一個選項，向 Compute Engine 進行驗證：

    請根據您打算如何使用本頁範例，選取對應的分頁標籤：

    控制台

    使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，不需要設定驗證。

    gcloud

    1. 安裝 Google Cloud CLI。 安裝完成後，請執行下列指令，初始化 Google Cloud CLI：

      gcloud init

      若您採用的是外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  • 設定預設區域和可用區。

    • REST

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

      安裝 Google Cloud CLI。

      如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

    詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

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

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

控制台

建立節點群組時，選取「Configure Maintenance Settings」(設定維護設定) 區段中的「Opt-in for sole-tenancy advanced maintenance」(選擇加入單一用戶群的進階維護) 選項，即可選擇加入進階維護控制項。詳情請參閱「建立單一租戶節點群組」。

gcloud

如要建立具有進階維護控制項的單一租戶節點群組，請使用 gcloud compute sole-tenancy node-groups create 指令。

下列指令中的 --maintenance-interval=RECURRENT 旗標指定單一租戶節點已選擇加入進階維護控制項。

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

更改下列內容：

  • NODE_GROUP_NAME：節點群組的名稱。

  • NODE_TEMPLATE_NAME：用於建立這個群組的節點範本名稱。

  • NODE_GROUP_SIZE：要在群組中建立的節點數量。

  • NODE_GROUP_ZONE：要在其中建立節點群組的可用區。這必須與節點範本所在的區域相同，您要以該範本為節點群組的基礎。

REST

如要根據先前建立的節點範本，建立具有進階維護控制項的單一租戶節點群組，請使用 nodeGroups.insert 方法。

如要根據先前為所有其他節點建立的節點範本，建立單一租戶節點群組，請使用 nodeGroups.insert 方法。

下列指令中的 maintenanceInterval 參數指定單一租戶節點已選擇加入進階維護控制項。

POST https://compute.googleapis.com/compute/v1/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"
}

更改下列內容：

  • PROJECT_ID：節點群組所在專案的名稱。

  • NODE_GROUP_ZONE：節點群組的可用區。

  • NODE_GROUP_NAME：節點群組的名稱。

  • NODE_TEMPLATE_URL：用於建立這個群組的節點範本網址。

  • NODE_GROUP_SIZE：要在群組中建立的節點數量。

節點層級的旗標會覆寫先前指派的所有 VM 旗標。因此，選擇啟用進階維護控制項會覆寫所有先前的維護旗標。

查看即將執行的維護作業

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

控制台

為單一租戶節點群組啟用進階維護控制項後，您會看到即將進行的維護事件，如下所示：

  1. 前往 Google Cloud 控制台的「Sole-tenant nodes」(單一租戶節點) 頁面。

    前往「Sole-tenant nodes」(單一租戶節點) 頁面

  2. 按一下「Node groups」(節點群組)，查看單一租戶節點群組清單。

  3. 對於任何單一租戶節點群組，您可以在表格中查看即將進行的維護作業，以及「維護狀態」和「維護時間」欄。由於維護作業是在節點層級設定，因此您在這裡看到的維護資訊，是節點群組中任何節點的下次預定維護時間。

  4. 如要查看單一租戶節點群組中各節點的維護資訊，請按一下節點群組的「Name」(名稱)，開啟詳細資料頁面。在節點群組中，每個節點的「Maintenance Status」(維護狀態) 和「Maintenance Time」(維護時間) 欄都會顯示即將進行的維護作業資訊。

gcloud

如要列出具有進階維護控制項的單一租戶節點群組節點，以及維護資訊，請使用 gcloud compute sole-tenancy node-groups list-nodes 指令。

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

將 NODE_GROUP_NAME 替換為節點群組名稱。

REST

如要列出具有進階維護控制項的單一租戶節點群組節點，以及這些節點的維護資訊，請使用 nodeGroups.listNodes 方法。

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

更改下列內容：

  • PROJECT_ID：節點群組所在專案的名稱。

  • NODE_GROUP_ZONE：節點群組的可用區。

  • NODE_GROUP_ID：節點群組的 ID。

以下是 nodeGroups.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
      },
      …
    },
    …
  ],
  …
}

以下是節點群組維護事件的詳細資料：

參數名稱 說明
windowStartTime 維護期間的開始時間。
windowEndTime 維護期間的結束時間。
latestWindowStartTime 初始維護期間的開始時間。您可以選擇立即觸發維護作業，或安排在 latestWindowStartTime 前的日期和時間執行。
maintenanceType 即將執行的維護作業類型：
- Scheduled：這個節點已排定維護作業。
- 未排定：維護作業代表重大更新，通知時間會短得多。
canReschedule 是否可以重新安排維護時間。
maintenanceStatus 目前維護作業的狀態：
- 待處理：維護作業尚未開始，但已排定。
- 進行中：維護期間已開始。

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

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

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

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

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

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

控制台

如要立即觸發節點維護作業，請執行下列操作：

  1. 前往 Google Cloud 控制台的「Sole-tenant nodes」(單一租戶節點) 頁面。

    前往單一用戶群節點

  2. 按一下「節點群組」。

  3. 按一下節點群組的名稱，開啟詳細資料頁面。

  4. 選取要立即觸發維護作業的節點，然後按一下「立即開始」。

您會看到確認訊息，維護作業會在您觸發要求後的 6 小時內進行。

如要安排節點維護作業，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Sole-tenant nodes」(單一租戶節點) 頁面。

    前往單一用戶群節點

  2. 按一下「節點群組」，即可查看單一租戶節點群組清單。

  3. 按一下節點群組的「名稱」，開啟詳細資料頁面。

  4. 選取要排定維護作業的節點，然後按一下「Schedule Maintenance」(排定維護作業)。

  5. 在顯示的「排定維護作業」窗格中，選取要進行維護作業的日期和時間。請注意，您可以在初始維護期間的開始時間前，隨時排定節點的維護作業。

您會看到確認訊息，維護作業會在觸發要求後的 6 小時內執行。

gcloud

如要使用進階維護控制項，啟動或排定單一租戶節點的維護作業，請使用 gcloud compute sole-tenancy node-groups perform-maintenance 指令。

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

更改下列內容：

  • NODE_GROUP_NAME：節點群組的名稱。

  • NODE_GROUP_ZONE：節點群組的可用區。

  • NODE_NAMES：要執行維護作業的節點名稱。

  • WINDOW_START_TIME：維護作業的開始日期和時間。如要盡快開始維護，請省略這個旗標。

REST

使用 nodeGroups.performMaintenance 方法，啟動或排定單一租戶節點的維護作業，並使用進階維護控制項。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_NAME/performMaintenance

{
"nodes": [
  "NODE_NAME"
],
"startTime": "START_TIME"
}

更改下列內容：

  • PROJECT_ID：節點群組所在專案的名稱。

  • NODE_GROUP_ZONE：節點群組的可用區。

  • NODE_GROUP_NAME：節點群組的名稱。

  • NODE_NAME：要執行維護作業的節點名稱。至少須指定一個節點。

  • START_TIME：選用：維護作業的開始日期和時間，格式為 RFC 3339 時間戳記。如果省略，維護作業會盡快開始。

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

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

確認維護作業是否已完成

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

詳情請參閱「查看維護狀態」。

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

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

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

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