スプレッドプレースメントポリシーを作成して VM に適用する

このドキュメントでは、スプレッドプレースメントポリシーを作成して適用することで、仮想マシン（VM）インスタンスの信頼性を向上させる方法について説明します。

スプレッドプレースメントポリシーでは、VM を異なるアベイラビリティドメインに分散することを指定します。この分散は、ハードウェアエラーなどのロケーション固有の中断を軽減するのに役立ちます。また、Hadoop Distributed File System（HDFS）、Cassandra、Kafka などの大規模な分散レプリケートワークロードを実行する場合に便利です。

始める前に

まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

必要なロール

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

この事前定義ロールには、スプレッドプレースメントポリシーを作成して VM に適用するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

スプレッドプレースメントポリシーを作成して VM に適用するには、次の権限が必要です。

プレースメントポリシーを作成する: プロジェクトに対する compute.resourcePolicies.create
既存の VM にプレースメントポリシーを適用する: プロジェクトに対する compute.instances.addResourcePolicies
VM を作成する:
- プロジェクトに対する compute.instances.create
- カスタムイメージを使用して VM を作成する: イメージに対する compute.images.useReadOnly
- スナップショットを使用して VM を作成する: スナップショットに対する compute.snapshots.useReadOnly
- インスタンステンプレートを使用して VM を作成する: インスタンステンプレートに対する compute.instanceTemplates.useReadOnly
- レガシーネットワークを VM に割り当てる: プロジェクトに対する compute.networks.use
- VM の静的 IP アドレスを指定する: プロジェクトに対する compute.addresses.use
- レガシーネットワークの使用時に VM に外部 IP アドレスを割り当てる: プロジェクトに対する compute.networks.useExternalIp
- VM のサブネットを指定する: プロジェクトまたは選択したサブネットに対する compute.subnetworks.use
- VPC ネットワークの使用時に VM に外部 IP アドレスを割り当てる: プロジェクトまたは選択したサブネットに対する compute.subnetworks.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
インスタンステンプレートを作成する: プロジェクトに対する compute.instanceTemplates.create
マネージドインスタンスグループ（MIG）を作成する: プロジェクトに対する compute.instanceGroupManagers.create

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

スプレッドプレースメントポリシーを作成する

VM へのスプレッドプレースメントポリシーの適用をテストする場合を除いて、複数のアベイラビリティドメインを含むスプレッドプレースメントポリシーを作成することをおすすめします。これにより、単一のハードウェアエラーによってすべての VM が影響を受けるリスクを軽減できます。詳細については、スプレッドプレースメントポリシーについてをご覧ください。

スプレッドプレースメントポリシーを作成するには、次のいずれかのオプションを選択します。

gcloud

スプレッドプレースメントポリシーを作成するには、--availability-domain-count フラグを指定して gcloud compute resource-policies create group-placement コマンドを使用します。

gcloud compute resource-policies create group-placement POLICY_NAME \
    --availability-domain-count=DOMAIN_COUNT \
    --region=REGION

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

POLICY_NAME: スプレッドプレースメントポリシーの名前。
DOMAIN_COUNT: VM を配置するアベイラビリティドメインの個別の数。値は 1 と 8 の範囲で指定してください。
REGION: プレースメントポリシーを作成するリージョン。

REST

スプレッドプレースメントポリシーを作成するには、resourcePolicies.insert メソッドに POST リクエストを送信します。リクエスト本文に、availabilityDomainCount フィールドを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "availabilityDomainCount": DOMAIN_COUNT
  }
}

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

PROJECT_ID: プレースメントポリシーを作成するプロジェクトの ID。
REGION: プレースメントポリシーを作成するリージョン。
POLICY_NAME: スプレッドプレースメントポリシーの名前。
DOMAIN_COUNT: VM を配置するアベイラビリティドメインの個別の数。値は 1 と 8 の範囲で指定してください。

スプレッドプレースメントポリシーを適用する

スプレッドプレースメントポリシーは、既存の VM または MIG に適用できます。VM、インスタンステンプレート、MIG を作成するときに適用することもできます。

スプレッドプレースメントポリシーを Compute Engine リソースに適用するには、次のいずれかの方法を選択します。

既存の VM にポリシーを適用する。
VM の作成時にポリシーを適用する。
VM を一括作成するときにポリシーを適用する。
インスタンステンプレートの作成時にポリシーを適用する。
MIG 内の VM にポリシーを適用する。

