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

コンパクトプレースメントポリシーを使用してレイテンシを短縮する

このドキュメントでは、コンパクトプレースメントポリシーを作成して適用することで、仮想マシン（VM）インスタンス間のネットワークレイテンシを短縮する方法について説明します。

コンパクトプレースメントポリシーでは、VM を互いに物理的に近い位置に配置するよう指定します。これにより、ハイパフォーマンスコンピューティング（HPC）、機械学習（ML）、データベースサーバーのワークロードなどを実行する際に、パフォーマンスを向上させ、VM 間のネットワークレイテンシを短縮することができます。

コンパクトプレースメントポリシーは、次の場合に適用できます。

VM を作成または更新する。
単一プロジェクトの予約を作成する。
VM を一括作成する。
インスタンステンプレートを作成する。インスタンステンプレートを使用して次の操作を行うと、コンパクトプレースメントポリシーが適用されます。
- VM を作成する。
- マネージドインスタンスグループ（MIG）を作成または更新する。
- 単一プロジェクトの予約を作成する。

始める前に

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

このページのサンプルをどのように使うかに応じて、タブを選択してください。
gcloud
1. Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。
```
gcloud init
```
  注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
2. デフォルトのリージョンとゾーンを設定します。
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

必要なロール

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

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

必要な権限

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

プレースメントポリシーを作成する: プロジェクトに対する compute.resourcePolicies.create 権限
既存の VM にプレースメントポリシーを適用する: プロジェクトに対する compute.instances.addResourcePolicies 権限
VM の詳細を表示する: プロジェクトに対する compute.instances.get 権限

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

制限事項

コンパクトプレースメントポリシーには、プレースメントポリシーの一般的な制限に加えて、次の制限もあります。

コンパクトプレースメントポリシーでは、max-distance（プレビュー）を使用して VM を配置する距離を適切に制御できます。次の表に、各 max-distance 値でサポートされる VM の数とホストメンテナンスポリシーを示します。

`max-distance` 値	説明	VM の最大数	サポートされるホストメンテナンスポリシー
指定なし	可用性に基づいて、VM は可能な限り互いに近い位置に配置されます。	1,500	移行または終了
`3`	レイテンシを抑えるため、VM は隣接するクラスタに配置されます。	1,500	移行または終了
`2`	VM は隣接するラックに配置されます。隣接するクラスタに配置された VM よりもネットワークレイテンシが低くなります。	150	終了
`1`	VM は同じラックに配置されます。ネットワークレイテンシは可能な限り最小限に抑えられます。	22	終了

コンパクトプレースメントポリシーを適用できるのは、A2、A3、C2、C3、C2D、C3D、G2、H3、N2、N2D のマシンシリーズのみです。コンパクトプレースメントポリシーの作成時に max-distance を使用する場合は、A3、G2、N2、N2D マシンシリーズにポリシーを適用することはできません。
単一テナントノードを指定する VM には、コンパクトプレースメントポリシーを適用できません。
予約用にコンパクトプレースメントポリシーを作成する場合は、予約の追加要件をご覧ください。

コンパクトプレースメントポリシーを作成する

コンパクトプレースメントポリシーを作成するには、次のいずれかの方法を使用します。

推奨: 固定数を指定しない。

VM の固定数を指定していないコンパクトプレースメントポリシーは、不特定の数の VM に適用できます。これにより、適用する VM の数に関係なくコンパクトプレースメントポリシーが有効になります。
固定数を指定する。

VM の固定数を指定しているコンパクトプレースメントポリシーは、正確な数の VM にのみ適用できます。これにより、指定された数の VM に適用する場合にのみコンパクトプレースメントポリシーが有効になります。

固定数を指定しない

コンパクトプレースメントポリシーを作成するには、gcloud CLI と REST を使用します。

gcloud

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

gcloud compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --region=REGION

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

POLICY_NAME: 作成するポリシーの名前。
REGION: ポリシーを作成するリージョン。コンパクトプレースメントポリシーを既存の VM に適用する場合は、VM が配置されているゾーンを含むリージョンにポリシーを作成します。

