インスタンスの柔軟性を使用して VM を一括作成する

このドキュメントでは、仮想マシン（VM）を一括で作成するときにインスタンスの柔軟性を指定する方法について説明します。この仕様を行う場合は、VM に適したマシンタイプのリストを指定します。Compute Engine は、リージョンの容量と割り当ての可用性に基づいて、指定されたマシンタイプのいずれかを使用して VM をプロビジョニングします。

一括作成された VM のインスタンスの柔軟性については、一括作成された VM のインスタンスの柔軟性についてをご覧ください。

始める前に

作成する予定の VM と関連リソースについては、十分な割り当てと必要な権限があることを確認してください。
まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
gcloud
1. Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
  gcloud init
  外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
  
  注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
2. Set a default region and zone.
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

VM の一括作成に必要な権限を取得するには、プロジェクトに対する Compute インスタンス管理者（v1）（roles/compute.instanceAdmin.v1）の IAM ロールを付与するよう管理者に依頼します。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、VM の一括作成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

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
VPC ネットワークの使用時に VM に外部 IP アドレスを割り当てる: プロジェクトまたは選択したサブネットに対する compute.subnetworks.useExternalIp
VM にレガシーネットワークを割り当てる: プロジェクトに対する compute.networks.use
レガシーネットワークを使用する際に VM に外部 IP アドレスを割り当てる: プロジェクトに対する compute.networks.useExternalIp
VM の VM インスタンスメタデータを設定する: プロジェクトに対する compute.instances.setMetadata
VM にタグを設定する: VM に対する compute.instances.setTags
VM にラベルを設定する: VM に対する compute.instances.setLabels
VM が使用するサービスアカウントを設定する: VM に対する compute.instances.setServiceAccount
VM 用の新しいディスクを作成する: プロジェクトに対する compute.disks.create
既存のディスクを読み取り専用モードまたは読み取り / 書き込みモードでアタッチする: ディスクに対する compute.disks.use
既存のディスクを読み取り専用モードでアタッチする: ディスクに対する compute.disks.useReadOnly

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

同じ優先度の複数のマシンタイプを使用して VM を作成する

ワークロードが複数の異なるマシンタイプで動作できる場合は、互換性のあるすべてのマシンタイプのリストを 1 つのインスタンス選択で指定できます。次の例は、優先度が同じ複数のマシンタイプを指定する方法を示しています。

gcloud

単一のインスタンス選択で VM を一括作成するには、--instance-selection-machine-types フラグを指定して gcloud compute instances bulk create コマンドを使用します。

gcloud compute instances bulk create \
    --name-pattern=test-bulk-# \
    --region=REGION \
    --count=COUNT \
    --instance-selection-machine-types=c3-standard-8,n2-standard-8,c2-standard-8

REST

Compute Engine API で、regionInstances.bulkInsert メソッドに POST リクエストを送信します。リクエストの本文に、マシンタイプを一覧表示する 1 つの instanceSelections エントリを含む instanceFlexibilityPolicy を含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert
{
  "count": COUNT,
  "namePattern": "test-bulk-#",
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "selection-1": {
        "machineTypes": [
          "c3-standard-8",
          "n2-standard-8",
          "c2-standard-8"
        ]
      }
    }
  }
}

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

COUNT: 作成する VM の数。
PROJECT_ID: プロジェクト ID。
REGION: VM を作成するリージョン。

優先度でランク付けされた複数のマシンタイプを使用して VM を作成する

Compute Engine でマシンタイプを特定の順序で選択する場合は、複数のインスタンス選択を構成できます。各インスタンス選択には、マシンタイプのリストとランクが含まれます。ランクは、マシンタイプの優先度を定義する整数です。ランクが低いほど、優先度が高くなります。Compute Engine は、優先度の高い（ランクの低い）マシンタイプを使用して VM の作成を試みます。これらのマシンタイプを使用できない場合、Compute Engine は優先度の低い（ランクの高い）マシンタイプを使用します。

