このページは Cloud Translation API によって翻訳されました。

予約バインドされた使用量で HPC ワークロードの MIG を作成する

このチュートリアルでは、H4D マシンタイプを使用するマネージドインスタンスグループ（MIG）を作成する方法について説明します。MIG は、予約にバインドされたプロビジョニングモデルを使用してコンピューティングリソースを取得します。

MIG を作成すると、複数の仮想マシン（VM）を単一のエンティティとして管理できます。MIG 内の各 VM はインスタンステンプレートに基づいています。MIG はグループ内の VM を自動的に管理することで、高可用性とスケーラビリティを実現します。MIG の詳細については、マネージドインスタンスグループをご覧ください。

HPC VM と HPC クラスタの作成オプションについては、HPC クラスタの作成の概要をご覧ください。

このチュートリアルは、ワークロードを実行するために相互接続された HPC インスタンスのグループを作成することに関心がある HPC エンジニア、プラットフォーム管理者、オペレーター、データと MPI のスペシャリストを対象としています。結果のインスタンスは、インスタンス管理やジョブスケジューリングにオーケストレーターを使用しません。

マネージドインスタンスグループを作成するが、インスタンスの高密度デプロイを作成する必要がない場合は、マネージドインスタンスグループ（MIG）を作成するための基本的なシナリオをご覧ください。

容量の予約

このチュートリアルのコマンドを使用するには、MIG にインスタンスを作成するための容量を予約する必要があります。

容量ブロックの将来の予約を作成する

このアクションを使用すると、選択した特定の日時から始まる定義済みの期間に容量ブロックを予約できます。予約では、クラスタ内の容量のブロックまたはサブブロックが予約されるため、VM インスタンスの高密度デプロイが可能になります。

高密度デプロイの将来の予約を作成するプロセスは次のとおりです。

AI Hypercomputer のドキュメントで、アカウントチームに連絡して容量を予約する手順に沿って操作します。将来の予約リクエストでは、次の例外を除き、ドキュメントに記載されているとおりに情報を指定します。
- マシンタイプ: H4D マシンタイプ h4d-highmem-192-lssd を指定します。
- ゾーン: 使用可能なリージョンとゾーンの表に記載されているように、H4D インスタンスを使用できるゾーンのいずれかを指定します。H4D で使用可能なゾーンのみを表示するには、[マシンシリーズを選択] リストで H4D を選択します。
- メンテナンススケジューリングタイプ: H4D インスタンスの場合は、GROUPED または INDEPENDENT のいずれかを指定できます。
- 予約の運用モード: H4D インスタンスの場合は、値 HIGHLY_AVAILABLE_CAPACITY を指定します。
容量が提供される前に割り当てが自動的に増加します。お客様側でのご対応は必要ありません。
インスタンステンプレートを作成するときに、予約バインドプロビジョニングモデルを指定します。MIG の VM インスタンスは、予約済み容量からプロビジョニングされます。

予約済みリソースを予約期間全体で使用するかどうかに関係なく、予約期間全体に対して料金が発生します。詳細については、予約の課金をご覧ください。

カレンダーモードで将来の予約を作成する

予約した容量を 90 日未満で使用する必要がある場合は、Dynamic Workload Scheduler を使用してカレンダーモードで将来の予約を作成できます。将来の予約リソースを取得するプロセスは次のとおりです。

Google Cloud コンソール、gcloud CLI、または Compute Engine API を使用して、使用可能な容量を検索し、リソースを予約します。
割り当ては課金されず、お客様側での対応は必要ありません。
インスタンステンプレートを作成するときに、予約バインドプロビジョニングモデルを指定します。MIG の VM インスタンスは、予約済み容量からプロビジョニングされます。

予約済みリソースを予約期間全体で使用するかどうかに関係なく、予約期間全体に対して料金が発生します。詳細については、Dynamic Workload Scheduler の料金をご覧ください。

省略可: VPC ネットワークを作成する

