使用執行個體彈性大量建立 VM

本文說明如何在大量建立虛擬機器 (VM) 時,設定執行個體彈性。執行個體彈性可讓您指定多個機型、依偏好程度排序,並覆寫每個選項的最低 CPU 平台和磁碟設定,讓 Compute Engine 根據區域中的容量和配額可用性佈建 VM。

如要進一步瞭解大量建立的 VM 執行個體彈性,請參閱「關於大量建立的 VM 執行個體彈性」。

事前準備

  • 針對您打算建立的 VM 和任何相關資源,請確認您有足夠的配額。
  • 如要大量建立 Spot VM,請先查看資源可用性,再建立 VM。檢查資源可用性,有助於降低建立 VM 時發生資源可用性錯誤的機率。如需操作說明,請參閱「查看 Spot VM 的資源可用性」。
  • 如果尚未設定驗證,請先完成設定。驗證程序會確認您的身分,以便您存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例,您可以選取下列其中一個選項,向 Compute Engine 進行驗證:

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

    gcloud

    1. 安裝 Google Cloud CLI,然後使用聯合身分登入 gcloud CLI。 登入後, 執行下列指令來初始化 Google Cloud CLI:

      gcloud init
  • 設定預設區域和可用區。
  • REST

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

      安裝 Google Cloud CLI,然後使用聯合身分登入 gcloud CLI。

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

必要的角色

如要取得大量建立 VM 所需的權限,請要求管理員授予您專案的 Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備大量建立 VM 所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能大量建立 VM:

  • 專案的 compute.instances.create
  • 如要使用自訂映像檔建立 VM: compute.images.useReadOnly 在映像檔上
  • 如要使用快照建立 VM: compute.snapshots.useReadOnly 快照
  • 如要使用執行個體範本建立 VM: compute.instanceTemplates.useReadOnly 執行個體範本
  • 如要為 VM 指定子網路: compute.subnetworks.use 專案或所選子網路
  • 如要為 VM 指定靜態 IP 位址: compute.addresses.use 專案
  • 如要在使用虛擬私有雲網路時,將外部 IP 位址指派給 VM: compute.subnetworks.useExternalIp 在專案或所選子網路上
  • 如要將舊版網路指派給 VM: compute.networks.use 專案
  • 如要在使用舊版網路時,為 VM 指派外部 IP 位址: compute.networks.useExternalIp 專案
  • 如要為 VM 設定 VM 執行個體中繼資料: compute.instances.setMetadata 在專案上
  • 如要設定 VM 的標記: compute.instances.setTags 在 VM 上
  • 如要設定 VM 的標籤: compute.instances.setLabels 在 VM 上
  • 如要設定 VM 使用的服務帳戶: compute.instances.setServiceAccount 在 VM 上
  • 如要為 VM 建立新磁碟: compute.disks.create 專案
  • 如要以唯讀或讀寫模式連接現有磁碟: compute.disks.use 磁碟
  • 如要以唯讀模式連接現有磁碟: compute.disks.useReadOnly 在磁碟上

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

建立 VM 時,指定多個偏好程度相同的機型

如果工作負載可在多種不同機型上運作,您可以在單一執行個體選取項目中,指定所有相容機型的清單。以下範例說明如何指定多個偏好程度相同的機型。

gcloud

如要使用單一執行個體選項大量建立 VM,請使用 gcloud compute instances bulk create 指令搭配 --instance-selection-machine-types 旗標。

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --region=REGION \
    --count=COUNT \
    --instance-selection-machine-types=MACHINE_TYPE_1,MACHINE_TYPE_2

更改下列內容:

  • COUNT:要建立的 VM 數量
  • NAME_PATTERN:VM 的名稱模式
  • MACHINE_TYPE_1、MACHINE_TYPE_2:VM 要使用的機型
  • REGION:要建立 VM 的區域

範例