次の例は、ランクを使用して複数のインスタンス選択を指定する方法を示しています。

gcloud

複数のインスタンス選択を使用して VM を一括作成するには、gcloud compute instances bulk create コマンドを使用し、--instance-selection フラグを複数回指定します。

gcloud beta compute instances bulk create \
    --name-pattern=test-bulk-# \
    --region=REGION \
    --count=COUNT \
    --instance-selection "name=most-preferred,rank=0,machine-type=c3-standard-16,machine-type=n2-standard-16, machine-type=c2-standard-16" \
    --instance-selection "name=least-preferred,rank=1,machine-type=c3-standard-8,machine-type=n2-standard-8, machine-type=c2-standard-8"

REST

Compute Engine API で、regionInstances.bulkInsert メソッドに POST リクエストを送信します。リクエストの本文に instanceFlexibilityPolicy を含め、instanceSelections に複数のエントリを指定します。各エントリには、マシンタイプのリストと rank を指定します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert
{
  "count": COUNT,
  "namePattern": "test-bulk-#",
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "most-preferred": {
        "machineTypes": [
          "c3-standard-16",
          "c2-standard-16"
        ],
        "rank": 1
      },
      "least-preferred": {
        "machineTypes": [
          "n2-standard-16",
          "c3-standard-8",
          "n2-standard-8",
          "c2-standard-8"
        ],
        "rank": 2
      }
    }
  }
}

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

COUNT: 作成する VM の数。
PROJECT_ID: プロジェクト ID。
REGION: VM を作成するリージョン。

インスタンスの選択でディスクのオーバーライドを指定する

デフォルトでは、一括リクエストで作成された VM は instanceProperties のディスク構成を使用します。ただし、インスタンス選択内でディスク構成を指定できます。インスタンス選択でディスクを指定すると、そのディスク構成は、そのインスタンス選択を使用する VM の instanceProperties のディスク構成をオーバーライドします。

次の例は、インスタンス選択でディスクを指定する方法を示しています。

REST

Compute Engine API で、regionInstances.bulkInsert メソッドに POST リクエストを送信します。リクエストの本文に instanceFlexibilityPolicy を含め、instanceSelections エントリごとに disks フィールドを含めて instanceProperties.disks をオーバーライドします。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert
{
  "count": COUNT,
  "namePattern": "test-bulk-#",
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "selection-1": {
        "machineTypes": [
          "n2-standard-8",
          "c2-standard-8"
        ],
        "disks": [
          {
            "type": "PERSISTENT",
            "initializeParams": {
              "diskType": "pd-ssd",
              "diskSizeGb": 50,
              "sourceImage": "IMAGE_URL"
            },
            "boot": true
          },
          {
            "type": "SCRATCH",
            "initializeParams": {
              "diskType": "local-ssd"
            }
          }
        ]
      },
      "selection-2": {
        "machineTypes": [
          "c3-standard-8"
        ],
        "disks": [
          {
            "type": "PERSISTENT",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 50,
              "sourceImage": "IMAGE_URL"
            },
            "boot": true
          },
          {
            "type": "PERSISTENT",
            "initializeParams": {
              "diskType": "hyperdisk-balanced",
              "diskSizeGb": 128,
              "sourceImage": "IMAGE_URL"
            }
          }
        ]
      }
    }
  }
}

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

COUNT: 作成する VM の数。
IMAGE_URL: ブートディスクイメージの URL。
PROJECT_ID: プロジェクト ID。
REGION: VM を作成するリージョン。

インスタンスの柔軟性を使用して VM を一括作成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

gcloud

REST

必要なロール

必要な権限

同じ優先度の複数のマシンタイプを使用して VM を作成する

gcloud

REST

優先度でランク付けされた複数のマシンタイプを使用して VM を作成する

gcloud

REST

インスタンスの選択でディスクのオーバーライドを指定する

REST

インスタンスの柔軟性を使用して VM を一括作成する