無効にすることを選択しない限り、各プロジェクトにはデフォルトネットワークがあります。このネットワークを使用して、インスタンスのネットワーク接続を提供できます。VM を作成するときに、VPC ネットワークとサブネットを指定できます。この構成を省略すると、デフォルトのネットワークとサブネットが使用されます。

H4D インスタンスは、Cloud RDMA を使用するように構成できます。Cloud RDMA は、Compute Engine インスタンス間のリモートダイレクトメモリアクセス（RDMA）をサポートする IRDMA ネットワークドライバを使用して、低レイテンシの信頼性の高いメッセージング機能を有効にします。

このチュートリアルでは、次のことを行います。

Cloud RDMA を使用するように H4D インスタンスを構成する場合は、このセクションの手順を完了します。
Cloud RDMA を使用しない場合は、このセクションをスキップして、代わりにデフォルトネットワークを使用できます。

RDMA 対応インスタンスには、少なくとも 2 つのネットワークインターフェース（NIC）が必要です。

NIC タイプ GVNIC: 通常の VM-VM 間通信と VM-インターネット間通信で TCP/IP とインターネットトラフィックに gve ドライバを使用します。
NIC タイプ IRDMA: インスタンス間の Cloud RDMA ネットワーキングに IDPF/iRDMA ドライバを使用します。

Cloud RDMA を使用するインスタンスには、IRDMA インターフェースを 1 つだけ設定できます。インスタンスごとに最大 8 つの追加の GVNIC ネットワークインターフェースを追加して、合計 10 個の NIC を使用できます。

インスタンスで使用する Falcon VPC ネットワークを設定するには、ドキュメントに記載されている手順に沿って操作するか、提供されているスクリプトを使用します。

手順ガイド

ネットワークを作成するには、次の操作を行います。

GVNIC ネットワークインターフェースのホストネットワークを作成するには、VPC ネットワークの作成と管理をご覧ください。

GVNIC ネットワークインターフェースを 1 つだけ構成する場合は、デフォルトの VPC ネットワークと、インスタンスと同じリージョンにある自動サブネットを使用できます。
IRDMA ネットワークインターフェースのネットワークを作成するには、RDMA ネットワークプロファイルを使用して VPC ネットワークを作成するをご覧ください。RDMA ネットワークの最大伝送単位（MTU）のデフォルト値（8896）を使用します。

スクリプト

インスタンスごとに最大 9 個の GVNIC ネットワークインターフェースと 1 個の IRDMA ネットワークインターフェースを作成できます。各ネットワークインターフェースは、別々のネットワークに接続する必要があります。ネットワークを作成するには、次のスクリプトを使用します。このスクリプトは、GVNIC 用に 2 つのネットワークを作成し、IRDMA 用に 1 つのネットワークを作成します。

省略可: スクリプトを実行する前に、RDMA ネットワークプロファイルを一覧表示して、使用可能なプロファイルがあることを確認します。
```
  gcloud beta compute network-profiles list
  
```

次のコードをコピーして、Linux シェルウィンドウで実行します。

  #!/bin/bash
  # Set the number of GVNIC interfaces to create. You can create up to 9.
  NUM_GVNIC=NUMBER_OF_GVNIC

  # Create standard VPC (networks and subnets) for the GVNIC interfaces
    for N in $(seq 0 $(($NUM_GVNIC - 1))); do
      gcloud compute networks create GVNIC_NAME_PREFIX-net-$N \
          --subnet-mode=custom

      gcloud compute networks subnets create GVNIC_NAME_PREFIX-sub-$N \
          --network=GVNIC_NAME_PREFIX-net-$N \
          --region=REGION \
          --range=10.$N.0.0/16

      gcloud compute firewall-rules create GVNIC_NAME_PREFIX-internal-$N \
          --network=GVNIC_NAME_PREFIX-net-$N \
          --action=ALLOW \
          --rules=tcp:0-65535,udp:0-65535,icmp \
          --source-ranges=10.0.0.0/8
  done

  # Create SSH firewall rules
  gcloud compute firewall-rules create GVNIC_NAME_PREFIX-ssh \
      --network=GVNIC_NAME_PREFIX-net-0 \
      --action=ALLOW \
      --rules=tcp:22 \
      --source-ranges=IP_RANGE

  # Optional: Create a firewall rule for the external IP address for the
  #  first GVNIC network interface
  gcloud compute firewall-rules create GVNIC_NAME_PREFIX-allow-ping-net-0 \
      --network=GVNIC_NAME_PREFIX-net-0 \
      --action=ALLOW \
      --rules=icmp \
      --source-ranges=IP_RANGE

  # Create a network for the RDMA over Falcon network interface
  gcloud beta compute networks create RDMA_NAME_PREFIX-irdma \
      --network-profile=ZONE-vpc-falcon \
      --subnet-mode custom

  # Create a subnet for the RDMA network
  gcloud beta compute networks subnets create RDMA_NAME_PREFIX-irdma-sub \
      --network=RDMA_NAME_PREFIX-irdma \
      --region=REGION \
      --range=10.2.0.0/16  # offset to avoid overlap with GVNIC subnet ranges