VM にスプレッドプレースメントポリシーを適用したら、VM の詳細を表示して availabilityDomain フィールドの値を確認することで、VM が配置されているアベイラビリティドメインを確認できます。

既存の VM にポリシーを適用する

既存の VM にスプレッドプレースメントポリシーを適用する前に、次のことを考慮してください。

スプレッドプレースメントポリシーで複数のアベイラビリティドメインを指定する場合は、VM を停止せずに VM にポリシーを適用できます。ただし、VM を別のアベイラビリティドメインに再配置しなければならないことがあります。このプロセス中、Compute Engine はホストメンテナンスポリシーに基づいて VM を停止するか、ライブマイグレーションを実行します。
VM とスプレッドプレースメントポリシーは同じリージョンに配置する必要があります。たとえば、プレースメントポリシーがリージョン us-central1 にある場合、VM は us-central1 のゾーンに配置する必要があります。VM を別のリージョンに移行する必要がある場合は、ゾーンまたはリージョン間で VM を移動するをご覧ください。

VM を配置するアベイラビリティドメインを指定する場合は、プロパティを更新して、プレースメントポリシーを VM に適用します。VM のプロパティを更新する場合は、resourcePolicies フィールドと scheduling.availabilityDomain フィールドを含めてください。

既存の VM にスプレッドプレースメントポリシーを適用するには、次のいずれかを選択します。

gcloud

既存の VM にスプレッドプレースメントポリシーを適用するには、gcloud compute instances add-resource-policies コマンドを使用します。

gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

VM_NAME: 既存の VM の名前。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。
ZONE: VM が配置されているゾーン。

REST

スプレッドプレースメントポリシーを既存の VM に適用するには、instances.addResourcePolicies メソッドに POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/addResourcePolicies

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

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

PROJECT_ID: スプレッドプレースメントポリシーと VM を含むプロジェクトの ID。
ZONE: VM が配置されているゾーン。
VM_NAME: 既存の VM の名前。
REGION: スプレッドプレースメントポリシーが存在するリージョン。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。

VM の作成時にポリシーを適用する

スプレッドプレースメントポリシーを指定する VM は、プレースメントポリシーと同じリージョンにのみ作成できます。

スプレッドプレースメントポリシーを指定する VM を作成するには、次のいずれかを選択します。

gcloud

スプレッドプレースメントポリシーを指定する VM を作成するには、--resource-policies フラグを指定して gcloud compute instances create コマンドを使用します。

gcloud compute instances create VM_NAME \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

VM_NAME: 作成する VM の名前。
MACHINE_TYPE: VM のマシンタイプ。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。
ZONE: VM インスタンスを作成するゾーン。

VM を作成するアベイラビリティドメインを指定する場合は、--availability-domain フラグを含めます。

gcloud compute instances create VM_NAME \
    --availability-domain=DOMAIN_NUMBER \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

DOMAIN_NUMBER は、VM を配置するアベイラビリティドメインの数に置き換えます。値は、1 以上、スプレッドプレースメントポリシーで指定されたドメイン数以下にする必要があります。スプレッドプレースメントポリシーのドメイン数を確認するには、プレースメントポリシーの詳細を表示します。

REST

スプレッドプレースメントポリシーを指定する VM を作成するには、instances.insert メソッドに POST リクエストを行います。リクエスト本文に、resourcePolicies フィールドを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

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

PROJECT_ID: スプレッドプレースメントポリシーを含むプロジェクトの ID。
ZONE: VM を作成するゾーンとマシンタイプが存在するゾーン。指定できるのは、スプレッドプレースメントポリシーのリージョン内のゾーンのみです。
VM_NAME: 作成する VM の名前。
MACHINE_TYPE: VM のマシンタイプ。
IMAGE_PROJECT: イメージを含むイメージプロジェクト（例: debian-cloud）。サポートされているイメージプロジェクトの詳細については、公開イメージをご覧ください。
IMAGE: 次のいずれかを指定します。
- OS イメージの特定のバージョン。例: debian-12-bookworm-v20240617。
- イメージファミリー。family/IMAGE_FAMILY の形式にする必要があります。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-12 を指定すると、Debian 12 イメージファミリーの最新バージョンが使用されます。イメージファミリーの使用の詳細については、イメージファミリーのベストプラクティスをご覧ください。
REGION: スプレッドプレースメントポリシーが存在するリージョン。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。

VM を作成するアベイラビリティドメインを指定する場合は、リクエスト本文に availabilityDomain フィールドを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "availabilityDomain": DOMAIN_NUMBER
  }
}