gcloud compute instances bulk create \
    --name-pattern=test-bulk-# \
    --region=us-central1 \
    --count=10 \
    --instance-selection-machine-types=c4-standard-8,c3-standard-8

REST

在 Compute Engine API 中,向 regionInstances.bulkInsert 方法提出 POST 要求。在要求主體中,加入 instanceFlexibilityPolicy,並附上列出機器類型的 instanceSelections 項目。

POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert
{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [{}]
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "selection-1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ]
      }
    }
  }
}

更改下列內容:

  • COUNT:要建立的 VM 數量
  • NAME_PATTERN:VM 的名稱模式
  • MACHINE_TYPE_1、MACHINE_TYPE_2:VM 要使用的機型
  • IMAGE_PROJECT:映像檔所在的專案
  • IMAGE:要使用的映像檔或映像檔系列名稱
  • PROJECT_ID:專案 ID
  • REGION:要建立 VM 的區域

範例

POST https://compute./compute/v1/projects/my-project/regions/us-central1/instances/bulkInsert
{
  "count": 10,
  "namePattern": "test-bulk-#",
  "instanceProperties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/debian-cloud/global/images/debian-12"
        }
      }
    ],
    "networkInterfaces": [{}]
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "selection-1": {
        "machineTypes": [
          "c4-standard-8",
          "c3-standard-8"
        ]
      }
    }
  }
}

建立 VM 時,可指定多種機型並按照偏好排序

如要讓 Compute Engine 按照特定順序選擇機型,可以設定多個執行個體選項。每個執行個體選項都包含機型清單和排名,排名是以整數定義機型的偏好設定。排名越低,表示偏好程度越高。Compute Engine 會嘗試使用偏好度較高 (排名較低) 的機器類型建立 VM。如果這些機器類型無法使用,Compute Engine 會使用偏好設定較低 (排名較高) 的機器類型。

以下範例說明如何指定多個執行個體選取項目,並設定排名。

gcloud

如要使用多個執行個體選項大量建立 VM,請使用 gcloud compute instances bulk create 指令,並多次指定 --instance-selection 旗標。

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --region=REGION \
    --count=COUNT \
    --instance-selection "name=INSTANCE_SELECTION_1,rank=0,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2" \
    --instance-selection "name=INSTANCE_SELECTION_2,rank=1,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4"

更改下列內容:

  • COUNT:要建立的 VM 數量
  • NAME_PATTERN:VM 的名稱模式
  • INSTANCE_SELECTION_1:第一個執行個體選項的名稱
  • INSTANCE_SELECTION_2:第二個執行個體選項的名稱
  • MACHINE_TYPE_1、MACHINE_TYPE_2:第一個執行個體選項的機器類型
  • MACHINE_TYPE_3、MACHINE_TYPE_4:第二個執行個體選項的機器類型
  • REGION:要建立 VM 的區域

範例

gcloud compute instances bulk create \
    --name-pattern=test-bulk-# \
    --region=us-central1 \
    --count=10 \
    --instance-selection "name=most-preferred,rank=0,machine-type=c4-standard-16" \
    --instance-selection "name=least-preferred,rank=1,machine-type=c3-standard-16"

REST

在 Compute Engine API 中,向 regionInstances.bulkInsert 方法提出 POST 要求。在要求主體中加入 instanceFlexibilityPolicy,並在 instanceSelections 中指定多個項目,每個項目都包含機器類型清單和 rank。

POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert
{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [{}]
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ],
        "rank": 1
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3",
          "MACHINE_TYPE_4"
        ],
        "rank": 2
      }
    }
  }
}

更改下列內容:

  • COUNT:要建立的 VM 數量
  • NAME_PATTERN:VM 的命名模式
  • INSTANCE_SELECTION_1:第一個執行個體選項的名稱
  • INSTANCE_SELECTION_2:第二個執行個體選項的名稱
  • MACHINE_TYPE_1、MACHINE_TYPE_2:第一個執行個體選項的機器類型
  • MACHINE_TYPE_3、MACHINE_TYPE_4:第二個執行個體選項的機器類型
  • IMAGE_PROJECT:映像檔所在的專案
  • IMAGE:要使用的映像檔或映像檔系列名稱
  • PROJECT_ID:專案 ID
  • REGION:要建立 VM 的區域

