建立 MIG，供 HPC 工作負載使用預留項目

gcloud

如要建立區域執行個體範本，請使用 gcloud compute instance-templates create 指令。

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --instance-template-region=REGION \
    --boot-disk-type=hyperdisk-balanced \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    
--network-interface=nic-type=GVNIC, \
      network=GVNIC_NAME_PREFIX-net-0, \
      subnet=GVNIC_NAME_PREFIX-sub-0, \
      stack-type=STACK_TYPE, \
      address=EXTERNAL_IPV4_ADDRESS \
--network-interface=nic-type=GVNIC, \
      network=GVNIC_NAME_PREFIX-net-1, \
      subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=IRDMA, \
      network=RDMA_NAME_PREFIX-irdma, \
      subnet=RDMA_NAME_PREFIX-irdma-sub, \
      stack-type=IPV4_ONLY,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=DELETE \
    --maintenance-policy=TERMINATE

更改下列內容：

• INSTANCE_TEMPLATE_NAME：執行個體範本的名稱。
• MACHINE_TYPE：執行個體要使用的 H4D 機型。
• IMAGE_FAMILY：您要使用的 OS 映像檔系列。 如需支援的作業系統清單，請參閱「支援的作業系統」。
• IMAGE_PROJECT：OS 映像檔的專案 ID。
• REGION：要建立執行個體範本的區域。指定您要使用的機型可用的區域。
• DISK_SIZE：開機磁碟的大小 (以 GiB 為單位)。

• GVNIC_NAME_PREFIX：您為 gVNIC 介面建立標準 VPC 網路和子網路時使用的名稱前置字元。

  如果使用預設聯播網，請只加入單一 --network-interface 欄位，並將 nic-type 欄位設為 GVNIC。此外，請省略這個網路介面的 network 和 subnetwork 設定。

• STACK_TYPE：選用：用於 gVNIC 介面的堆疊類型。 指定 IPV4_ONLY 或 IPV4_IPV6。如未指定值，系統會使用預設的 IPV4_ONLY。

• EXTERNAL_IPV4_ADDRESS：選用：要搭配 gVNIC 網路介面使用的靜態外部 IPv4 位址。您必須先預留外部 IPv4 位址。 執行下列其中一個步驟：

  • 從子網路指定有效的 IPv4 位址。
  • 如不希望網路介面有外部 IP 位址，請使用 no-address 旗標。
  • 如要讓網路介面接收暫時外部 IP 位址，請指定 address=''。

  如要為 GVNIC 網路介面指定外部 IPv6 位址，請改用 --external-ipv6-address 標記。

• RDMA_NAME_PREFIX：建立 IRDMA 網路介面適用的虛擬私有雲網路和子網路時使用的名稱前置字元。

  如果 H4D 執行個體未使用 Cloud RDMA，請省略 IRDMA 介面的 --network-interface 欄位。

• RESERVATION：要使用的預訂名稱。

  RESERVATION：預留項目名稱或預留項目內的特定區塊。如要取得預留名稱或可用區塊，請參閱「查看預留容量」。根據執行個體放置位置的需求，選擇下列其中一個選項：

  • 如要在多個區塊或單一區塊中建立執行個體，請按照下列步驟操作：

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

    此外， 如要建立單一區塊，請套用指定區塊共置 (maxTopologyDistance=BLOCK) 的工作負載政策， 建立 MIG。 Compute Engine 隨後會將政策套用至預留項目，並在相同區塊中建立執行個體。

  • 如要在特定區塊上建立執行個體，請按照下列步驟操作：

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME

REST

