建立單一用戶群節點範本

本文說明如何建立及刪除單一租戶節點範本。建立單一租戶節點範本前，請先參閱單一租戶節點總覽，瞭解重要概念和術語。

單一租戶節點範本是區域資源，可指定單一租戶節點群組的屬性。您必須先建立節點範本，才能建立節點群組。

建立單一租戶節點範本

如果您使用 gcloud CLI 或 REST，可以建立節點範本資源，稍後可用於建立一或多個節點群組。如果您使用 Google Cloud 主控台，則必須在建立節點群組時建立節點範本。

如要建立單一用戶群節點範本，請使用下列其中一種方法：

控制台

  1. 前往 Google Cloud 控制台的「單一租戶節點」頁面。

    前往單一用戶群節點

  2. 按一下「建立節點群組」。 在控制台中建立節點群組的過程，包括建立或選取節點範本。

  3. 指定節點群組的「名稱」。

  4. 指定要建立節點範本的「Region」(區域)。您可以使用節點範本，在這個區域的任何可用區建立節點群組。

  5. 指定「區域」，然後按一下「繼續」。

  6. 在「節點範本」清單中，按一下「建立節點範本」，開始建立單一租戶節點範本。

  7. 指定節點範本的「Name」(名稱)。

  8. 為要根據這個節點範本建立的節點群組中，每個單一用戶群節點指定節點類型。

  9. 視需要，您也可以為節點範本指定下列屬性：

    • 新增本機 SSD 和 GPU 加速器。
    • 選取「啟用 CPU 超額配置」，即可控管節點中排程各 VM 的 CPU 超額配置程度。
    • 新增節點相依性標籤。相依性標籤可讓您以邏輯方式將節點和節點群組分組，之後在佈建 VM 時，您可以在 VM 上指定相依性標籤，將 VM 排程到特定節點或節點群組。詳情請參閱「節點親和性和反親和性」。

  10. 按一下 [Create] (建立)，完成建立節點範本。

  11. 選用：如要在其他區域新增專屬節點範本，請重複上述步驟。

如要查看節點範本，請按一下「單一用戶群節點」頁面中的「節點範本」。

gcloud

使用 gcloud compute sole-tenancy node-templates create 指令建立節點範本：

gcloud compute sole-tenancy node-templates create TEMPLATE_NAME \
  --node-type=NODE_TYPE \
  [--region=REGION \]
  [--node-affinity-labels=AFFINITY_LABELS \]
  [--accelerator type=GPU_TYPE,count=GPU_COUNT \]
  [--disk type=local-ssd,count=DISK_COUNT,size=DISK_SIZE \]
  [--cpu-overcommit-type=CPU_OVERCOMMIT_TYPE]

更改下列內容：

  • TEMPLATE_NAME：新節點範本的名稱。

  • NODE_TYPE：根據此範本建立的單一用戶群節點節點類型。使用 gcloud compute sole-tenancy node-types list 指令，取得每個區域可用的節點類型清單。

  • REGION：要在其中建立節點範本的區域。您可以使用這個範本，在這個區域的任何可用區建立節點群組。

  • AFFINITY_LABELS：相依性標籤的鍵和值，[KEY=VALUE,...]。相依性標籤可讓您以邏輯方式將節點和節點群組分組，之後在佈建 VM 時，您可以在 VM 上指定相依性標籤，將 VM 排程到特定節點或節點群組。詳情請參閱「節點親和性和反親和性」。

  • GPU_TYPE：根據這個節點範本建立的每個單一租戶節點所用的 GPU 類型。如要瞭解 GPU 的區域可用性，請使用 gcloud compute accelerator-types list 指令，並選擇提供 n1、g2、a3-highgpu 或 a3-megagpu 單一租戶節點類型的區域。視區域可用性而定，設定為下列其中一項：

    • A3 High：nvidia-h100-80gb
    • A3 Mega：nvidia-h100-mega-80gb
    • G2：nvidia-l4
    • N1：
      • nvidia-tesla-p100
      • nvidia-tesla-p4
      • nvidia-tesla-t4
      • nvidia-tesla-v100

  • GPU_COUNT：要指定的 GPU 數量，取決於 GPU 類型。請根據下列表格，將值設為 GPU 類型指定的值：

    GPU_TYPE GPU_COUNT
    nvidia-h100-80gb 8
    nvidia-h100-mega-80gb 8
    nvidia-l4 8
    nvidia-tesla-p100 4
    nvidia-tesla-p4 4
    nvidia-tesla-t4 4
    nvidia-tesla-v100 8

  • DISK_COUNT：本機 SSD 磁碟數量。設為 16 或 24。A3 High 和 A3 Mega 節點類型包含固定數量的本機固態硬碟磁碟，因此不需要這個參數。

  • DISK_SIZE：本機 SSD 分區大小 (以 GB 為單位，選填)。唯一支援的分區大小為 375，如果未設定這個值，預設值為 375。

  • CPU_OVERCOMMIT_TYPE：VM 上 CPU 的超額配置類型。設為 enabled 或 none。