範例

POST https://compute./compute/v1/projects/my-project/regions/us-central1/instances/bulkInsert
{
  "count": 10,
  "namePattern": "test-bulk-#",
  "instanceProperties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/debian-cloud/global/images/debian-12"
        }
      }
    ],
    "networkInterfaces": [{}]
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "most-preferred": {
        "machineTypes": [
          "c4-standard-16"
        ],
        "rank": 1
      },
      "least-preferred": {
        "machineTypes": [
          "c3-standard-16"
        ],
        "rank": 2
      }
    }
  }
}

建立 VM 時,可指定多種機型、最低 CPU 平台和磁碟覆寫設定

除了指定機型和排名外,您也可以覆寫最低 CPU 平台,並覆寫或新增 instanceProperties 中每個執行個體選項的磁碟定義。 例如,在執行個體選項中,您可以覆寫開機磁碟大小,或為特定機器類型附加額外的 Hyperdisk 磁碟區。

如要進一步瞭解支援的磁碟類型,以及 Compute Engine 如何套用覆寫設定,請參閱下列資源:

* 支援 Hyperdisk 的機器系列 * 執行個體選項中的執行個體屬性覆寫

如要大量建立 VM,並指定多種機型、最低 CPU 平台和磁碟覆寫設定,請選取下列其中一個選項:

gcloud

如要大量建立 VM,並指定多種機型、最低 CPU 平台和磁碟覆寫設定,請使用 gcloud compute instances bulk create 指令搭配 --instance-flexibility-policy 旗標。如要覆寫 instanceProperties 的預設開機磁碟,請一併加入 --boot-disk-device-name 旗標,並在執行個體選取項目中指定相同的 deviceName:

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --region=REGION \
    --count=COUNT \
    --boot-disk-device-name=BOOT_DISK_DEVICE_NAME \
    --instance-flexibility-policy='{"instanceSelections":
        {"INSTANCE_SELECTION_1":{"rank":RANK_1,"machineTypes":["MACHINE_TYPE_1","MACHINE_TYPE_2"],"minCpuPlatform":"MIN_CPU_PLATFORM_1","disks":[{"deviceName":"BOOT_DISK_DEVICE_NAME_1","boot":true,"initializeParams":{"diskType":"DISK_TYPE_1","diskSizeGb":DISK_SIZE_1,"sourceImage":"projects/IMAGE_PROJECT_1/global/images/IMAGE_1"}}]},
        "INSTANCE_SELECTION_2":{"rank":RANK_2,"machineTypes":["MACHINE_TYPE_3"],"minCpuPlatform":"MIN_CPU_PLATFORM_2","disks":[{"deviceName":"BOOT_DISK_DEVICE_NAME_2","boot":true,"initializeParams":{"diskType":"DISK_TYPE_2","diskSizeGb":DISK_SIZE_2,"sourceImage":"projects/IMAGE_PROJECT_2/global/images/IMAGE_2"}}]}}}'

或者,如要使用 YAML 或 JSON 檔案設定執行個體彈性政策,請使用 --flags-file 旗標,而非 --instance-flexibility-policy 旗標:

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --region=REGION \
    --count=COUNT \
    --boot-disk-device-name=BOOT_DISK_DEVICE_NAME \
    --flags-file=FILE_NAME.yaml