必要に応じて、ネットワークレイテンシの要件が厳しい場合に VM を配置する距離を適切に制御するには、--collocation=collocated および --max-distance フラグを指定して 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

MAX_DISTANCE は、VM の最大距離の構成に置き換えます。この値は 1 と 3 の間にする必要があります。前者は、ネットワークレイテンシを最小化するために VM を同じラックに配置するように指定します。後者は、VM を隣接するクラスタに配置するように指定します。コンパクトプレースメントポリシーを適用する VM で指定されたマシンタイプとゾーンに応じて、次の条件が適用されます。

ゾーンに使用可能な容量がある場合、maxDistance 値が大きい（3 など）コンパクトプレースメントポリシーでは、VM が互いに近い位置に配置されることがあります。
ゾーンの容量が不足している場合、maxDistance 値が小さい（1 など）コンパクトプレースメントポリシーでは、1 つ以上の VM にポリシーを適用する際に失敗する可能性が高くなります。

REST

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

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

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  }
}

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

PROJECT_ID: プレースメントポリシーを作成するプロジェクトの ID。
REGION: プレースメントポリシーを作成するリージョン。コンパクトプレースメントポリシーを既存の VM に適用する場合は、VM が配置されているゾーンを含むリージョンにポリシーを作成します。
POLICY_NAME: 作成するコンパクトプレースメントポリシーの名前。

必要に応じて、ネットワークレイテンシの要件が厳しい場合に VM 間の距離を適切に制御するには、beta.resourcePolicies.insert メソッドに POST リクエストを送信します。リクエストの本文に、COLLOCATED に設定された collocation フィールドと、maxDistance フィールドを含めます。

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

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED",
    "maxDistance": "MAX_DISTANCE"
  }
}

ゾーンに使用可能な容量がある場合、maxDistance 値が大きい（3 など）コンパクトプレースメントポリシーでは、VM が互いに近い位置に配置されることがあります。
ゾーンの容量が不足している場合、maxDistance 値が小さい（1 など）コンパクトプレースメントポリシーでは、1 つ以上の VM にポリシーを適用する際に失敗する可能性が高くなります。

固定数を指定する

VM の固定数を指定するコンパクトプレースメントポリシーを作成するには、gcloud CLI または REST を使用します。

gcloud

VM の固定数を指定するコンパクトプレースメントポリシーを作成するには、--collocation=collocated フラグと --vm-count フラグを指定して gcloud compute resource-policies create group-placement コマンドを使用します。

gcloud compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --region=REGION \
    --vm-count=VM_COUNT

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

POLICY_NAME: 作成するポリシーの名前。
REGION: ポリシーを作成するリージョン。コンパクトプレースメントポリシーを既存の VM に適用する場合は、VM が配置されているゾーンを含むリージョンにポリシーを作成します。
VM_COUNT: コンパクトプレースメントポリシーを適用できる VM の正確な数。この値は 1 から、コンパクトプレースメントポリシーを適用できる VM の最大数までの範囲にする必要があります。

必要に応じて、ネットワークレイテンシの要件が厳しい場合に VM 間の距離を適切に制御するには、--collocation=collocated、--max-distance、--vm-count フラグを指定して 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 \
    --vm-count=VM_COUNT

ゾーンに使用可能な容量がある場合、maxDistance 値が大きい（3 など）コンパクトプレースメントポリシーでは、VM が互いに近い位置に配置されることがあります。
ゾーンの容量が不足している場合、maxDistance 値が小さい（1 など）コンパクトプレースメントポリシーでは、1 つ以上の VM にポリシーを適用する際に失敗する可能性が高くなります。

REST

VM の固定数を指定するコンパクトプレースメントポリシーを作成するには、resourcePolicies.insert メソッドに POST リクエストを送信します。リクエストの本文に、COLLOCATED に設定された collocation フィールドと、vmCount フィールドを含めます。

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

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED",
    "vmCount": "VM_COUNT"
  }
}

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