如要建立區域執行個體範本，請對 regionInstanceTemplates.insert 方法發出 POST 要求。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates
{
  "name":"INSTANCE_TEMPLATE_NAME",
  "properties":{
    "disks":[
      {
        "boot":true,
        "initializeParams":{
          "diskSizeGb":"DISK_SIZE",
          "diskType":"hyperdisk-balanced",
          "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "mode":"READ_WRITE",
        "type":"PERSISTENT"
      }
    ],
    "machineType":"MACHINE_TYPE",
    
        "networkInterfaces": [
        {
          "network": "GVNIC_NAME_PREFIX-net-0",
          "subnetwork": "GVNIC_NAME_PREFIX-sub-0",
          "accessConfigs": [
            {
                "type": "ONE_TO_ONE_NAT",
                "name": "External IP",
                "natIP": "EXTERNAL_IPV4_ADDRESS"
            }
          ],
          "stackType": "IPV4_ONLY",
          "nicType": "GVNIC",
      },
      {
          "network": "GVNIC_NAME_PREFIX-net-1",
          "subnetwork": "GVNIC_NAME_PREFIX-sub-1",
          "stackType": "IPV4_ONLY",
          "nicType": "GVNIC",
      },
      {
          "network": "RDMA_NAME_PREFIX-irdma",
          "subnetwork": "RDMA_NAME_PREFIX-irdma-sub",
          "stackType": "IPV4_ONLY",
          "nicType": "IRDMA",
      }
    ],
,
    "reservationAffinity":{
        "consumeReservationType":"SPECIFIC_RESERVATION",
        "key":"compute.googleapis.com/reservation-name",
        "values":[
          "RESERVATION"
        ]
      },
    "scheduling":{
        "provisioningModel":"RESERVATION_BOUND",
        "instanceTerminationAction":"DELETE",
        "onHostMaintenance": "TERMINATE",
        "automaticRestart":true
      }
  }
}

更改下列內容：

• INSTANCE_TEMPLATE_NAME：執行個體範本的名稱。
• MACHINE_TYPE：執行個體使用的機型。指定 H4D 機型。詳情請參閱 H4D 機器類型。
• IMAGE_FAMILY：您要使用的 OS 映像檔系列。 如需支援的作業系統清單，請參閱「支援的作業系統」。
• IMAGE_PROJECT：OS 映像檔的專案 ID。
• REGION：要建立執行個體範本的區域。指定您要使用的機型適用的區域。如要瞭解地區，請參閱「地區和可用區」。
• DISK_SIZE：開機磁碟的大小 (以 GiB 為單位)。

• GVNIC_NAME_PREFIX：您為 gVNIC 介面建立標準 VPC 網路和子網路時使用的名稱前置字元。

  如果使用預設聯播網，請只加入單一 --network-interface 欄位，並將 nic-type 欄位設為 GVNIC。此外，請省略這個網路介面的 network 和 subnetwork 設定。

• EXTERNAL_IPV4_ADDRESS：選用：要搭配 gVNIC 網路介面使用的靜態外部 IPv4 位址。您必須先預留外部 IPv4 位址。

  如要為 GVNIC 網路介面指定外部 IPv6 位址，請改用 --external-ipv6-address 標記。

• RDMA_NAME_PREFIX：建立 IRDMA 網路介面適用的虛擬私有雲網路和子網路時使用的名稱前置字元。

  如果 H4D 執行個體未使用 Cloud RDMA，請省略 IRDMA 介面的 --network-interface 欄位。

• RESERVATION：要使用的預訂名稱。

  RESERVATION：預留項目名稱或預留項目內的特定區塊。如要取得預留名稱或可用區塊，請參閱「查看預留容量」。根據執行個體放置位置的需求，選擇下列其中一個選項：

  • 如要在多個區塊或單一區塊中建立執行個體，請按照下列步驟操作：

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

    此外， 如要建立單一區塊，請套用指定區塊共置 (maxTopologyDistance=BLOCK) 的工作負載政策， 建立 MIG。 Compute Engine 隨後會將政策套用至預留項目，並在相同區塊中建立執行個體。

  • 如要在特定區塊上建立執行個體，請按照下列步驟操作：

    projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME

gcloud

如要建立具有指定目標大小的 MIG，請使用 instance-groups managed create 指令。

在這個步驟中，建立 MIG 的指令會使用工作負載政策指定 VM 放置位置。如不想使用工作負載政策，請移除 --workload-policy 旗標。

請按照下列步驟建立可用區或區域性 MIG：

• 如要建立可用區 MIG，請使用下列指令：

  gcloud compute instance-groups managed create MIG_NAME \
    --template=INSTANCE_TEMPLATE_URL \
    --size=TARGET_SIZE \
    --workload-policy=WORKLOAD_POLICY_URL \
    --zone=ZONE
  

• 如要建立區域性 MIG，請使用下列指令：

  gcloud compute instance-groups managed create MIG_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=TARGET_SIZE \
      --workload-policy=WORKLOAD_POLICY_URL \
      --region=REGION
  

• MIG_NAME：MIG 的名稱。
• INSTANCE_TEMPLATE_URL：您要用於在 MIG 中建立執行個體的執行個體範本網址。網址可以包含執行個體範本的ID 或名稱。請指定下列其中一個值：
  • 如果是區域執行個體範本：projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • 全域執行個體範本：INSTANCE_TEMPLATE_ID
• TARGET_SIZE：您要在 MIG 中使用的 VM 數量。
• WORKLOAD_POLICY_URL：選填：工作負載政策的網址。如果不想使用工作負載政策，可以移除 --workload-policy 旗標。
• ZONE：要建立 MIG 的可用區。如果您使用工作負載政策，請在政策的區域內指定可用區。
• REGION：要建立 MIG 的區域。如果您使用工作負載政策，請指定與政策相同的區域。如果是區域性 MIG，您可以使用 --zones 旗標指定該區域中的可用區，而非區域。

REST

如要建立具有指定目標大小的 MIG，請發出下列 POST 要求。

在這個步驟中，建立 MIG 的要求會使用工作負載政策指定 VM 放置位置。如果不想使用工作負載政策，請從要求主體中移除 resourcePolicies.workloadPolicy 欄位。

請按照下列步驟建立可用區或區域性 MIG：

• 如要建立區域 MIG，請向 instanceGroupManagers.insert 方法發出 POST 要求。

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "MIG_NAME",
    "instanceTemplate": "INSTANCE_TEMPLATE_URL",
    "targetSize": "TARGET_SIZE",
    "resourcePolicies": {
      "workloadPolicy": WORKLOAD_POLICY_URL
    }
  }
  

