在 MIG 中建立大小調整要求

主控台

1. 前往 Google Cloud 控制台的「Instance Templates」(執行個體範本) 頁面。

   前往「Instance templates」(執行個體範本) 頁面

2. 按一下「建立執行個體範本」。「Create an instance template」(建立執行個體範本) 頁面隨即開啟。

3. 在「Name」欄位中，輸入執行個體範本的名稱。

4. 在「位置」部分中，選取下列其中一個選項：

   • 如要建立區域執行個體範本，請選取「Regional (recommended)」(區域 (建議)，然後選取要建立範本的區域。

   • 如要建立全域執行個體範本，請選取「Global」。

5. 在「機器設定」部分中，執行下列操作：

   1. 按一下「GPU」分頁標籤。

   2. 在「GPU type」清單中選取 GPU 類型。

   3. 在「Number of GPUs」(GPU 數量) 清單中，選取 GPU 數量。

   4. 選用：如果 GPU 型號支援NVIDIA RTX 虛擬工作站 (vWS)，用於處理圖形工作負載，且您打算執行需要大量圖形的工作負載，請選取「啟用虛擬工作站 (NVIDIA GRID)」。

   5. 在「Machine type」(機器類型) 部分中，選取機器類型。

6. 在「Provisioning model」(佈建模型) 部分執行下列操作：

   1. 在「VM 佈建模型」清單中，選取「彈性啟動」。

   2. 如要為透過執行個體範本建立的 VM 設定執行時間長度，請在「輸入小時數」欄位中輸入小時數。這個值必須介於一小時 (1) 和七天 (168) 之間。

7. 選用步驟：如要變更預設值開機磁碟類型或映像檔，請在「Boot disk」(開機磁碟) 部分中按一下「Change」(變更)。然後按照提示變更啟動磁碟。

8. 按一下 [建立]。

gcloud

如要建立設定為建立 MIG 大小調整要求的執行個體範本，請使用 beta instance-templates create 指令搭配下列旗標：

• --maintenance-policy 標記設為 TERMINATE。

• --instance-termination-action 標記設為 DELETE。

• --max-run-duration 標記。

• --provisioning-model 標記設為 FLEX_START。

• --reservation-affinity 標記設為 none。

以下指令會建立區域執行個體範本。如要建立全球執行個體範本，請使用相同指令，但不含 --instance-template-region 旗標。

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-termination-action=DELETE \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --max-run-duration=RUN_DURATION \
    --provisioning-model=FLEX_START \
    --reservation-affinity=none

更改下列內容：

• INSTANCE_TEMPLATE_NAME：要建立的執行個體範本名稱。

• IMAGE_PROJECT：包含圖片的圖片專案，例如 debian-cloud。如要進一步瞭解支援的圖像專案，請參閱「公開圖像」。

• IMAGE_FAMILY：圖片群組。這會指定最新的非淘汰 OS 映像檔。舉例來說，如果您指定 debian-12，系統會使用 Debian 12 映像檔系列中的最新版本。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。

• REGION：要建立執行個體範本的區域。

• MACHINE_TYPE：GPU 機器類型。如果您指定 N1 機器類型，請加入 --accelerator 標記，以定義要連結至 VM 的 GPU 數量和類型。

• RUN_DURATION：您希望要求的 VM 執行多久。您必須將值格式化為天數、小時、分鐘或秒數，後面分別加上 d、h、m 和 s。舉例來說，如果要指定 30 分鐘，請指定 30m；如果要指定一天、兩小時、三分鐘和四秒，請指定 1d2h3m4s。值必須介於 10 分鐘至七天。

REST

如要建立在 MIG 中建立調整大小要求的執行個體範本，請向下列任一方法提出 POST 要求：

• 如要建立地區執行個體範本，請使用 beta.regionInstanceTemplates.insert 方法：

• 如要建立全域執行個體範本，請使用 beta.instanceTemplates.insert 方法：

在要求主體中加入下列欄位：

• scheduling.onHostMaintenance 欄位設為 TERMINATE。

• scheduling.instanceTerminationAction 欄位設為 DELETE。

• scheduling.maxRunDuration 欄位。

• scheduling.provisioningModel 欄位設為 FLEX_START。

• reservationAffinity.consumeReservationType 欄位設為 NO_RESERVATION。

舉例來說，如要建立區域執行個體範本，請提出以下 POST 要求：

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "maxRunDuration": {
        "seconds": RUN_DURATION
      },
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "FLEX_START"
    }
  }
}

更改下列內容：

• PROJECT_ID：建立執行個體範本的專案 ID。

• REGION：要建立執行個體範本的區域。

• INSTANCE_TEMPLATE_NAME：要建立的執行個體範本名稱。

