批量创建 AI 优化型 A3 High 或 A3 Mega 虚拟机

本文档介绍了如何批量创建使用 A3 High 或 A3 Mega 加速器优化机器类型的虚拟机 (VM) 实例。如需详细了解这些机器类型,请参阅 Compute Engine 文档中的 A3 HighA3 Mega

如需详细了解如何批量创建虚拟机,请参阅 Compute Engine 文档中的虚拟机批量创建简介

如需了解创建虚拟机或集群的其他方式,请参阅概览页面。

准备工作

在批量创建虚拟机之前,如果您尚未完成以下步骤,请先完成这些步骤:

  1. 选择使用选项:您选择的使用选项决定了您获取和使用 GPU 资源的方式。如需了解详情,请参阅选择使用选项
  2. 获取容量:每种使用选项的容量获取流程各不相同。如需了解所选使用选项的容量获取流程,请参阅容量概览

选择标签页以了解您打算如何使用本页面上的示例:

控制台

当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时,无需设置身份验证。

gcloud

安装 Google Cloud CLI,然后 使用联合身份登录 gcloud CLI。 登录后,运行以下命令来初始化 Google Cloud CLI:

gcloud init

REST

如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭证。

    安装 Google Cloud CLI,然后 使用联合身份登录 gcloud CLI

如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证

所需的角色

如需获得批量创建虚拟机所需的权限,请让您的管理员为您授予项目的 Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

此预定义角色包含批量创建虚拟机所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

批量创建虚拟机需要以下权限:

  • 针对项目的 compute.instances.create 权限
  • 使用自定义映像创建虚拟机:针对映像的 compute.images.useReadOnly 权限
  • 使用快照创建虚拟机:针对快照的 compute.snapshots.useReadOnly 权限
  • 使用实例模板创建虚拟机:针对实例模板的 compute.instanceTemplates.useReadOnly 权限
  • 为虚拟机指定子网:针对项目或所选子网的 compute.subnetworks.use 权限
  • 为虚拟机指定静态 IP 地址:针对项目的 compute.addresses.use 权限
  • 在使用 VPC 网络时为虚拟机分配外部 IP 地址:针对项目或所选子网的 compute.subnetworks.useExternalIp 权限
  • 为虚拟机分配旧版网络:针对项目的 compute.networks.use 权限
  • 使用旧版网络时为虚拟机分配外部 IP 地址:针对项目的 compute.networks.useExternalIp 权限
  • 为虚拟机设置虚拟机实例元数据:针对项目的 compute.instances.setMetadata 权限
  • 为虚拟机设置标记:针对虚拟机的 compute.instances.setTags 权限
  • 为虚拟机设置标签:针对虚拟机的 compute.instances.setLabels 权限
  • 为虚拟机设置要使用的服务账号:针对虚拟机的 compute.instances.setServiceAccount 权限
  • 为虚拟机创建新磁盘:针对项目的 compute.disks.create 权限
  • 以只读或读写模式挂接现有磁盘:针对磁盘的 compute.disks.use 权限
  • 以只读模式挂接现有磁盘:针对磁盘的 compute.disks.useReadOnly 权限

您也可以使用自定义角色或其他预定义角色来获取这些权限。

概览

使用 a3h 或 a3m 机器类型批量创建实例包括以下步骤:

  1. 创建 VPC 网络
  2. 可选: 创建紧凑布置政策
  3. 批量创建实例

创建 VPC 网络

如需为 GPU 虚拟机启用高效通信,您需要创建一个管理网络和一个或多个数据网络。管理网络用于外部访问(例如 SSH)和最通用的网络通信。数据网络用于不同虚拟机上 GPU 之间的高性能通信,例如远程直接内存访问 (RDMA) 流量。

对于这些 VPC 网络,我们建议将最大传输单元 (MTU) 设置为更大的值。较高的 MTU 值会增加数据包大小并降低数据包标头开销,从而增加载荷数据吞吐量。 如需详细了解如何创建 VPC 网络,请参阅创建和验证巨型帧 MTU 网络

创建管理网络、子网和防火墙规则