• 如要建立區域 MIG，請向 regionInstanceGroupManagers.insert 方法發出 POST 要求。

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
    {
      "versions": [
        {
          "instanceTemplate": "INSTANCE_TEMPLATE_URL"
        }
      ],
      "name": "MIG_NAME",
      "instanceTemplate": "INSTANCE_TEMPLATE_URL",
      "targetSize": "TARGET_SIZE",
      "resourcePolicies": {
        "workloadPolicy": WORKLOAD_POLICY_URL
      }
    }
  

• PROJECT_ID：專案 ID。
• ZONE：要建立 MIG 的可用區。如果您使用工作負載政策，請在政策的區域內指定可用區。
• REGION：要建立 MIG 的區域。如果您使用工作負載政策，請指定與政策相同的區域。
• INSTANCE_TEMPLATE_URL：您要用於在 MIG 中建立執行個體的執行個體範本網址。網址可以包含執行個體範本的ID 或名稱。請指定下列其中一個值：
  • 如果是區域執行個體範本：projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • 全域執行個體範本：INSTANCE_TEMPLATE_ID
• MIG_NAME：MIG 的名稱。
• TARGET_SIZE：MIG 中所需的 VM 數量。
• WORKLOAD_POLICY_URL：選填：工作負載政策的網址。如果不想使用工作負載政策，可以移除 resourcePolicies.workloadPolicy 欄位。

gcloud

在這個步驟中，建立 MIG 的指令會使用工作負載政策指定 VM 放置位置。如不想使用工作負載政策，請移除 --workload-policy 旗標。

請按照下列步驟建立可用區或區域 MIG，以及規模調整要求：

• 如要在可用區 MIG 中建立規模調整要求，請按照下列步驟操作：

  1. 使用下列instance-groups managed create 指令建立可用區 MIG。

     gcloud compute instance-groups managed create MIG_NAME \
         --template=INSTANCE_TEMPLATE_URL \
         --size=0 \
         --workload-policy=WORKLOAD_POLICY_URL \
         --zone=ZONE
     

  2. 使用 instance-groups managed resize-requests create 指令，在區域 MIG 中建立規模調整要求，如下所示：

     gcloud compute instance-groups managed resize-requests create MIG_NAME \
         --resize-request=RESIZE_REQUEST_NAME \
         POPULATION_METHOD \
         --zone=ZONE
     

• 如要在區域 MIG 中建立規模調整要求，請執行下列操作：

  1. 使用 instance-groups managed create 指令建立區域性 MIG，如下所示。

     gcloud compute instance-groups managed create MIG_NAME \
         --template=INSTANCE_TEMPLATE_URL \
         --size=0 \
         --workload-policy=WORKLOAD_POLICY_URL \
         --zones=ZONE \
         --target-distribution-shape=any-single-zone \
         --instance-redistribution-type=none
       

  2. 使用 beta instance-groups managed resize-requests create 指令，在區域 MIG 中建立大小調整要求，如下所示：

     gcloud beta compute instance-groups managed resize-requests create MIG_NAME \
         --resize-request=RESIZE_REQUEST_NAME \
         POPULATION_METHOD \
         --region=REGION
     

更改下列內容：

• MIG_NAME：MIG 的名稱。
• INSTANCE_TEMPLATE_URL：您要用於在 MIG 中建立執行個體的執行個體範本網址。網址可以包含執行個體範本的ID 或名稱。請指定下列其中一個值：
  • 如果是區域執行個體範本：projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • 全域執行個體範本：INSTANCE_TEMPLATE_ID
• WORKLOAD_POLICY_URL：選填：工作負載政策的網址。如果不想使用工作負載政策，可以移除 --workload-policy 旗標。
• ZONE：要建立 MIG 的可用區。您也必須為區域 MIG 指定可用區。這個區域必須是包含虛擬私有雲網路設定檔的區域，且必須是可使用機型的區域。詳情請參閱「限制」一節。
• RESIZE_REQUEST_NAME：調整大小要求名稱，在指定的 MIG 內不得重複。否則建立大小調整要求就會失敗。