更改下列內容:

  • COUNT:要建立的 VM 數量
  • NAME_PATTERN:VM 的名稱模式
  • REGION:要建立 VM 的區域
  • BOOT_DISK_DEVICE_NAME:instanceProperties 中預設開機磁碟的裝置名稱
  • INSTANCE_SELECTION_1、INSTANCE_SELECTION_2:所選執行個體的名稱
  • RANK_1、RANK_2:選用數字,代表您對各執行個體選項的偏好順序;值越低,偏好程度越高
  • MACHINE_TYPE_1、MACHINE_TYPE_2:第一個執行個體選項的機器類型
  • MACHINE_TYPE_3:第二個執行個體選項的機型
  • MIN_CPU_PLATFORM_1、MIN_CPU_PLATFORM_2:每個執行個體選項中,VM 的選用最低 CPU 平台
  • BOOT_DISK_DEVICE_NAME_1、BOOT_DISK_DEVICE_NAME_2:各執行個體選項中開機磁碟的裝置名稱;如要覆寫預設開機磁碟,請指定與 BOOT_DISK_DEVICE_NAME 相同的名稱
  • DISK_TYPE_1、DISK_TYPE_2:磁碟覆寫的磁碟類型,例如 hyperdisk-balanced
  • DISK_SIZE_1、DISK_SIZE_2:磁碟覆寫的磁碟大小
  • IMAGE_PROJECT_1、IMAGE_PROJECT_2:包含磁碟覆寫映像檔的專案
  • IMAGE_1、IMAGE_2:磁碟覆寫的映像檔或映像檔系列名稱
  • FILE_NAME.yaml:包含 --instance-flexibility-policy 設定的 YAML 或 JSON 檔案名稱

範例

下列範例會使用兩個執行個體選項建立 10 個 VM,這些選項會指定最低 CPU 平台、覆寫預設開機磁碟,並連接額外磁碟:

sh gcloud compute instances bulk create \ --name-pattern=test-bulk-# \ --region= \ --count=10 \ --boot-disk-device-name=boot-disk \ --instance-flexibility-policy='{"instanceSelections": {"selection-1":{"machineTypes":["c4-standard-8","c4-highcpu-8"],"minCpuPlatform":"Intel Emerald Rapids","disks":[{"type":"PERSISTENT","deviceName":"boot-disk","boot":true,"initializeParams":{"diskType":"hyperdisk-balanced","diskSizeGb":50,"sourceImage":"projects/debian-cloud/global/images/family/debian-12"}}]}, "selection-2":{"machineTypes":["c3-standard-8"],"minCpuPlatform":"Intel Sapphire Rapids","disks":[{"type":"PERSISTENT","deviceName":"boot-disk","boot":true,"initializeParams":{"diskType":"hyperdisk-balanced","diskSizeGb":50,"sourceImage":"projects/debian-cloud/global/images/family/debian-12"}},{"type":"PERSISTENT","deviceName":"data-disk","initializeParams":{"diskType":"hyperdisk-balanced","diskSizeGb":128}}]}}}'

或者,如果使用 --flags-file 旗標,您可以在 YAML 檔案中指定相同的執行個體彈性政策:

--instance-flexibility-policy:
  instanceSelections:
    selection-1:
      machineTypes:
        - c4-standard-8
        - c4-highcpu-8
      minCpuPlatform: Intel Emerald Rapids
      disks:
        - type: PERSISTENT
          deviceName: boot-disk
          boot: true
          initializeParams:
            diskType: hyperdisk-balanced
            diskSizeGb: 50
            sourceImage: projects/debian-cloud/global/images/family/debian-12
    selection-2:
      machineTypes:
        - c3-standard-8
      minCpuPlatform: Intel Sapphire Rapids
      disks:
        - type: PERSISTENT
          deviceName: boot-disk
          boot: true
          initializeParams:
            diskType: hyperdisk-balanced
            diskSizeGb: 50
            sourceImage: projects/debian-cloud/global/images/family/debian-12
        - type: PERSISTENT
          deviceName: data-disk
          initializeParams:
            diskType: hyperdisk-balanced
            diskSizeGb: 128

REST