次のように置き換えます。

NUMBER_OF_GVNIC: 作成する GVNIC インターフェースの数。1 ～ 9 の数値を指定します。
GVNIC_NAME_PREFIX: GVNIC NIC タイプを使用する標準 VPC ネットワークとサブネットに使用する名前の接頭辞。
REGION: ネットワークを作成するリージョン。これは、RDMA ネットワークの作成時に --network-profile フラグに指定したゾーンに対応している必要があります。たとえば、ゾーンを europe-west4-b として指定すると、リージョンは europe-west4 になります。
IP_RANGE: SSH ファイアウォールルールに使用する VPC ネットワーク外の IP アドレス範囲。すべての IPv4 または IPv6 ソースではなく、アクセスを許可する必要がある特定の IP アドレス範囲を指定することをおすすめします。0.0.0.0/0 または ::/0 をソース範囲として使用しないでください。これにより、 Google Cloudの外部にあるソースを含むすべての IPv4 または IPv6 ソースからのトラフィックが許可されます。
RDMA_NAME_PREFIX: IRDMA NIC タイプを使用する VPC ネットワークとサブネットに使用する名前の接頭辞。
ZONE: ネットワークとコンピューティングインスタンスを作成するゾーン。us-central1-a または europe-west4-b を使用します。

省略可: VPC ネットワークリソースが正常に作成されたことを確認するには、 Google Cloud コンソールでネットワーク設定を確認します。
1. Google Cloud コンソールで、[VPC ネットワーク] ページに移動します。
  [VPC ネットワーク] に移動
2. リストで、前の手順で作成したネットワークを検索します。
3. サブネット、ファイアウォールルール、その他のネットワーク設定を表示するには、ネットワークの名前をクリックします。

省略可: ワークロードポリシーを作成する

Compute Engine で VM インスタンスを単一のブロックまたは隣接するブロックに配置する場合は、ワークロードポリシーを作成してインスタンスの配置を指定します。ただし、Compute Engine でインスタンスを特定のブロックに配置する場合は、この手順をスキップして、インスタンステンプレートの作成時に予約アフィニティでブロックの名前を指定します。

ワークロードポリシーがすでに存在する場合は、再利用できます。ワークロードポリシーを MIG に適用すると、Compute Engine はインスタンスをできるだけ近づけて作成しようとします。アプリケーションがレイテンシの影響を受けやすく、インスタンスを近づけて配置する必要がある（最大近接性）場合は、ワークロードポリシーの作成時に maxTopologyDistance フィールドを指定します。

ワークロードポリシーは、作成後に更新できません。ワークロードポリシーを変更するには、新しいポリシーを作成する必要があります。

ワークロードポリシーを作成するには、次のいずれかのオプションを選択します。

gcloud

ワークロードポリシーを作成するには、 gcloud compute resource-policies create workload-policy コマンドを使用します。

VM のベストエフォート配置を行うには、コマンドで --type=high-throughput フラグのみを指定します。