VM を作成する構成オプションの詳細については、VM インスタンスを作成して起動するをご覧ください。

VM を一括作成するときにポリシーを適用する

スプレッドプレースメントポリシーを指定して VM を一括作成する前に、次の点を確認してください。

スプレッドプレースメントポリシーを使用して VM を一括作成できるのは、プレースメントポリシーと同じリージョン内のみです。
スプレッドプレースメントポリシーを使用して VM を一括作成する場合は、必要に応じて VM を作成するアベイラビリティドメインを指定できます。すべての VM を 1 つのドメインに作成しないでください。作成すると、単一のハードウェアエラーがすべての VM に影響するリスクを軽減できません。

スプレッドプレースメントポリシーを指定する VM を一括作成するには、次のいずれかのオプションを選択します。

gcloud

スプレッドプレースメントポリシーを指定する VM を一括で作成するには、--resource-policies フラグを指定して gcloud compute instances bulk create コマンドを使用します。

たとえば、単一のゾーンで VM を一括作成し、VM の名前パターンを指定するには、次のコマンドを実行します。

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

COUNT: 作成する VM の数。
MACHINE_TYPE: VM のマシンタイプ。
NAME_PATTERN: VM の名前パターン。VM 名の一連の数字を置き換えるには、一連のハッシュ（#）文字を使用します。たとえば、名前パターンに vm-# を使用すると、vm-1、vm-2 で始まり、COUNT で指定された VM の数まで続く名前の VM が生成されます。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。
ZONE: VM を一括作成するゾーン。

VM を一括作成するアベイラビリティドメインを指定する場合は、--availability-domain フラグを含めます。

gcloud compute instances bulk create \
    --availability-domain=DOMAIN_NUMBER \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

REST

スプレッドプレースメントポリシーを指定する VM を一括作成するには、instances.bulkInsert メソッドに POST を行います。リクエスト本文に、resourcePolicies フィールドを含めます。

たとえば、単一のゾーンで VM を一括作成し、VM の名前パターンを指定するには、次のように POST リクエストを送信します。

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": "COUNT",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ]
  }
}

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

PROJECT_ID: スプレッドプレースメントポリシーを含むプロジェクトの ID。
ZONE: VM を一括作成するゾーン。
COUNT: 作成する VM の数。
NAME_PATTERN: VM の名前パターン。VM 名の一連の数字を置き換えるには、一連のハッシュ（#）文字を使用します。たとえば、名前パターンに vm-# を使用すると、vm-1、vm-2 で始まり、COUNT で指定された VM の数まで続く名前の VM が生成されます。
MACHINE_TYPE: VM のマシンタイプ。
IMAGE_PROJECT: イメージを含むイメージプロジェクト（例: debian-cloud）。サポートされているイメージプロジェクトの詳細については、公開イメージをご覧ください。
IMAGE: 次のいずれかを指定します。
- OS イメージの特定のバージョン。例: debian-12-bookworm-v20240617。
- イメージファミリー。family/IMAGE_FAMILY の形式にする必要があります。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-12 を指定すると、Debian 12 イメージファミリーの最新バージョンが使用されます。イメージファミリーの使用の詳細については、イメージファミリーのベストプラクティスをご覧ください。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。

VM を一括作成するアベイラビリティドメインを指定する場合は、リクエスト本文に availabilityDomain フィールドを含めます。

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": "COUNT",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "availabilityDomain": DOMAIN_NUMBER
    }
  }
}

VM を一括作成するための構成オプションの詳細については、VM を一括作成するをご覧ください。

インスタンステンプレートの作成時にポリシーを適用する

スプレッドプレースメントポリシーを指定するインスタンステンプレートを作成する前に、次の点を確認してください。

リージョンインスタンステンプレートを作成する場合は、スプレッドプレースメントポリシーと同じリージョンにテンプレートを作成します。そうしないと、インスタンステンプレートの作成は失敗します。
インスタンステンプレートを作成するときに、VM を作成するアベイラビリティドメインを必要に応じて指定できます。すべての VM を 1 つのドメインに作成しないでください。作成すると、単一のハードウェアエラーがすべての VM に影響するリスクを軽減できません。

スプレッドプレースメントポリシーを指定するインスタンステンプレートを作成すると、そのテンプレートを使用して次のことができます。

スプレッドプレースメントポリシーを指定するインスタンステンプレートを作成するには、次のいずれかのオプションを選択します。