• IMAGE_PROJECT：包含圖片的圖片專案，例如 debian-cloud。如要進一步瞭解支援的圖像專案，請參閱「公開圖像」。

• IMAGE：指定下列其中一個值：

  • 特定 OS 映像檔版本，例如 debian-12-bookworm-v20240617。

  • 映像檔系列，格式必須為 family/IMAGE_FAMILY。這會指定最新的非淘汰作業系統映像檔。舉例來說，如果您指定 family/debian-12，系統會使用 Debian 12 映像檔系列中的最新版本。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。

• MACHINE_TYPE：GPU 機器類型。如果您指定 N1 機器類型，請在要求主體中加入 guestAccelerators 欄位，藉此定義要附加至 VM 的 GPU 數量和類型。

• RUN_DURATION：您希望要求的 VM 執行的時間長度，以秒為單位。這個值必須介於 600 (600 秒，即 10 分鐘) 和 604800 (604,800 秒，即 7 天) 之間。

主控台

1. 前往 Google Cloud 控制台的「Instance groups」(執行個體群組) 頁面。

   前往「Instance groups」(執行個體群組)

2. 按一下「建立執行個體群組」。「Create instance group」(建立執行個體群組) 頁面隨即開啟。

3. 在「Name」 欄位中，輸入 MIG 的名稱。

4. 選取執行個體範本前，您必須刪除自動調度資源設定並關閉修復功能，步驟如下：

   1. 如要刪除自動調度資源設定，請按照下列步驟操作：

      1. 在「Autoscaling」部分，按一下「Autoscaling mode」清單，然後點選「Delete autoscaling configuration」。

      2. 在確認對話方塊中按一下「刪除」。

   2. 如要關閉修復功能，請在「VM 執行個體生命週期」部分中，按一下「發生錯誤時的預設動作」清單，然後選取「不執行任何動作」。

5. 返回「Instance template」欄位。在「Instance template」清單中，選取您在先前章節中建立的執行個體範本。如果選取區域執行個體範本，系統會將「區域」清單設為範本的區域。

6. 執行下列其中一個步驟：

   • 如要在建立 MIG 時建立大小調整要求，請執行下列操作：

     1. 在「Number of instances」欄位中，輸入要一次建立的 VM 數量。

     2. 勾選「透過大小調整要求一次建立多個 VM」核取方塊。

     3. 選用步驟：如要為 VM 指定與執行個體範本中設定的不同執行時間長度，請在「Requested run duration」欄位和「Unit」清單中指定時間長度。時長必須介於 1 小時至 7 天之間。

   • 如要在建立 MIG 後建立大小調整要求，請在「執行個體數量」欄位中輸入 0。

7. 在「Location」(位置) 部分中，指定要建立區域性或地區性 MIG，如下所示：

   1. 如要建立可用區 MIG，請選取「單一可用區」。或者，如要建立區域性 MIG，請選取「多可用區」。

   2. 選取 MIG 的「Region」(區域)和「Zone」(可用區)。

   3. 如果您要建立區域性 MIG，請執行下列步驟：

      1. 在「Target distribution shape」(目標分配型態) 欄位中，選取「Any single zone」(任何單一可用區)。

      2. 在隨即顯示的對話方塊中，按一下「Disable instance redistribution」(停用執行個體重新分配)。

8. 按一下 [建立]。

gcloud

使用 instance-groups managed create 指令，並將 --default-action-on-vm-failure 旗標設為 do_nothing。如果您要建立區域性 MIG，則必須將 --target-distribution-shape 旗標設為 any-single-zone，並將 --instance-redistribution-type 旗標設為 none。

• 如要建立區域 MIG，請執行下列指令：

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=0 \
      --zone=ZONE \
      --default-action-on-vm-failure=do_nothing
  

• 如要建立地區 MIG，請執行下列指令：

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=0 \
      --region=REGION \
      --target-distribution-shape=any-single-zone \
      --instance-redistribution-type=none \
      --default-action-on-vm-failure=do_nothing
  

更改下列內容：

• INSTANCE_GROUP_NAME：要建立的 MIG 名稱。

• INSTANCE_TEMPLATE_URL：您在先前章節建立的執行個體範本部分網址。如果您想使用區域執行個體範本建立 MIG，則只能在範本的區域內建立 MIG。請指定下列其中一個值：

  • 區域執行個體範本： projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • 全域執行個體範本： INSTANCE_TEMPLATE_NAME

• ZONE：建立 MIG 的可用區。

• REGION：要建立 MIG 的區域。

REST

• 如要建立區域 MIG，請使用 instanceGroupManagers.insert 方法傳送 POST 要求，如下所示：

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
  
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": 0,
    "instanceLifecyclePolicy": {
      "defaultActionOnFailure": "DO_NOTHING"
    }
  }
  