PROJECT_ID: プレースメントポリシーを作成するプロジェクトの ID。
REGION: プレースメントポリシーを作成するリージョン。コンパクトプレースメントポリシーを既存の VM に適用する場合は、VM が配置されているゾーンを含むリージョンにポリシーを作成します。
POLICY_NAME: 作成するコンパクトプレースメントポリシーの名前。
VM_COUNT: コンパクトプレースメントポリシーを適用できる VM の正確な数。この値は 1 から、コンパクトプレースメントポリシーを適用できる VM の最大数までの範囲にする必要があります。

必要に応じて、ネットワークレイテンシの要件が厳しい場合に VM 間の距離を適切に制御するには、beta.resourcePolicies.insert メソッドに POST リクエストを送信します。リクエストの本文に、COLLOCATED に設定した collocation フィールド、maxDistance フィールド、vmCount フィールドを含めます。

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

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED",
    "maxDistance": "MAX_DISTANCE",
    "vmCount": "VM_COUNT"
  }
}

ゾーンに使用可能な容量がある場合、maxDistance 値が大きい（3 など）コンパクトプレースメントポリシーでは、VM が互いに近い位置に配置されることがあります。
ゾーンの容量が不足している場合、maxDistance 値が小さい（1 など）コンパクトプレースメントポリシーでは、1 つ以上の VM にポリシーを適用する際に失敗する可能性が高くなります。

コンパクトプレースメントポリシーを適用する

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

コンパクトプレースメントポリシーを指定する Compute Engine リソースを作成するには、次のいずれかの方法を選択します。

コンパクトプレースメントポリシーを既存の VM に適用する。
コンパクトプレースメントポリシーを指定する VM を作成する。
コンパクトプレースメントポリシーを指定する VM を一括作成する。
コンパクトプレースメントポリシーを指定するインスタンステンプレートを作成する。
MIG の VM にコンパクトプレースメントポリシーを適用する。

プロパティを直接指定して単一プロジェクトの予約を作成するときにコンパクトプレースメントポリシーを指定する場合は、単一プロジェクトの予約を作成するをご覧ください。

コンパクトプレースメントポリシーが VM に適用されたら、同じポリシーを指定している他の VM との関連で VM の物理的な場所を確認することができます。

コンパクトプレースメントポリシーを既存の VM に適用する

既存の VM にコンパクトプレースメントポリシーを適用するには、gcloud CLI または REST を使用します。

コンパクトプレースメントポリシーを既存の VM に適用する前に、次のことを確認してください。

VM とコンパクトプレースメントポリシーが同じプロジェクトにある。
VM が、コンパクトプレースメントポリシーが存在するリージョン内にある。
VM が、サポートされるマシンシリーズとホストメンテナンスポリシーを指定している。

上記以外の場合、既存の VM にコンパクトプレースメントポリシーを適用することはできません。

gcloud

既存の VM にコンパクトプレースメントポリシーを適用するには、--resource-policies フラグを指定して 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 に適用するには、resourcePolicies フィールドを指定して 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 を作成するには、gcloud CLI または REST を使用します。

gcloud

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

たとえば、c2d-standard-2 マシンタイプを指定する VM を作成するには、次のコマンドを実行します。

gcloud compute instances create VM_NAME \
    --machine-type=c2d-standard-2 \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

VM_NAME: 作成する VM の名前。
MAINTENANCE_POLICY: VM のホストメンテナンスポリシー。指定したコンパクトプレースメントポリシーが 1 または 2 の max-distance 値を使用する場合、指定できるのは TERMINATE のみです。それ以外の場合は、MIGRATE または TERMINATE を指定できます。
POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。
ZONE: VM を作成するゾーン。VM は、指定したコンパクトプレースメントポリシーのリージョン内にあるゾーンにのみ作成できます。

REST

コンパクトプレースメントポリシーを指定する VM を作成するには、resourcePolicies フィールドを指定して instances.insert メソッドに POST リクエストを送信します。