完成以下步骤以设置管理网络:

  1. 使用 networks create 命令创建管理网络:

    gcloud compute networks create NETWORK_NAME_PREFIX-mgmt-net \
        --project=PROJECT_ID \
        --subnet-mode=custom \
        --mtu=8244
    
  2. 使用 networks subnets create 命令创建管理子网:

    gcloud compute networks subnets create NETWORK_NAME_PREFIX-mgmt-sub \
        --project=PROJECT_ID \
        --network=NETWORK_NAME_PREFIX-mgmt-net \
        --region=REGION \
        --range=192.168.0.0/24
    
  3. 使用 firewall-rules create 命令创建防火墙规则。

    1. 为管理网络创建防火墙规则。

      gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-internal \
          --project=PROJECT_ID \
          --network=NETWORK_NAME_PREFIX-mgmt-net \
          --action=ALLOW \
          --rules=tcp:0-65535,udp:0-65535,icmp \
          --source-ranges=192.168.0.0/16
      
    2. 创建 tcp:22 防火墙规则,以限制哪些来源 IP 地址可以使用 SSH 连接到您的虚拟机。

      gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ssh \
          --project=PROJECT_ID \
          --network=NETWORK_NAME_PREFIX-mgmt-net \
          --action=ALLOW \
          --rules=tcp:22 \
          --source-ranges=SSH_SOURCE_IP_RANGE
      
    3. 创建可用于检查网络中数据传输问题的 icmp 防火墙规则。

      gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ping \
          --project=PROJECT_ID \
          --network=NETWORK_NAME_PREFIX-mgmt-net \
          --action=ALLOW \
          --rules=icmp \
          --source-ranges=0.0.0.0/0
      

替换以下内容:

  • NETWORK_NAME_PREFIX:用于 VPC 网络和子网的名称前缀。
  • PROJECT_ID:您的项目 ID。
  • REGION:要在其中创建网络的区域。
  • SSH_SOURCE_IP_RANGE:采用 CIDR 格式的 IP 范围。 用于指定哪些来源 IP 地址可以使用 SSH 连接到虚拟机。

创建数据网络、子网和防火墙规则

数据网络的数量因您要创建的 GPU 机器类型而异。

A3 Mega

A3 Mega 需要 8 个数据网络。如需创建 8 个数据网络,每个网络都包含子网和防火墙规则,请使用以下命令。

for N in $(seq 1 8); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
    --project=PROJECT_ID \
    --subnet-mode=custom \
    --mtu=8244

gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --region=REGION \
    --range=192.168.$N.0/24

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=192.168.0.0/16
done

A3 High

A3 High 需要四个数据网络。使用以下命令创建 4 个数据网络,每个网络都包含子网和防火墙规则。

for N in $(seq 1 4); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
    --project=PROJECT_ID \
    --subnet-mode=custom \
    --mtu=8244

gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --region=REGION \
    --range=192.168.$N.0/24

gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
    --project=PROJECT_ID \
    --network=NETWORK_NAME_PREFIX-data-net-$N \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=192.168.0.0/16
done

可选:创建紧凑布置政策

您可以通过创建紧凑布置政策来指定虚拟机布置。当您将紧凑布置政策应用于虚拟机时,Compute Engine 会尽最大努力创建尽可能彼此靠近的虚拟机。如果您的应用对延迟时间敏感,并且需要紧凑性最大,请在创建紧凑布置政策时指定 maxDistance 字段(预览版)。maxDistance 值越低,虚拟机布置得越靠近,但无法创建某些虚拟机的可能性也会增加。

如需创建紧凑布置政策,请选择以下选项之一:

gcloud

如需创建紧凑布置政策,请使用 gcloud beta compute resource-policies create group-placement 命令

gcloud beta compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --max-distance=MAX_DISTANCE \
    --region=REGION

替换以下内容:

  • POLICY_NAME:紧凑布置政策的名称。
  • MAX_DISTANCE:虚拟机的最大距离配置。该值必须为 3(用于将虚拟机布置在相邻的块中)或 2(用于将虚拟机布置在同一块中)。如需了解每种机器系列支持的每个maxDistance的虚拟机数量上限,请参阅 Compute Engine 文档中的紧凑布置政策简介
  • REGION:要用于创建紧凑布置政策的区域。 指定提供您要使用的机器类型的区域。 如需了解区域,请参阅按区域和可用区划分的 GPU 可用性