• 如要建立區域性 MIG，請使用 regionInstanceGroupManagers.insert 方法傳送 POST 要求，如下所示：

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
  
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": 0,
    "distributionPolicy": {
      "targetShape": "ANY_SINGLE_ZONE"
    },
    "updatePolicy": {
      "instanceRedistributionType": "NONE"
    },
    "instanceLifecyclePolicy": {
      "defaultActionOnFailure": "DO_NOTHING"
    }
  }
  

更改下列內容：

• PROJECT_ID：您在上一節中建立的執行個體範本所在專案的 ID。

• INSTANCE_TEMPLATE_URL：您在先前章節建立的執行個體範本的部分網址。如果您想使用區域執行個體範本建立 MIG，則只能在範本的區域內建立 MIG。請指定下列其中一個值：

  • 區域執行個體範本： regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • 全域執行個體範本： global/instanceTemplates/INSTANCE_TEMPLATE_NAME

• ZONE：建立 MIG 的可用區。

• REGION：要建立 MIG 的區域。

• INSTANCE_GROUP_NAME：要建立的 MIG 名稱。

主控台

1. 前往 Google Cloud 控制台的「Instance groups」(執行個體群組) 頁面。

   前往「Instance groups」(執行個體群組)

2. 在「Name」欄中，按一下要建立調整大小要求的 MIG 名稱。

   MIG 的總覽頁面隨即開啟。

3. 在「大小調整要求」列中，按一下 edit「編輯大小調整要求」。

4. 按一下 add「新調整大小要求」。

   畫面上會顯示「New resize requests」窗格。

5. 在「名稱」欄位中輸入調整大小要求的名稱。

6. 在「Number of additional instances needed」(額外需要的執行個體數量) 欄位中，輸入要一次新增至 MIG 的 VM 數量。

7. 選用：如要為 VM 指定與執行個體範本中設定的時間長度不同的執行時間長度，請在「Requested run duration」和「Unit」欄位中指定時間長度。時間範圍必須介於一小時至七天。

8. 按一下 [建立]。

gcloud

• 如要在區域 MIG 中建立調整大小要求，請使用 instance-groups managed resize-requests create 指令。

  gcloud compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
      --resize-request=RESIZE_REQUEST_NAME \
      --resize-by=COUNT \
      --zone=ZONE
  

• 如要在區域性 MIG 中建立調整大小要求，請使用 beta instance-groups managed resize-requests create 指令。

  gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
      --resize-request=RESIZE_REQUEST_NAME \
      --resize-by=COUNT \
      --region=REGION
  

更改下列內容：

• INSTANCE_GROUP_NAME：在 MIG 中設定用於建立大小調整要求的名稱。

• RESIZE_REQUEST_NAME：大小調整要求的名稱，在指定的 MIG 中不得重複。否則，建立調整大小要求會失敗。

• COUNT：一次新增至 MIG 的 VM 數量。

• ZONE：MIG 所在的可用區。

• REGION：MIG 所在的區域。

您也可以採取下列做法：

• 如果您想為 VM 指定的執行時間長度與 MIG 執行個體範本中設定的不同，請加入 --requested-run-duration 標記。

• 如果工作負載需要特定的 VM 名稱，您可以使用 beta instance-groups managed resize-requests create 指令指定要建立的 VM 名稱清單。在指令中，將 --resize-request 旗標替換為 --instances 旗標。

REST

• 如要在區域 MIG 中建立調整大小要求，請使用 instanceGroupManagerResizeRequests.insert 方法傳送 POST 要求。

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
  

• 如要在區域 MIG 中建立調整大小要求，請使用 beta.regionInstanceGroupManagerResizeRequests.insert 方法傳送 POST 要求。

在要求主體中加入下列內容：

{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT
}

更改下列內容：

• PROJECT_ID：指定 MIG 所在專案的 ID。

• ZONE：MIG 所在的可用區。

• REGION：MIG 所在的區域。

• INSTANCE_GROUP_NAME：在 MIG 中設定用於建立調整大小要求的名稱。

• RESIZE_REQUEST_NAME：大小調整要求的名稱，在指定的 MIG 中不得重複。否則，建立大小調整要求會失敗。

• COUNT：一次新增至 MIG 的 VM 數量。

您也可以採取下列做法：

• 如果您想為 VM 指定與 MIG 執行個體範本中設定的不同執行時間長度，請在要求主體中加入 requestedRunDuration 欄位。

• 如果工作負載需要特定的 VM 名稱，您可以指定要建立的 VM 名稱清單。如要這麼做，請針對區域 MIG 向 beta.regionInstanceGroupManagerResizeRequests.insert 方法傳送 POST 要求，或針對區域 MIG 向 beta.instanceGroupManagerResizeRequests.insert 方法傳送要求。在要求主體中，將 resizeBy 欄位替換為 instanceNames 欄位。