gcloud

スプレッドプレースメントポリシーを指定するインスタンステンプレートを作成するには、--resource-policies フラグを指定して gcloud compute instance-templates create コマンドを使用します。

たとえば、スプレッドプレースメントポリシーを指定するグローバルインスタンステンプレートを作成するには、次のコマンドを実行します。

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME

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

INSTANCE_TEMPLATE_NAME: インスタンステンプレートの名前。
MACHINE_TYPE: インスタンステンプレートを使用して作成された VM のマシンタイプ。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。

VM を作成するアベイラビリティドメインを指定する場合は、--availability-domain フラグを含めます。

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --availability-domain=DOMAIN_NUMBER  \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME

DOMAIN_NUMBER は、VM を作成するアベイラビリティドメインの数に置き換えます。値は、1 以上、プレースメントポリシーで指定されたドメイン数以下にする必要があります。スプレッドプレースメントポリシーのドメイン数を確認するには、プレースメントポリシーの詳細を表示します。

REST

スプレッドプレースメントポリシーを指定するインスタンステンプレートを作成するには、次のいずれかのメソッドに POST リクエストを送信します。

グローバルインスタンステンプレートを作成するには: instanceTemplates.insert メソッド。
リージョンインスタンステンプレートを作成するには: regionInstanceTemplates.insert メソッド。

リクエストの本文で resourcePolicies フィールドを指定します。

たとえば、スプレッドプレースメントポリシーを指定するグローバルインスタンステンプレートを作成するには、次のように POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/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"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ]
  }
}

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

PROJECT_ID: スプレッドプレースメントポリシーを含むプロジェクトの ID。
INSTANCE_TEMPLATE_NAME: インスタンステンプレートの名前。
IMAGE_PROJECT: イメージを含むイメージプロジェクト（例: debian-cloud）。サポートされているイメージプロジェクトの詳細については、公開イメージをご覧ください。
IMAGE: 次のいずれかを指定します。
- OS イメージの特定のバージョン。例: debian-12-bookworm-v20240617。
- イメージファミリー。family/IMAGE_FAMILY の形式にする必要があります。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-12 を指定すると、Debian 12 イメージファミリーの最新バージョンが使用されます。イメージファミリーの使用の詳細については、イメージファミリーのベストプラクティスをご覧ください。
MACHINE_TYPE: インスタンステンプレートを使用して作成された VM のマシンタイプ。
POLICY_NAME: 既存のスプレッドプレースメントポリシーの名前。

VM を作成するアベイラビリティドメインを指定する場合は、リクエスト本文に availabilityDomain フィールドを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/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"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "availabilityDomain": DOMAIN_NUMBER
    }
  }
}

インスタンステンプレートを作成するための構成オプションの詳細については、インスタンステンプレートを作成するをご覧ください。

MIG 内の VM にポリシーを適用する

スプレッドプレースメントポリシーを指定するインスタンステンプレートを作成すると、そのテンプレートを使用して次のことができます。

MIG の作成時にポリシーを適用する。
既存の MIG にポリシーを適用する。

MIG の作成時にポリシーを適用する

スプレッドプレースメントポリシーを指定する VM は、VM がプレースメントポリシーと同じリージョンにある場合にのみ作成できます。

スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用して MIG を作成するには、次のいずれかの方法を選択します。

gcloud

スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用して MIG を作成するには、gcloud compute instance-groups managed create コマンドを使用します。

たとえば、スプレッドプレースメントポリシーを指定するグローバルインスタンステンプレートを使用してゾーン MIG を作成するには、次のコマンドを実行します。

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

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

INSTANCE_GROUP_NAME: 作成する MIG の名前。
SIZE: MIG のサイズ。
INSTANCE_TEMPLATE_NAME: スプレッドプレースメントポリシーを指定する既存のグローバルインスタンステンプレートの名前。
ZONE: MIG を作成するゾーン。スプレッドプレースメントポリシーが適用されているリージョン内である必要があります。

REST

スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用して MIG を作成するには、次のいずれかのメソッドに POST リクエストを送信します。

ゾーン MIG を作成する: instanceGroupManagers.insert メソッド。
リージョン MIG を作成する: regionInstanceGroupManagers.insert メソッド。

たとえば、スプレッドプレースメントポリシーを指定するグローバルインスタンステンプレートを使用してゾーン MIG を作成するには、次のように POST リクエストを送信します。

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

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": SIZE,
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    }
  ]
}

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