REST

如需创建紧凑布置政策,请向 Beta 版 resourcePolicies.insert 方法发出 POST 请求。 在请求正文中,添加设置为 COLLOCATEDcollocation 字段和 maxDistance 字段。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
  {
    "name": "POLICY_NAME",
    "groupPlacementPolicy": {
      "collocation": "COLLOCATED",
      "maxDistance": MAX_DISTANCE
    }
  }

替换以下内容:

  • PROJECT_ID:您的项目 ID。
  • POLICY_NAME:紧凑布置政策的名称。
  • MAX_DISTANCE:虚拟机的最大距离配置。该值必须为 3(用于将虚拟机布置在相邻的块中)或 2(用于将虚拟机布置在同一块中)。如需了解每种机器系列支持的每个maxDistance的虚拟机数量上限,请参阅 Compute Engine 文档中的紧凑布置政策简介
  • REGION:要用于创建紧凑布置政策的区域。 指定提供您要使用的机器类型的区域。 如需了解区域,请参阅按区域和可用区划分的 GPU 可用性

批量创建 A3 High 或 A3 Mega 虚拟机

如需批量创建 A3 High 或 A3 Mega 虚拟机,请使用以下方法之一。

以下命令还会设置实例的访问权限范围。为简化权限管理,Google 建议您将实例的访问权限范围设置为 cloud-platform 访问权限,然后使用 IAM 角色定义实例可以访问哪些服务。如需了解详情,请参阅范围最佳实践

gcloud

如需创建 A3 High 或 A3 Mega 虚拟机,请使用 gcloud compute instances bulk create 命令

A3 Mega

如需批量创建 a3h 或 a3m 实例,请使用 gcloud compute instances bulk create 命令

您需要指定的参数取决于您为此部署使用的使用选项。选择与您的使用选项的配置模式对应的标签页。

受预留约束

在运行该命令之前,您可以选择添加紧凑布置政策的标志。

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --count=COUNT \
     --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --region=REGION \
    --boot-disk-type=DISK_TYPE \
    --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 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address 
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --restart-on-failure

请完成以下步骤:

  1. 替换以下内容:

    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:要用于 a3h-or-a3m 实例的机器类型。请指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • IMAGE_FAMILY:您要使用的操作系统映像的映像系列。 对于 A3 Mega 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像并停用自动更新,或者使用 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud;对于 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像,请使用 rocky-linux-accelerator-cloud
    • REGION:指定提供您要使用的机器类型的区域。 如果您要指定紧凑布置政策,则必须使用与紧凑布置政策相同的区域。 如需了解区域,请参阅各区域和可用区的 GPU 可用性
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • RESERVATION:预留名称或预留中的特定块。如需获取预留名称或可用块,请参阅查看预留容量。根据您对实例布置的要求,请按以下方式之一操作:
      • 跨块或在单个块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

        此外,对于单个块,请应用指定了块共置 (maxDistance=2) 的紧凑布置政策。 然后,Compute Engine 会将该政策应用于预留,并在同一块上创建实例。

      • 在特定块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
    • TERMINATION_ACTION:指示在预留期结束时,Compute Engine 是关停 (STOP) 还是删除 (DELETE) a3h 或 a3m 实例。

  2. 可选:如果您选择使用紧凑布置政策,请向命令添加以下标志:

      --resource-policies=POLICY_NAME
    

    替换以下内容:

    • POLICY_NAME:紧凑布置政策的名称。
  3. 运行以上命令。

Spot

在运行该命令之前,您可以选择添加紧凑布置政策的标志。

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --count=COUNT \
     --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --region=REGION \
    --boot-disk-type=DISK_TYPE \
    --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 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address 
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
    --provisioning-model=SPOT \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --no-restart-on-failure