在 Compute Engine API 中,向 regionInstances.bulkInsert 方法提出 POST 要求。在要求主體中加入 instanceFlexibilityPolicy,並在每個 instanceSelections 項目中加入 minCpuPlatform 欄位來覆寫 instanceProperties.minCpuPlatform,以及加入 disks 欄位來覆寫或新增至 instanceProperties.disks:

POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert
{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "disks": [
      {
        "boot": true,
        "deviceName": "boot-disk",
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [{}]
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ],
        "minCpuPlatform": "MIN_CPU_PLATFORM_1",
        "disks": [
          
          {
            "type": "PERSISTENT",
            "deviceName": "boot-disk",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 50,
              "sourceImage": "projects/IMAGE_PROJECT_1/global/images/IMAGE_1"
            },
            "boot": true
          }
          
        ]
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3"
        ],
        "minCpuPlatform": "MIN_CPU_PLATFORM_2",
        "disks": [
          {
            "type": "PERSISTENT",
            "deviceName": "boot-disk",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 50,
              "sourceImage": "projects/IMAGE_PROJECT_2/global/images/IMAGE_2"
            },
            "boot": true
          },
          {
            "type": "PERSISTENT",
            "deviceName": "data-disk",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 128
            }
          }
        ]
      }
    }
  }
}

更改下列內容:

  • COUNT:要建立的 VM 數量
  • NAME_PATTERN:VM 的命名模式
  • INSTANCE_SELECTION_1:第一個執行個體選項的名稱
  • INSTANCE_SELECTION_2:第二個執行個體選項的名稱
  • MACHINE_TYPE_1、MACHINE_TYPE_2:第一個執行個體選項的機器類型
  • MACHINE_TYPE_3:第二個執行個體選項的機型
  • MIN_CPU_PLATFORM_1、MIN_CPU_PLATFORM_2:每個執行個體選項中,VM 的選用最低 CPU 平台
  • IMAGE_PROJECT:instanceProperties 中包含預設開機映像檔的專案
  • IMAGE:instanceProperties 中預設開機映像檔或映像檔系列的名稱
  • IMAGE_PROJECT_1、IMAGE_PROJECT_2:包含磁碟覆寫映像檔的專案
  • IMAGE_1、IMAGE_2:磁碟覆寫的映像檔名稱
  • PROJECT_ID:專案 ID
  • REGION:要建立 VM 的區域

範例

下列範例會使用兩個執行個體選項建立 10 個 VM,這些選項會指定最低 CPU 平台、覆寫預設開機磁碟,並連接額外磁碟:

POST https://compute./compute/v1/projects/my-project/regions/us-central1/instances/bulkInsert
{
  "count": 10,
  "namePattern": "test-bulk-#",
  "instanceProperties": {
    "disks": [
      {
        "boot": true,
        "deviceName": "boot-disk",
        "initializeParams": {
          "sourceImage": "projects/debian-cloud/global/images/family/debian-12"
        }
      }
    ],
    "networkInterfaces": [{}]
  },
  "instanceFlexibilityPolicy": {
    
    "instanceSelections": {
      "selection-1": {
        "machineTypes": [
          "c4-standard-8",
          "c4-highcpu-8"
        ],
        "minCpuPlatform": "Intel Emerald Rapids",
        "disks": [
          {
            "type": "PERSISTENT",
            "deviceName": "boot-disk",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 50,
              "sourceImage": "projects/debian-cloud/global/images/family/debian-12"
            },
            "boot": true
          }
        ]
      },
      "selection-2": {
        "machineTypes": [
          "c3-standard-8"
        ],
        "minCpuPlatform": "Intel Sapphire Rapids",
        "disks": [
          {
            "type": "PERSISTENT",
            "deviceName": "boot-disk",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 50,
              "sourceImage": "projects/debian-cloud/global/images/family/debian-12"
            },
            "boot": true
          },
          {
            "type": "PERSISTENT",
            "deviceName": "data-disk",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 128
            }
          }
        ]
      }
    }
    
  }
}

後續步驟