REST

使用 nodeTemplates.insert 方法建立節點範本：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/nodeTemplates

{
  "name": "TEMPLATE_NAME",
  "nodeType": "NODE_TYPE",
  "nodeAffinityLabels": {
    "KEY": "VALUE",
    ...
  },
  "accelerators": [
    {
      "acceleratorType": "GPU_TYPE",
      "acceleratorCount": GPU_COUNT
    }
  ],
  "disks": [
    {
      "diskType": "local-ssd",
      "diskSizeGb": DISK_SIZE,
      "diskCount": DISK_COUNT
    }
  ],
  "cpuOvercommitType": CPU_OVERCOMMIT_TYPE
}

更改下列內容：

  • PROJECT_ID：專案 ID。

  • REGION：要在其中建立節點範本的區域。您可以使用這個範本，在這個區域的任何可用區建立節點群組。

  • TEMPLATE_NAME：新節點範本的名稱。

  • NODE_TYPE：根據此範本建立的單一用戶群節點節點類型。使用 nodeTypes.list 方法，取得每個區域可用的節點類型清單。

  • KEY：nodeAffinityLabels 值，指定以鍵/值組合表示的節點親和性標籤鍵部分。相依性標籤可讓您從邏輯上將節點和節點群組分組，之後在佈建 VM 時，您可以在 VM 上指定相依性標籤，以便在特定節點或節點群組上排定 VM。詳情請參閱「節點親和性和反親和性」。

  • VALUE：nodeAffinityLabels 值，指定節點親和性標籤鍵/值組合的值部分。

  • GPU_TYPE：根據這個節點範本建立的每個單一租戶節點所用的 GPU 類型。如要瞭解 GPU 的區域可用性，請使用 gcloud compute accelerator-types list 指令，並選擇提供 n1、g2、a3-highgpu 或 a3-megagpu 單一租戶節點類型的區域。視區域可用性而定，設定為下列其中一項：

    • A3 High：nvidia-h100-80gb
    • A3 Mega：nvidia-h100-mega-80gb
    • G2：nvidia-l4
    • N1：
      • nvidia-tesla-p100
      • nvidia-tesla-p4
      • nvidia-tesla-t4
      • nvidia-tesla-v100

  • GPU_COUNT：根據這個節點範本建立的每個專屬租戶節點的 GPU 數量。請根據下表，將值設為 GPU 類型指定的值：

    GPU_TYPE GPU_COUNT
    nvidia-h100-80gb 8
    nvidia-h100-mega-80gb 8
    nvidia-l4 8
    nvidia-tesla-p100 4
    nvidia-tesla-p4 4
    nvidia-tesla-t4 4
    nvidia-tesla-v100 8

  • DISK_SIZE：本機 SSD 分區大小 (以 GB 為單位，選填)。唯一支援的分區大小為 375，如果未設定這個值，預設值為 375。

  • DISK_COUNT：本機 SSD 磁碟數量。設為 16 或 24。A3 High 和 A3 Mega 節點類型包含固定數量的本機固態硬碟磁碟，因此不需要這個參數。

  • CPU_OVERCOMMIT_TYPE：CPU 超額配置類型。設為 enabled、none 或 CPU_OVERCOMMIT_TYPE_UNSPECIFIED。

刪除節點範本

刪除使用範本的所有節點群組後，即可刪除節點範本。

控制台

  1. 前往 Google Cloud 控制台的「單一租戶節點」頁面。

    前往單一用戶群節點

  2. 按一下「節點範本」。

  3. 選取未使用的節點範本名稱。

  4. 按一下「Delete」(刪除)。

gcloud

使用 gcloud compute sole-tenancy node-templates delete 指令刪除未使用的節點範本：

gcloud compute sole-tenancy node-templates delete TEMPLATE_NAME \
  --region=REGION

更改下列內容：

  • TEMPLATE_NAME：要刪除的節點範本名稱

  • REGION：節點範本的區域

REST

使用 compute.nodeTemplates.delete 方法刪除未使用的節點範本：

 DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/nodeTemplates/TEMPLATE_NAME

更改下列內容：

  • PROJECT_ID：專案 ID

  • REGION：包含節點範本的 Google Cloud 區域

  • TEMPLATE_NAME：要刪除的節點範本名稱

後續步驟