请完成以下步骤:

  1. 替换以下内容:

    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:要用于 a3h-or-a3m 实例的机器类型。请指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • IMAGE_FAMILY:您要使用的操作系统映像的映像系列。 对于 A3 Mega 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像并停用自动更新,或者使用 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud;对于 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像,请使用 rocky-linux-accelerator-cloud
    • REGION:指定提供您要使用的机器类型的区域。 如果您要指定紧凑布置政策,则必须使用与紧凑布置政策相同的区域。 如需了解区域,请参阅各区域和可用区的 GPU 可用性
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • TERMINATION_ACTION:当 Compute Engine 抢占实例时执行的操作(STOP [默认] 或 DELETE)。

  2. 可选:如果您选择使用紧凑布置政策,请向命令添加以下标志:

      --resource-policies=POLICY_NAME
    

    替换以下内容:

    • POLICY_NAME:紧凑布置政策的名称。
  3. 运行以上命令。

A3 High

如需批量创建 a3h 或 a3m 实例,请使用 gcloud compute instances bulk create 命令

您需要指定的参数取决于您为此部署使用的使用选项。选择与您的使用选项的配置模式对应的标签页。

受预留约束

在运行该命令之前,您可以选择添加紧凑布置政策的标志。

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --count=COUNT \
     --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --region=REGION \
    --boot-disk-type=DISK_TYPE \
    --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 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address 
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --restart-on-failure

请完成以下步骤:

  1. 替换以下内容:

    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:要用于 a3h-or-a3m 实例的机器类型。请指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • IMAGE_FAMILY:您要使用的操作系统映像所属的映像系列。 对于 A3 High 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像,并停用自动更新。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud
    • REGION:指定提供您要使用的机器类型的区域。 如果您要指定紧凑布置政策,则必须使用与紧凑布置政策相同的区域。 如需了解区域,请参阅各区域和可用区的 GPU 可用性
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • RESERVATION:预留名称或预留中的特定块。如需获取预留名称或可用块,请参阅查看预留容量。根据您对实例布置的要求,请按以下方式之一操作:
      • 跨块或在单个块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

        此外,对于单个块,请应用指定了块共置 (maxDistance=2) 的紧凑布置政策。 然后,Compute Engine 会将该政策应用于预留,并在同一块上创建实例。

      • 在特定块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
    • TERMINATION_ACTION:指示在预留期结束时,Compute Engine 是关停 (STOP) 还是删除 (DELETE) a3h 或 a3m 实例。

  2. 可选:如果您选择使用紧凑布置政策,请向命令添加以下标志:

      --resource-policies=POLICY_NAME
    

    替换以下内容:

    • POLICY_NAME:紧凑布置政策的名称。
  3. 运行以上命令。

Spot

在运行该命令之前,您可以选择添加紧凑布置政策的标志。

gcloud compute instances bulk create \
    --name-pattern=NAME_PATTERN \
    --count=COUNT \
     --machine-type=MACHINE_TYPE \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --region=REGION \
    --boot-disk-type=DISK_TYPE \
    --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 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address 
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
    --provisioning-model=SPOT \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --no-restart-on-failure

请完成以下步骤:

  1. 替换以下内容:

    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:要用于 a3h-or-a3m 实例的机器类型。请指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • IMAGE_FAMILY:您要使用的操作系统映像所属的映像系列。 对于 A3 High 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像,并停用自动更新。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud
    • REGION:指定提供您要使用的机器类型的区域。 如果您要指定紧凑布置政策,则必须使用与紧凑布置政策相同的区域。 如需了解区域,请参阅各区域和可用区的 GPU 可用性
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • TERMINATION_ACTION:当 Compute Engine 抢占实例时执行的操作(STOP [默认] 或 DELETE)。

  2. 可选:如果您选择使用紧凑布置政策,请向命令添加以下标志:

      --resource-policies=POLICY_NAME
    

    替换以下内容:

    • POLICY_NAME:紧凑布置政策的名称。
  3. 运行以上命令。

REST

如需创建 A3 High 或 A3 Mega 虚拟机,请使用 instances.bulkInsert 方法

A3 Mega

如需批量创建 a3h 或 a3m 实例,请向 instances.bulkInsert 方法发出 POST 请求。

您需要指定的参数取决于您为此部署使用的使用选项。选择与您的使用选项的配置模式对应的标签页。

受预留约束