gcloud compute resource-policies create workload-policy WORKLOAD_POLICY_NAME \
    --type=high-throughput \
    --region=REGION

VM の厳密なコロケーションを行うには、コマンドで --max-topology-distance フラグを指定します。

gcloud compute resource-policies create workload-policy WORKLOAD_POLICY_NAME \
    --type=high-throughput \
    --max-topology-distance=TOPOLOGY_DISTANCE \
    --region=REGION

次のように置き換えます。

WORKLOAD_POLICY_NAME: ワークロードポリシーの名前。
REGION: ワークロードポリシーを作成するリージョン。MIG を作成するリージョンと、使用するマシンタイプを指定します。リージョンとゾーンについては、利用可能なリージョンとゾーンをご覧ください。

REST

ワークロードポリシーを作成するには、resourcePolicies.insert メソッドに POST リクエストを送信します。

VM のベストエフォート配置を行うには、リクエストで type フィールドのみを次のように指定します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies
  {
    "name": "WORKLOAD_POLICY_NAME"
    "workloadPolicy": {
      "type": "HIGH_THROUGHPUT"
    }
  }

VM の厳密なコロケーションを行うには、リクエストで maxTopologyDistance フィールドを次のように指定します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies
  {
    "name": "WORKLOAD_POLICY_NAME"
    "workloadPolicy": {
      "type": "HIGH_THROUGHPUT",
      "maxTopologyDistance": "TOPOLOGY_DISTANCE"
    }
  }

次のように置き換えます。

PROJECT_ID: プロジェクト ID
REGION: ワークロードポリシーを作成するリージョン。MIG を作成するリージョンと、使用するマシンタイプが使用可能なリージョンを指定します。リージョンとゾーンについては、利用可能なリージョンとゾーンをご覧ください。
WORKLOAD_POLICY_NAME: ワークロードポリシーの名前。

インスタンステンプレートの作成

MIG 内の各インスタンスのインスタンスプロパティと消費プロパティを指定するには、次のいずれかの方法でインスタンステンプレートを作成します。

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 ネットワークとサブネットの作成時に使用した名前の接頭辞。

デフォルトネットワークを使用している場合は、nic-type フィールドが GVNIC に設定された 1 つの --network-interface フィールドのみを含めます。また、このネットワークインターフェースの 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 ネットワークインターフェースの VPC ネットワークとサブネットの作成時に使用した名前の接頭辞。

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
```
ヒント: 予約が現在のプロジェクトに存在する場合は、予約値の projects/RESERVATION_OWNER_PROJECT_ID/reservations/ を省略できます。

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 ネットワークとサブネットの作成時に使用した名前の接頭辞。

デフォルトネットワークを使用している場合は、nic-type フィールドが GVNIC に設定された 1 つの --network-interface フィールドのみを含めます。また、このネットワークインターフェースの network と subnetwork の設定は省略します。
EXTERNAL_IPV4_ADDRESS: 省略可。gVNIC ネットワークインターフェースで使用する静的外部 IPv4 アドレス。外部 IPv4 アドレスは予約済みである必要があります。
GVNIC ネットワークインターフェースの外部 IPv6 アドレスを指定するには、代わりに --external-ipv6-address フラグを使用します。
RDMA_NAME_PREFIX: IRDMA ネットワークインターフェースの VPC ネットワークとサブネットの作成時に使用した名前の接頭辞。

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
```
ヒント: 予約が現在のプロジェクトに存在する場合は、予約値の projects/RESERVATION_OWNER_PROJECT_ID/reservations/ を省略できます。

インスタンステンプレートを作成したら、テンプレートを表示して ID を確認し、インスタンスプロパティを確認できます。

MIG を作成する

ワークロードの要件に応じて、次のいずれかの構成で MIG を作成できます。

任意の数の VM で開始できる複数のジョブまたは並列ジョブがある場合は、ターゲットサイズを指定して MIG を作成します。
ジョブの開始に複数の VM が一度に必要な場合や、正確な数の VM インスタンスに分散する必要があるジョブがある場合は、MIG を作成してから、MIG でサイズ変更リクエストを作成します。