PROJECT_ID: スプレッドプレースメントポリシーと、プレースメントポリシーを指定するインスタンステンプレートがあるプロジェクトの ID。
ZONE: MIG を作成するゾーン。スプレッドプレースメントポリシーが適用されているリージョン内である必要があります。
INSTANCE_GROUP_NAME: 作成する MIG の名前。
SIZE: MIG のサイズ。
INSTANCE_TEMPLATE_NAME: スプレッドプレースメントポリシーを指定する既存のグローバルインスタンステンプレートの名前。

MIG を作成するための構成オプションの詳細については、MIG を作成するための基本的なシナリオをご覧ください。

既存の MIG にポリシーを適用する

コンパクトプレースメントポリシーを既存の MIG に適用できるのは、MIG がプレースメントポリシーと同じリージョンにある場合、またはゾーン MIG の場合はプレースメントポリシーと同じリージョン内のゾーンにある場合のみです。

スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用するように MIG を更新するには、次のいずれかのオプションを選択します。

gcloud

スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用するように MIG を更新するには、gcloud compute instance-groups managed rolling-action start-update コマンドを使用します。

たとえば、スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用するようにゾーン MIG を更新し、MIG の既存の VM をテンプレートのプロパティを指定する新しい VM に置き換えるには、次のコマンドを実行します。

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

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

INSTANCE_GROUP_NAME: 既存の MIG の名前。
INSTANCE_TEMPLATE_NAME: スプレッドプレースメントポリシーを指定する既存のグローバルインスタンステンプレートの名前。
ZONE: MIG が配置されているゾーン。スプレッドプレースメントポリシーは、プレースメントポリシーと同じリージョン内の MIG にのみ適用できます。

REST

スプレッドプレースメントポリシーを指定するインスタンステンプレートを使用するように MIG を更新し、テンプレートのプロパティとプレースメントポリシーを MIG 内の既存の VM に自動的に適用するには、次のいずれかのメソッドに PATCH リクエストを行います。

ゾーン MIG を更新する: instanceGroupManagers.insert メソッド
リージョン MIG を更新する: regionInstanceGroupManagers.insert メソッド。

たとえば、スプレッドプレースメントポリシーを指定するグローバルインスタンステンプレートを使用するようにゾーン MIG を更新し、MIG の既存の VM をテンプレートのプロパティを指定する新しい VM に置き換えるには、次の PATCH リクエストを送信します。

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

{
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
}

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

PROJECT_ID: 既存の MIG、スプレッドプレースメントポリシー、スプレッドプレースメントポリシーを指定するインスタンステンプレートの作成に使用したプロジェクトの ID。
ZONE: MIG が配置されているゾーン。スプレッドプレースメントポリシーは、プレースメントポリシーと同じリージョン内の MIG にのみ適用できます。
INSTANCE_GROUP_NAME: 既存の MIG の名前。
INSTANCE_TEMPLATE_NAME: スプレッドプレースメントポリシーを指定する既存のグローバルインスタンステンプレートの名前。

MIG 内の VM を更新するための構成オプションの詳細については、MIG 内の VM に新しい構成を更新して適用するをご覧ください。

次のステップ

プレースメントポリシーを表示する方法を学習する。
プレースメントポリシーを置換、削除、消去する方法を学習する。
プレースメントポリシーを指定する VM で、次の操作を行う方法を学習する。
- VM のステータスを表示する。
- VM に接続する。
メンテナンスイベント中のライブマイグレーションプロセスについて学習する。

スプレッド プレースメント ポリシーを作成して VM に適用する

始める前に

gcloud

REST

必要なロール

必要な権限

スプレッド プレースメント ポリシーを作成する

gcloud

REST

スプレッド プレースメント ポリシーを適用する

既存の VM にポリシーを適用する

gcloud

REST

VM の作成時にポリシーを適用する

gcloud

REST

VM を一括作成するときにポリシーを適用する

gcloud

REST

インスタンス テンプレートの作成時にポリシーを適用する

gcloud

REST

MIG 内の VM にポリシーを適用する

MIG の作成時にポリシーを適用する

gcloud

REST

既存の MIG にポリシーを適用する

gcloud

REST

次のステップ

スプレッドプレースメントポリシーを作成して VM に適用する

スプレッドプレースメントポリシーを作成する

スプレッドプレースメントポリシーを適用する

インスタンステンプレートの作成時にポリシーを適用する