在提交请求之前,您可以选择向请求正文添加 instanceProperties 子字段,以指定紧凑布置政策

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
  "namePattern":"NAME_PATTERN",
  "count":"COUNT",
  "instanceProperties":{
    "machineType":"MACHINE_TYPE",
    "disks":[
      {
        "boot":true,
        "initializeParams":{
          "diskSizeGb":"DISK_SIZE",
          "diskType":"DISK_TYPE",
          "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "mode":"READ_WRITE",
        "type":"PERSISTENT"
      }
    ],
    "serviceAccounts": [
      {
        "email": "default",
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      }
    ],
    "networkInterfaces": [
      {
        "accessConfigs": [
          {
            "name": "external-nat",
            "type": "ONE_TO_ONE_NAT"
          }
        ],
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
      },
    "reservationAffinity":{
        "consumeReservationType":"SPECIFIC_RESERVATION",
        "key":"compute.googleapis.com/reservation-name",
        "values":[
          "RESERVATION"
        ]
      },
    "scheduling":{
        "provisioningModel":"RESERVATION_BOUND",
        "instanceTerminationAction":"DELETE",
        "onHostMaintenance": "TERMINATE",
        "automaticRestart":true
      }
  }
}

请完成以下步骤:

  1. 替换以下内容:

    • PROJECT_ID:您要在其中创建 A3H 或 A3M 实例的项目的 ID。
    • ZONE:指定提供您要使用的机器类型的可用区。 如果您想指定紧凑布置政策,则必须使用与紧凑布置政策位于同一区域的可用区。 如需了解区域,请参阅按区域和可用区划分的 GPU 可用性
    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:用于 a3h 或 a3m 实例的机器类型。指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • VM_NAME:虚拟机的名称。
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud;对于 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像,请使用 rocky-linux-accelerator-cloud
    • IMAGE_FAMILY:您要使用的操作系统映像的映像系列。 对于 A3 Mega 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像并停用自动更新,或者使用 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • NETWORK_PROJECT_ID:网络的项目 ID。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • REGION:子网所在的区域。
    • RESERVATION:预留名称或预留中的特定块。如需获取预留名称或可用块,请参阅查看预留容量。根据您对实例布置的要求,请按以下方式之一操作:
      • 跨块或在单个块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

        此外,对于单个块,请应用指定了块共置 (maxDistance=2) 的紧凑布置政策。 然后,Compute Engine 会将该政策应用于预留,并在同一块上创建实例。

      • 在特定块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
    • TERMINATION_ACTION:指示在预留期结束时,Compute Engine 是关停 (STOP) 还是删除 (DELETE) a3h 或 a3m 实例。

  2. 可选:如果您选择使用紧凑布置政策,请将以下 instanceProperties 子字段添加到请求正文中:

        "resourcePolicies": [
          "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
        ]
    

    替换以下内容:

    • PROJECT_ID:紧凑布置政策的项目 ID。
    • REGION:紧凑布置政策所在的区域。
    • POLICY_NAME:紧凑布置政策的名称。
  3. 提交请求。

Spot

在提交请求之前,您可以选择向请求正文添加 instanceProperties 子字段,以指定紧凑布置政策

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
  "namePattern":"NAME_PATTERN",
  "count":"COUNT",
  "instanceProperties":{
    "machineType":"MACHINE_TYPE",
    "disks":[
      {
        "boot":true,
        "initializeParams":{
          "diskSizeGb":"DISK_SIZE",
          "diskType":"DISK_TYPE",
          "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "mode":"READ_WRITE",
        "type":"PERSISTENT"
      }
    ],
    "serviceAccounts": [
      {
        "email": "default",
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      }
    ],
    "networkInterfaces": [
      {
        "accessConfigs": [
          {
            "name": "external-nat",
            "type": "ONE_TO_ONE_NAT"
          }
        ],
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
      },
    "scheduling":
    {
      "provisioningModel": "SPOT",
      "instanceTerminationAction": "TERMINATION_ACTION",
      "onHostMaintenance": "TERMINATE",
      "automaticRestart": false
    }
  }
}

请完成以下步骤:

  1. 替换以下内容:

    • PROJECT_ID:您要在其中创建 A3H 或 A3M 实例的项目的 ID。
    • ZONE:指定提供您要使用的机器类型的可用区。 如果您想指定紧凑布置政策,则必须使用与紧凑布置政策位于同一区域的可用区。 如需了解区域,请参阅按区域和可用区划分的 GPU 可用性
    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:用于 a3h 或 a3m 实例的机器类型。指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • VM_NAME:虚拟机的名称。
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud;对于 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像,请使用 rocky-linux-accelerator-cloud
    • IMAGE_FAMILY:您要使用的操作系统映像的映像系列。 对于 A3 Mega 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像并停用自动更新,或者使用 rocky-linux-8-optimized-gcp-nvidia-580 Rocky Linux 映像。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • NETWORK_PROJECT_ID:网络的项目 ID。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • REGION:子网所在的区域。
    • TERMINATION_ACTION:当 Compute Engine 抢占实例时执行的操作(STOP [默认] 或 DELETE)。

  2. 可选:如果您选择使用紧凑布置政策,请将以下 instanceProperties 子字段添加到请求正文中:

        "resourcePolicies": [
          "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
        ]
    

    替换以下内容:

    • PROJECT_ID:紧凑布置政策的项目 ID。
    • REGION:紧凑布置政策所在的区域。
    • POLICY_NAME:紧凑布置政策的名称。
  3. 提交请求。

A3 High

如需批量创建 a3h 或 a3m 实例,请向 instances.bulkInsert 方法发出 POST 请求。

您需要指定的参数取决于您为此部署使用的使用选项。选择与您的使用选项的配置模式对应的标签页。

受预留约束

在提交请求之前,您可以选择向请求正文添加 instanceProperties 子字段,以指定紧凑布置政策

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
  "namePattern":"NAME_PATTERN",
  "count":"COUNT",
  "instanceProperties":{
    "machineType":"MACHINE_TYPE",
    "disks":[
      {
        "boot":true,
        "initializeParams":{
          "diskSizeGb":"DISK_SIZE",
          "diskType":"DISK_TYPE",
          "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "mode":"READ_WRITE",
        "type":"PERSISTENT"
      }
    ],
    "serviceAccounts": [
      {
        "email": "default",
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      }
    ],
    "networkInterfaces": [
      {
        "accessConfigs": [
          {
            "name": "external-nat",
            "type": "ONE_TO_ONE_NAT"
          }
        ],
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
      },
    "reservationAffinity":{
        "consumeReservationType":"SPECIFIC_RESERVATION",
        "key":"compute.googleapis.com/reservation-name",
        "values":[
          "RESERVATION"
        ]
      },
    "scheduling":{
        "provisioningModel":"RESERVATION_BOUND",
        "instanceTerminationAction":"DELETE",
        "onHostMaintenance": "TERMINATE",
        "automaticRestart":true
      }
  }
}

请完成以下步骤:

  1. 替换以下内容:

    • PROJECT_ID:您要在其中创建 A3H 或 A3M 实例的项目的 ID。
    • ZONE:指定提供您要使用的机器类型的可用区。 如果您想指定紧凑布置政策,则必须使用与紧凑布置政策位于同一区域的可用区。 如需了解区域,请参阅按区域和可用区划分的 GPU 可用性
    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:用于 a3h 或 a3m 实例的机器类型。指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • VM_NAME:虚拟机的名称。
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud
    • IMAGE_FAMILY:您要使用的操作系统映像所属的映像系列。 对于 A3 High 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像,并停用自动更新。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • NETWORK_PROJECT_ID:网络的项目 ID。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • REGION:子网所在的区域。
    • RESERVATION:预留名称或预留中的特定块。如需获取预留名称或可用块,请参阅查看预留容量。根据您对实例布置的要求,请按以下方式之一操作:
      • 跨块或在单个块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME

        此外,对于单个块,请应用指定了块共置 (maxDistance=2) 的紧凑布置政策。 然后,Compute Engine 会将该政策应用于预留,并在同一块上创建实例。

      • 在特定块上创建实例:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
    • TERMINATION_ACTION:指示在预留期结束时,Compute Engine 是关停 (STOP) 还是删除 (DELETE) a3h 或 a3m 实例。

  2. 可选:如果您选择使用紧凑布置政策,请将以下 instanceProperties 子字段添加到请求正文中:

        "resourcePolicies": [
          "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
        ]
    

    替换以下内容:

    • PROJECT_ID:紧凑布置政策的项目 ID。
    • REGION:紧凑布置政策所在的区域。
    • POLICY_NAME:紧凑布置政策的名称。
  3. 提交请求。

Spot

在提交请求之前,您可以选择向请求正文添加 instanceProperties 子字段,以指定紧凑布置政策

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
{
  "namePattern":"NAME_PATTERN",
  "count":"COUNT",
  "instanceProperties":{
    "machineType":"MACHINE_TYPE",
    "disks":[
      {
        "boot":true,
        "initializeParams":{
          "diskSizeGb":"DISK_SIZE",
          "diskType":"DISK_TYPE",
          "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "mode":"READ_WRITE",
        "type":"PERSISTENT"
      }
    ],
    "serviceAccounts": [
      {
        "email": "default",
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      }
    ],
    "networkInterfaces": [
      {
        "accessConfigs": [
          {
            "name": "external-nat",
            "type": "ONE_TO_ONE_NAT"
          }
        ],
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
      },
      {
        "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
        "nicType": "GVNIC",
        "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
      },
    "scheduling":
    {
      "provisioningModel": "SPOT",
      "instanceTerminationAction": "TERMINATION_ACTION",
      "onHostMaintenance": "TERMINATE",
      "automaticRestart": false
    }
  }
}

请完成以下步骤:

  1. 替换以下内容:

    • PROJECT_ID:您要在其中创建 A3H 或 A3M 实例的项目的 ID。
    • ZONE:指定提供您要使用的机器类型的可用区。 如果您想指定紧凑布置政策,则必须使用与紧凑布置政策位于同一区域的可用区。 如需了解区域,请参阅按区域和可用区划分的 GPU 可用性
    • NAME_PATTERN:要用于 a3h 或 a3m 实例的名称格式。 例如,将 instance-# 用于名称模式会生成名称为 instance-1instance-2 等依次递增的 a3h 或 a3m 实例,数量最多为 --count 指定的 a3h 或 a3m 实例数量。
    • COUNT:要创建的 a3h 或 a3m 实例的数量。
    • MACHINE_TYPE:用于 a3h 或 a3m 实例的机器类型。指定 A4 或 A3 Ultra 机器类型。如需了解详情,请参阅 GPU 机器类型
    • VM_NAME:虚拟机的名称。
    • DISK_SIZE:启动磁盘的大小(以 GB 为单位)。
    • DISK_TYPE:启动磁盘的类型。我们建议您使用 hyperdisk-balanced
    • IMAGE_PROJECT:操作系统映像的项目 ID。 例如,对于 cos-121-lts 或更高版本的 Container-Optimized OS 映像,请使用 cos-cloud
    • IMAGE_FAMILY:您要使用的操作系统映像所属的映像系列。 对于 A3 High 机器系列,我们强烈建议您使用 cos-121-lts 或更高版本的 Container-Optimized OS 映像,并停用自动更新。 如需查看受支持的操作系统的列表,请参阅受支持的操作系统
    • NETWORK_PROJECT_ID:网络的项目 ID。
    • GVNIC_NAME_PREFIX:您在创建使用 gVNIC NIC 的标准 VPC 网络和子网时指定的名称前缀。
    • REGION:子网所在的区域。
    • TERMINATION_ACTION:当 Compute Engine 抢占实例时执行的操作(STOP [默认] 或 DELETE)。

  2. 可选:如果您选择使用紧凑布置政策,请将以下 instanceProperties 子字段添加到请求正文中:

        "resourcePolicies": [
          "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
        ]
    

    替换以下内容:

    • PROJECT_ID:紧凑布置政策的项目 ID。
    • REGION:紧凑布置政策所在的区域。
    • POLICY_NAME:紧凑布置政策的名称。
  3. 提交请求。

如需详细了解批量创建虚拟机时的配置选项,请参阅 Compute Engine 文档中的批量创建虚拟机

后续步骤