ターゲットサイズで MIG を作成する

すべての VM インスタンスを一度に作成せずにジョブを開始できる場合は、ターゲットサイズを指定して MIG を作成します。ターゲットサイズによって、MIG 内のインスタンス数が決まります。MIG は、現在のリソースの可用性に基づいてインスタンスの作成を開始します。リソースが一時的に利用できない場合、MIG はターゲットサイズを満たすインスタンスの作成を継続的に試行します。

目標サイズを指定して MIG を作成するには、次のいずれかのオプションを選択します。

gcloud

指定したターゲットサイズで MIG を作成するには、instance-groups managed create コマンドを使用します。

このステップでは、MIG を作成するコマンドでワークロードポリシーを使用して VM の配置を指定します。ワークロードポリシーを使用しない場合は、--workload-policy フラグを削除します。

ゾーン MIG またはリージョン 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 で VM の作成に使用するインスタンステンプレートの URL。この URL には、インスタンステンプレートの ID または名前を含めることができます。次のいずれかの値を指定します。
- リージョンインスタンステンプレートの場合: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- グローバルインスタンステンプレートの場合: INSTANCE_TEMPLATE_ID
TARGET_SIZE: MIG に含める VM の数。
WORKLOAD_POLICY_URL: 省略可。ワークロードポリシーの URL。ワークロードポリシーを使用しない場合は、--workload-policy フラグを削除できます。
ZONE: MIG を作成するゾーン。ワークロードポリシーを使用する場合は、ポリシーのリージョン内のゾーンを指定します。
REGION: MIG を作成するリージョン。ワークロードポリシーを使用する場合は、ポリシーと同じリージョンを指定します。リージョン MIG の場合は、リージョンの代わりに、--zones フラグを使用してそのリージョンのゾーンを指定できます。

REST

指定したターゲットサイズで MIG を作成するには、次のように POST リクエストを送信します。

このステップでは、MIG を作成するリクエストでワークロードポリシーを使用して VM の配置を指定します。ワークロードポリシーを使用しない場合は、リクエスト本文から resourcePolicies.workloadPolicy フィールドを削除します。

ゾーン MIG またはリージョン 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 で VM の作成に使用するインスタンステンプレートの URL。この URL には、インスタンステンプレートの ID または名前を含めることができます。次のいずれかの値を指定します。
- リージョンインスタンステンプレートの場合: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- グローバルインスタンステンプレートの場合: INSTANCE_TEMPLATE_ID
MIG_NAME: MIG の名前。
TARGET_SIZE: MIG に含める VM の数。
WORKLOAD_POLICY_URL: 省略可。ワークロードポリシーの URL。ワークロードポリシーを使用しない場合は、resourcePolicies.workloadPolicy フィールドを削除できます。

MIG とサイズ変更リクエストを作成する

リクエストされたすべてのインスタンスを同時に作成するには、インスタンスを含まない MIG を作成します。空の MIG を作成したら、MIG でサイズ変更リクエストを作成します。すべてのインスタンスを一度に作成できるリソースが使用可能になると、サイズ変更リクエストによってインスタンスが MIG に追加されます。

MIG とサイズ変更リクエストを作成するには、次のいずれかのオプションを選択します。

gcloud

次のように、ゾーン MIG またはリージョン 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 とそのサイズ変更リクエストを作成するには、次の操作を行います。

次のように、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