たとえば、c2d-standard-2 マシンタイプを指定する VM を作成するには、次の POST リクエストを送信します。

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

{
  "machineType": "zones/ZONE/machineTypes/c2d-standard-2",
  "name": "VM_NAME",
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

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

PROJECT_ID: コンパクトプレースメントポリシーを含むプロジェクトの ID。
ZONE: VM を作成するゾーンとマシンタイプが存在するゾーン。VM は、指定したコンパクトプレースメントポリシーのリージョン内のゾーンにのみ作成できます。
VM_NAME: 作成する VM の名前。
REGION: コンパクトプレースメントポリシーが存在するリージョン。
POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。
MAINTENANCE_POLICY: VM のホストメンテナンスポリシー。指定したコンパクトプレースメントポリシーが 1 または 2 の max-distance 値を使用する場合、指定できるのは TERMINATE のみです。それ以外の場合は、MIGRATE または TERMINATE を指定できます。

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

コンパクトプレースメントポリシーを指定する VM を一括作成する

既存のコンパクトプレースメントポリシーを指定する VM を一括で作成するには、gcloud CLI または REST を使用します。

gcloud

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

たとえば、c2d-standard-2 マシンタイプと、同一のコンパクトプレースメントポリシーを指定する VM を一括作成するには、次のコマンドを実行します。

gcloud compute instances bulk create \
    --async \
    --count=COUNT \
    --machine-type=c2d-standard-2 \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

COUNT: 作成する VM の数。
MAINTENANCE_POLICY: VM のホストメンテナンスポリシー。指定したコンパクトプレースメントポリシーが 1 または 2 の max-distance 値を使用する場合、指定できるのは TERMINATE のみです。それ以外の場合は、MIGRATE または TERMINATE を指定できます。
NAME_PATTERN: 作成する VM の名前パターン。ハッシュ文字（#）を使用して一連の数字に置き換えます。たとえば、vm-# を指定すると、vm-1 や vm-2 といった名前の VM が、COUNT で指定された VM の最大数まで作成されます。
POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。
ZONE: VM を一括作成するゾーン。VM は、指定したコンパクトプレースメントポリシーのリージョン内にあるゾーンにのみ作成できます。

REST

コンパクトプレースメントポリシーを指定する VM を一括で作成するには、resourcePolicies フィールドを指定して instances.bulkInsert メソッドに POST リクエストを送信します。

たとえば、c2d-standard-2 マシンタイプと、同じコンパクトプレースメントポリシーを指定する VM を一括作成するには、次の POST リクエストを送信します。

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

{
  "count": "COUNT",
  "machineType": "zones/ZONE/machineTypes/c2d-standard-2",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "resourcePolicies": [
      "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
    ],
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

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

PROJECT_ID: コンパクトプレースメントポリシーを含むプロジェクトの ID。
ZONE: VM を一括作成するゾーンと、マシンタイプが存在するゾーン。VM は、指定したコンパクトプレースメントポリシーのリージョン内にあるゾーンにのみ作成できます。
COUNT: 作成する VM の数。
NAME_PATTERN: 作成する VM の名前パターン。ハッシュ文字（#）を使用して一連の数字に置き換えます。たとえば、vm-# を指定すると、vm-1 や vm-2 といった名前の VM が、COUNT で指定された VM の最大数まで作成されます。
REGION: コンパクトプレースメントポリシーが存在するリージョン。
POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。
MAINTENANCE_POLICY: VM のホストメンテナンスポリシー。指定したコンパクトプレースメントポリシーが 1 または 2 の max-distance 値を使用する場合、指定できるのは TERMINATE のみです。それ以外の場合は、MIGRATE または TERMINATE を指定できます。

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

コンパクトプレースメントポリシーを指定するインスタンステンプレートを作成する

既存のコンパクトプレースメントポリシーを指定するインスタンステンプレートを作成するには、gcloud CLI または REST を使用します。

インスタンステンプレートを作成すると、それを使用して次のことができます。

gcloud

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

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

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=c2d-standard-2 \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME

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

INSTANCE_TEMPLATE_NAME: インスタンステンプレートの名前。
MAINTENANCE_POLICY: VM のホストメンテナンスポリシー。指定したコンパクトプレースメントポリシーが 1 または 2 の max-distance 値を使用する場合、指定できるのは TERMINATE のみです。それ以外の場合は、MIGRATE または TERMINATE を指定できます。
POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。

REST

コンパクトプレースメントポリシーを指定するインスタンステンプレートを作成するには、instanceTemplates.insert メソッドに POST リクエストを送信します。リクエストの本文で resourcePolicies フィールドを指定します。

たとえば、c2d-standard-2 マシンタイプと既存のコンパクトプレースメントポリシーを指定するグローバルインスタンステンプレートを作成するには、次の POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "machineType": "zones/ZONE/machineTypes/c2d-standard-2",
  "properties": {
    "resourcePolicies": {
      "POLICY_NAME"
    },
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

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

PROJECT_ID: インスタンステンプレートに適用するコンパクトプレースメントポリシーが配置されているプロジェクトの ID。
ZONE: マシンタイプが存在するゾーン。
INSTANCE_TEMPLATE_NAME: インスタンステンプレートの名前。
POLICY_NAME: 既存のコンパクトプレースメントポリシーの名前。
MAINTENANCE_POLICY: VM のホストメンテナンスポリシー。指定したコンパクトプレースメントポリシーが 1 または 2 の max-distance 値を使用する場合、指定できるのは TERMINATE のみです。それ以外の場合は、MIGRATE または TERMINATE を指定できます。

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

MIG の VM にコンパクトプレースメントポリシーを適用する

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

同一のコンパクトプレースメントポリシーを指定する MIG を作成する。
コンパクトプレースメントポリシーを既存の MIG に適用する。

コンパクトプレースメントポリシーを MIG に適用する場合は、任意の単一ゾーンの分配形態でリージョン MIG を作成するか、このリージョン MIG にポリシーを適用することをおすすめします。これにより、VM を作成してリージョン MIG をスケールアウトする必要がある場合は、予約、割り当て、ハードウェア要件に基づいて VM を作成するゾーンが選択されます。

コンパクトプレースメントポリシーを指定する MIG を作成する

コンパクトプレースメントポリシーを指定するインスタンステンプレートを使用して MIG を作成するには、gcloud CLI または REST を使用します。

gcloud

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

たとえば、任意の単一ゾーンの分配形態を持つリージョン MIG を作成するには、次のコマンドを実行します。

gcloud compute instance-groups managed create MIG_NAME \
    --region=REGION \
    --size=SIZE \
    --target-distribution-shape=any-single-zone \
    --template=INSTANCE_TEMPLATE_NAME

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

MIG_NAME: 作成する MIG の名前。
REGION: MIG を作成するリージョン。コンパクトプレースメントポリシーが存在するリージョンと一致している必要があります。
SIZE: MIG のサイズ。
INSTANCE_TEMPLATE_NAME: コンパクトプレースメントポリシーを指定する既存のインスタンステンプレートの名前。

REST

コンパクトプレースメントポリシーを指定するインスタンステンプレートを使用して MIG を作成するには、instanceTemplate フィールドを既存のテンプレートの名前に設定して、instanceGroupManagers.insert メソッドまたは regionInstanceGroupManagers.insert メソッドに POST リクエストを送信します。

たとえば、デフォルトの VM プロパティと任意の単一ゾーンの分配形態でリージョン MIG を作成するには、次の POST リクエストを送信します。

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

{
  "name": "MIG_NAME",
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME",
  "distributionPolicy": {
    "targetShape": "ANY_SINGLE_ZONE"
  },
  "targetSize": SIZE
}

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

PROJECT_ID: コンパクトプレースメントポリシーと、プレースメントポリシーを指定するインスタンステンプレートがあるプロジェクトの ID。
REGION: MIG を作成するリージョン。コンパクトプレースメントポリシーが存在するリージョンと一致している必要があります。
MIG_NAME: 作成する MIG の名前。
INSTANCE_TEMPLATE_NAME: コンパクトプレースメントポリシーを指定する既存のインスタンステンプレートの名前。
SIZE: MIG のサイズ。

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

既存の MIG にコンパクトプレースメントポリシーを適用する

同じプレースメントポリシーを指定するインスタンステンプレートを使用して、既存の MIG にコンパクトプレースメントポリシーを適用するには、gcloud CLI または REST を使用します。

gcloud

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

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

gcloud compute instance-groups managed rolling-action start-update MIG_NAME \
    --region=REGION \
    --type=proactive \
    --version=template=INSTANCE_TEMPLATE_NAME

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

MIG_NAME: 既存の MIG の名前。
REGION: MIG が配置されているリージョン。コンパクトプレースメントポリシーは、同じリージョン内の MIG にのみ適用できます。
INSTANCE_TEMPLATE_NAME: コンパクトプレースメントポリシーを指定する既存のインスタンステンプレートの名前。

REST

コンパクトプレースメントポリシーを指定するインスタンステンプレートを使用するように MIG を更新し、テンプレートのプロパティとプレースメントポリシーを MIG 内の既存の VM に自動的に適用するには、instanceTemplate フィールドを指定して instanceGroupManagers.insert または regionInstanceGroupManagers.insert に PATCH リクエストを送信します。

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

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME",
  "updatePolicy": {
    "type": "PROACTIVE"
  }
}

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

PROJECT_ID: MIG、コンパクトプレースメントポリシー、プレースメントポリシーを指定するインスタンステンプレートがあるプロジェクトの ID。
REGION: MIG が配置されているリージョン。コンパクトプレースメントポリシーは、同じリージョン内の MIG にのみ適用できます。
MIG_NAME: 既存の MIG の名前。
INSTANCE_TEMPLATE_NAME: コンパクトプレースメントポリシーを指定する既存のインスタンステンプレートの名前。

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

VM の物理的な位置を確認する

VM にコンパクトプレースメントポリシーを適用すると、同じポリシーを指定する他の VM との関連でコンパクトプレースメントポリシーが物理的な位置にどのように影響したかを確認できます。これにより、コンパクトプレースメントポリシーが VM に正しく適用されたかどうかを判断し、どの VM が互いに最も近いかをマッピングできます。

プレースメントポリシーを指定する VM の物理的な場所を確認するには、gcloud CLI または REST を使用します。

gcloud

コンパクトプレースメントポリシーを指定する VM の物理的な位置を表示するには、--format フラグを指定して gcloud compute instances describe コマンドを使用します。

gcloud compute instances describe VM_NAME \
    --format="table[box,title=VM-Position](resourcePolicies.scope():sort=1,resourceStatus.physicalHost:label=location)" \
    --zone=ZONE

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

VM_NAME: 既存の VM の名前。
ZONE: VM が配置されているゾーン。

出力は次のようになります。

VM-Position

RESOURCE_POLICIES: us-central1/resourcePolicies/example-policy']
PHYSICAL_HOST: /CCCCCCC/BBBBBB/AAAA

PHYSICAL_HOST フィールドの値は 3 つの部分で構成されます。それぞれ、VM が配置されているクラスタ、ラック、ホストを表します。

同一のコンパクトプレースメントポリシーを指定する 2 つの VM の位置を比較すると、PHYSICAL_HOST フィールドで VM が共有する部分が多いほど相互に配置される位置は近くなります。たとえば、2 つの VM の両方で PHYSICAL_HOST フィールドに次のサンプル値のいずれかを指定するとします。

/CCCCCCC/xxxxxx/xxxx: 2 つの VM は同じクラスタに配置されます。これは、max-distance の値 2 に相当します。同じクラスタに配置された VM では、ネットワークレイテンシが低くなります。
/CCCCCCC/BBBBBB/xxxx: 2 つの VM が同じラックに配置されます。これは max-distance の値 1 に相当します。同じラックに配置された VM では、同じクラスタに配置された VM よりもネットワークレイテンシが低くなります。
/CCCCCCC/BBBBBB/AAAA: 2 つの VM が同じホストを共有しています。同じホストに配置された VM では、ネットワークレイテンシが可能な限り最小限に抑えられます。

REST

コンパクトプレースメントポリシーを指定する VM の物理的な位置を表示するには、instances.get メソッドに GET リクエストを送信します。

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

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

PROJECT_ID: VM が配置されているプロジェクトのプロジェクト ID。
ZONE: VM が配置されているゾーン。
VM_NAME: プレースメントポリシーを指定する既存の VM の名前。

出力は次のようになります。

{
...
"resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy"
],
"resourceStatus": {
  "physicalHost": "/xxxxxxxx/xxxxxx/xxxxx"
},
...
}

physicalHost フィールドの値は 3 つの部分で構成されます。それぞれ、VM が配置されているクラスタ、ラック、ホストを表します。

同一のコンパクトプレースメントポリシーを指定する 2 つの VM の位置を比較すると、physicalHost フィールドで VM が共有する部分が多いほど相互に配置される位置は近くなります。たとえば、2 つの VM の両方で physicalHost フィールドに次のサンプル値のいずれかを指定するとします。

/CCCCCCC/xxxxxx/xxxx: 2 つの VM は同じクラスタに配置されます。これは、max-distance の値 2 に相当します。同じクラスタに配置された VM では、ネットワークレイテンシが低くなります。
/CCCCCCC/BBBBBB/xxxx: 2 つの VM が同じラックに配置されます。これは max-distance の値 1 に相当します。同じラックに配置された VM では、同じクラスタに配置された VM よりもネットワークレイテンシが低くなります。
/CCCCCCC/BBBBBB/AAAA: 2 つの VM が同じホストを共有しています。同じホストに配置された VM では、ネットワークレイテンシが可能な限り最小限に抑えられます。

次のステップ

プレースメントポリシーを表示する方法を学習する。
プレースメントポリシーを置換、削除、消去する方法を学習する。
プレースメントポリシーを指定する VM で、次の操作を行う方法を学習する。
- VM のステータスを表示する。
- VM に接続する。

コンパクト プレースメント ポリシーを使用してレイテンシを短縮する

始める前に

gcloud

REST

必要なロール

必要な権限

制限事項

コンパクト プレースメント ポリシーを作成する

固定数を指定しない

gcloud

REST

固定数を指定する

gcloud

REST

コンパクト プレースメント ポリシーを適用する

コンパクト プレースメント ポリシーを既存の VM に適用する

gcloud

REST

コンパクト プレースメント ポリシーを指定する VM を作成する

gcloud

REST

コンパクト プレースメント ポリシーを指定する VM を一括作成する

gcloud

REST

コンパクト プレースメント ポリシーを指定するインスタンス テンプレートを作成する

gcloud

REST

MIG の VM にコンパクト プレースメント ポリシーを適用する

コンパクト プレースメント ポリシーを指定する MIG を作成する

gcloud

REST

既存の MIG にコンパクト プレースメント ポリシーを適用する

gcloud

REST

VM の物理的な位置を確認する

gcloud

REST

次のステップ

コンパクトプレースメントポリシーを使用してレイテンシを短縮する

コンパクトプレースメントポリシーを作成する

コンパクトプレースメントポリシーを適用する

コンパクトプレースメントポリシーを既存の VM に適用する

コンパクトプレースメントポリシーを指定する VM を作成する

コンパクトプレースメントポリシーを指定する VM を一括作成する

コンパクトプレースメントポリシーを指定するインスタンステンプレートを作成する

MIG の VM にコンパクトプレースメントポリシーを適用する

コンパクトプレースメントポリシーを指定する MIG を作成する

既存の MIG にコンパクトプレースメントポリシーを適用する