• POPULATION_METHOD：將執行個體新增至 MIG 的方法。請使用下列其中一種方法：

  • --resize-by=COUNT：一次將指定數量的執行個體新增至 MIG。系統會自動產生執行個體名稱。
  • --instances=INSTANCE_NAME_LIST：一次將指定名稱的執行個體新增至 MIG。將 INSTANCE_NAME_LIST 替換為以半形逗號分隔的執行個體名稱清單。您提供的名稱數量會決定要透過這項調整大小要求建立的執行個體數量。
• REGION：MIG 所在的區域。

如要將工作負載政策套用至 MIG，請在指令中加入 --workload-policy 旗標。

REST

在這個步驟中，建立 MIG 的要求會使用工作負載政策指定 VM 放置位置。如果不想使用工作負載政策，請從要求主體中移除 resourcePolicies.workloadPolicy 欄位。

請按照下列步驟建立可用區或區域 MIG，以及規模調整要求：

• 如要在可用區 MIG 中建立 MIG 和調整大小要求，請按照下列步驟操作：
  1. 向 instanceGroupManagers.insert 方法發出 POST 要求，建立可用區 MIG，如下所示。

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
     {
       "versions": [
         {
           "instanceTemplate": "INSTANCE_TEMPLATE_URL"
         }
       ],
       "name": "MIG_NAME",
       "targetSize": 0,
       "resourcePolicies": {
         "workloadPolicy": WORKLOAD_POLICY_URL
       }
     }
     

  2. 在區域 MIG 中建立大小調整要求，方法是向 instanceGroupManagerResizeRequests.insert 方法發出 POST 要求，如下所示：

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resizeRequests
     {
       "name": "RESIZE_REQUEST_NAME",
       POPULATION_METHOD
     }
     

• 如要在區域 MIG 中建立規模調整要求，請按照下列步驟操作：
  1. 向 regionInstanceGroupManagers.insert 方法發出 POST 要求，建立區域 MIG，如下所示。

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
     {
       "versions": [
         {
           "instanceTemplate": "INSTANCE_TEMPLATE_URL"
         }
       ],
       "name": "MIG_NAME",
       "targetSize": 0,
       "distributionPolicy": {
         "targetShape": "ANY_SINGLE_ZONE",
         "zones": [
           {
             "zone": "projects/PROJECT_ID/zones/ZONE"
           }
         ]
       },
       "updatePolicy": {
         "instanceRedistributionType": "NONE"
       },
       "resourcePolicies": {
         "workloadPolicy": WORKLOAD_POLICY_URL
       }
     }
     

  2. 在區域 MIG 中建立規模調整要求，方法是向 beta.regionInstanceGroupManagerResizeRequests.insert 方法發出 POST 要求，如下所示：

     POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests
     {
       "name": "RESIZE_REQUEST_NAME",
       POPULATION_METHOD
     }
     

更改下列內容：

• PROJECT_ID：專案 ID。
• ZONE：要建立 MIG 的可用區。您也必須為區域 MIG 指定可用區。這個區域必須是包含虛擬私有雲網路設定檔的區域，且必須是可使用機型的區域。詳情請參閱「限制」一節。
• REGION：要建立 MIG 的區域。
• INSTANCE_TEMPLATE_URL：您要用於在 MIG 中建立執行個體的執行個體範本網址。網址可以包含執行個體範本的ID 或名稱。請指定下列其中一個值：
  • 如果是區域執行個體範本：projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
  • 全域執行個體範本：INSTANCE_TEMPLATE_ID
• MIG_NAME：MIG 的名稱。
• WORKLOAD_POLICY_URL：選填：工作負載政策的網址。如果不想使用工作負載政策，可以移除 resourcePolicies.workloadPolicy 欄位。
• RESIZE_REQUEST_NAME：調整大小要求名稱，在指定的 MIG 內不得重複。否則建立大小調整要求就會失敗。

• POPULATION_METHOD：將執行個體新增至 MIG 的方法。請使用下列其中一種方法：

  • "resizeBy":COUNT：將 COUNT 替換為要一次新增至 MIG 的執行個體數量。系統會自動產生執行個體名稱。
  • "instanceNames":INSTANCE_NAME_LIST：一次將指定名稱的執行個體新增至 MIG。將 INSTANCE_NAME_LIST 替換為以半形逗號分隔的執行個體名稱清單。您提供的名稱數量，決定了要透過這項調整大小要求建立的執行個體數量。

如要將工作負載政策套用至 MIG，請在要求內容中加入 resourcePolicies.workloadPolicy 欄位。