次のように、ベータ版の 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 で VM の作成に使用するインスタンステンプレートの URL。この URL には、インスタンステンプレートの ID または名前を含めることができます。次のいずれかの値を指定します。
- リージョンインスタンステンプレートの場合: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- グローバルインスタンステンプレートの場合: INSTANCE_TEMPLATE_ID
WORKLOAD_POLICY_URL: 省略可。ワークロードポリシーの URL。ワークロードポリシーを使用しない場合は、--workload-policy フラグを削除できます。
ZONE: MIG を作成するゾーン。リージョン MIG の場合も、ゾーンを指定する必要があります。このゾーンは、VPC ネットワークのプロファイルを含むゾーンであり、マシンタイプを使用できるゾーンである必要があります。詳細については、制限事項をご覧ください。
RESIZE_REQUEST_NAME: サイズ変更リクエストの名前。指定された MIG 内で一意である必要があります。それ以外の場合、サイズ変更リクエストは作成されません。
POPULATION_METHOD: インスタンスを MIG に追加する方法。次のいずれかを使用します。
- --resize-by=COUNT: 指定された数のインスタンスを MIG に一度に追加します。インスタンス名は自動的に生成されます。
- --instances=INSTANCE_NAME_LIST: 指定された名前のインスタンスを MIG に一度に追加します。INSTANCE_NAME_LIST は、インスタンス名のカンマ区切りリストに置き換えます。指定する名前の数によって、このサイズ変更リクエストで作成するインスタンスの数が決まります。
REGION: MIG が配置されているリージョン。

REST

次のように、ゾーン MIG またはリージョン MIG とサイズ変更リクエストを作成します。

ゾーン MIG とそのサイズ変更リクエストを作成するには、次の操作を行います。

次のように、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
  }
}

次のように、instanceGroupManagerResizeRequests.insert メソッドに POST リクエストを送信して、ゾーン MIG でサイズ変更リクエストを作成します。

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

リージョン MIG とそのサイズ変更リクエストを作成するには、次の操作を行います。

次のように、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
  }
}

次のように、beta.regionInstanceGroupManagerResizeRequests.insert メソッドに POST リクエストを送信して、リージョン MIG にサイズ変更リクエストを作成します。
```
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 の場合も、ゾーンを指定する必要があります。このゾーンは、VPC ネットワークのプロファイルを含むゾーンであり、マシンタイプを使用できるゾーンである必要があります。詳細については、制限事項をご覧ください。
REGION: MIG を作成するリージョン。
INSTANCE_TEMPLATE_URL: MIG で VM の作成に使用するインスタンステンプレートの URL。この URL には、インスタンステンプレートの ID または名前を含めることができます。次のいずれかの値を指定します。
- リージョンインスタンステンプレートの場合: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- グローバルインスタンステンプレートの場合: INSTANCE_TEMPLATE_ID
MIG_NAME: MIG の名前。
WORKLOAD_POLICY_URL: 省略可。ワークロードポリシーの URL。ワークロードポリシーを使用しない場合は、resourcePolicies.workloadPolicy フィールドを削除できます。
RESIZE_REQUEST_NAME: サイズ変更リクエストの名前。指定された MIG 内で一意である必要があります。それ以外の場合、サイズ変更リクエストは作成されません。
POPULATION_METHOD: インスタンスを MIG に追加する方法。次のいずれかを使用します。
- "resizeBy":COUNT: COUNT は、MIG に一度に追加するインスタンスの数に置き換えます。インスタンス名は自動的に生成されます。
- "instanceNames":INSTANCE_NAME_LIST: 指定された名前のインスタンスを MIG に一度に追加します。INSTANCE_NAME_LIST は、インスタンス名のカンマ区切りリストに置き換えます。指定する名前の数によって、このサイズ変更リクエストで作成するインスタンスの数が決まります。

予約バインドされた使用量で HPC ワークロードの MIG を作成する

容量の予約

容量ブロックの将来の予約を作成する

カレンダー モードで将来の予約を作成する

省略可: VPC ネットワークを作成する

手順ガイド

スクリプト

省略可: ワークロード ポリシーを作成する

gcloud

REST

インスタンス テンプレートの作成

gcloud

REST

MIG を作成する

ターゲット サイズで MIG を作成する

gcloud

REST

MIG とサイズ変更リクエストを作成する

gcloud

REST

カレンダーモードで将来の予約を作成する

省略可: ワークロードポリシーを作成する

インスタンステンプレートの作成

ターゲットサイズで MIG を作成する