リージョン MIG 内の VM のターゲット分配形態を設定する

コンソール

1. Google Cloud コンソールで、[インスタンス グループ] ページに移動します。

   [インスタンス グループ] ページに移動

2. [インスタンス グループを作成] をクリックして、新しいインスタンス グループを作成します。
3. [新しいマネージド インスタンス グループ] のオプション（ステートレスかステートフル）を選択します（デフォルトはステートレスです）。
4. インスタンス グループに名前と説明（省略可）を割り当てます。
5. インスタンス グループ用のインスタンス テンプレートを選択するか、新しいインスタンス テンプレートを作成します。
6. このグループの VM の数を指定します。高可用性ワークロードの場合、ゾーン障害の発生に備えてアプリケーションのサポートに十分な VM をプロビジョニングします。
7. [ロケーション] で、[複数のゾーン] を選択します。

8. リージョンを選択し、使用するゾーンを選択します。

   • MIG でリージョン内のすべてのゾーンを使用できるようにするには、使用可能なすべてのゾーンを選択します。
   • リージョン MIG を更新しても、作成後に別のゾーンを使用することはできません。

9. ターゲット分配形態を選択します。

   1. [任意] または [任意の単一ゾーン] を選択する場合は、[自動スケーリング] セクションで [自動スケーリング モード] をクリックし、[自動スケーリングの構成を削除] を選択します。
   2. [任意の単一ゾーン] または [バランス] を選択する場合は、[インスタンスの再分配] セクションで インスタンスの再配布を有効にするを選択しないでください。

10. 残りの MIG 作成手順を続けます。

gcloud

gcloud compute instance-groups managed create コマンドを使用して、--target-distribution-shape フラグを含めます。

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template TEMPLATE \
    --size SIZE \
    --region REGION \
    --zones ZONES \
    --target-distribution-shape SHAPE

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

• INSTANCE_GROUP_NAME: インスタンス グループの名前。
• TEMPLATE: グループに使用するインスタンス テンプレートの名前。
• SIZE: インスタンス グループのターゲット サイズ。
• REGION: グループを配置するリージョン。

• ZONES（省略可）: VM インスタンスをデプロイするリージョン内のゾーンのリスト。デフォルトでは、Compute Engine によって 3 つのゾーンが選択されます。

  • MIG でリージョン内のすべてのゾーンを使用できるようにするには、使用可能なすべてのゾーンを指定します。リージョン内のゾーンのリストを取得するには、次のコマンドを使用します。

    gcloud compute zones list --filter=region:REGION --format='list(NAME)'

  • リージョン MIG を更新しても、作成後に別のゾーンを使用することはできません。

• SHAPE: ターゲット分配形態。次のいずれかの値です。

  • even（デフォルト）: 選択されたゾーン全体で同じ数の VM を完成、維持するために、VM の作成と削除を行います。EVEN 分配では、2 つのゾーン間の VM の数の差が 1 つ以内になります。これは、高可用性サービスを提供するワークロードに適しています。
  • balanced: リソースが利用可能なゾーンで VM の作成を優先しますが、選択したゾーンに可能な限り均等に VM を配布して、ゾーン障害の影響を最小限に抑えます。これは、高可用性サービスを提供するワークロードやバッチ ワークロードに適しています。
  • any: リクエストされた数の VM を現在のリソース制約内で用意し、未使用のゾーン予約を最大限利用できるように、VM インスタンスの作成時にゾーンを選択します。高可用性が不要なバッチ ワークロードに適しています。
  • any-single-zone: 1 つのゾーン内にすべての VM インスタンスを作成するグループです。ゾーンは、ハードウェア サポート、現在のリソースと割り当ての可用性、および一致する予約に基づいて選択されます。 VM 間の大規模な通信が必要なワークロードには、コンパクトなインスタンス配置ポリシーと組み合わせて使用することをおすすめします。

たとえば、ターゲット分配形態が「バランス」のリージョン MIG を作成するには、--target-distribution-shape フラグを balanced に設定します。

gcloud compute instance-groups managed create example-rmig \
    --template example-template \
    --size 30 \
    --zones us-east1-b,us-east1-c \
    --target-distribution-shape balanced \
    --instance-redistribution-type none

Terraform

MIG 内の各 VM に必要なマシンタイプ、ブートディスク イメージ、ネットワーク、その他の VM プロパティを指定するインスタンス テンプレートをまだ作成していない場合は、インスタンス テンプレートを作成します。

リージョン MIG を作成するには、google_compute_region_instance_group_manager リソースを使用します。

次の例では、ターゲット分配形態が BALANCED のリージョン MIG を作成します。

resource "google_compute_region_instance_group_manager" "default" {
  name                             = "example-rmig"
  region                           = "us-east1"
  distribution_policy_zones        = ["us-east1-b", "us-east1-c"]
  distribution_policy_target_shape = "BALANCED"
  update_policy {
    type                         = "PROACTIVE"
    minimal_action               = "REFRESH"
    instance_redistribution_type = "NONE"
    max_unavailable_fixed        = 3
  }
  target_size        = 30
  base_instance_name = "instance"
  version {
    instance_template = google_compute_instance_template.default.id
  }
}

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

REST

regionInstanceGroupManagers.insert メソッドを呼び出します。リクエストの本文に distributionPolicy プロパティを含め、targetShape フィールドを設定します。

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

{
    "name": INSTANCE_GROUP_NAME,
    "instanceTemplate": "global/instanceTemplates/TEMPLATE",
    "targetSize": SIZE,
    "distributionPolicy": {
        "zones": [
            {"zone": "zones/ZONE1"},
            {"zone": "zones/ZONE2"},
            {"zone": "zones/ZONE3"},
        ],
        "targetShape": "SHAPE"
    }
}

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

• PROJECT_ID: このリクエストのプロジェクト ID。
• REGION: インスタンス グループのリージョン。
• INSTANCE_GROUP_NAME: インスタンス グループの名前。
• TEMPLATE: インスタンス グループに使用するインスタンス テンプレートの名前。
• SIZE: インスタンス グループのターゲット サイズ。
• ZONE: VM インスタンスをデプロイするリージョン内のゾーン名。
  • MIG でリージョン内のすべてのゾーンを使用できるようにするには、使用可能なすべてのゾーンを指定します。リージョン内のゾーンのリストを取得するには、regions.get メソッドを呼び出します。
  • リージョン MIG を更新しても、作成後に別のゾーンを使用することはできません。
• SHAPE: ターゲット分配形態。次のいずれかの値です。
  • EVEN（デフォルト）: 選択されたゾーン全体で同じ数の VM を完成、維持するために、VM の作成と削除を行います。EVEN 分配では、2 つのゾーン間の VM の数の差が 1 つ以内になります。これは、高可用性サービスを提供するワークロードに適しています。
  • BALANCED: リソースが利用可能なゾーンで VM の作成を優先しますが、選択したゾーンに可能な限り均等に VM を配布して、ゾーン障害の影響を最小限に抑えます。これは、高可用性サービスを提供するワークロードやバッチ ワークロードに適しています。
  • ANY: リクエストされた数の VM を現在のリソース制約内で用意し、未使用のゾーン予約を最大限利用できるように、VM インスタンスの作成時にゾーンを選択します。高可用性が不要なバッチ ワークロードに適しています。
  • ANY_SINGLE_ZONE: 1 つのゾーン内にすべての VM インスタンスを作成するグループです。ゾーンは、ハードウェア サポート、現在のリソースと割り当ての可用性、および一致する予約に基づいて選択されます。 VM 間の広範な通信が必要なワークロードには、 コンパクトなインスタンス配置ポリシーと組み合わせて使用することをおすすめします。

コンソール

1. Google Cloud コンソールで、[インスタンス グループ] ページに移動します。

   [インスタンス グループ] ページに移動

2. リストの [名前] 列で、ターゲット分配形態を変更するインスタンス グループの名前をクリックします。
3. [編集] をクリックして、このマネージド インスタンス グループを変更します。
4. [ターゲット分配形態] で、目的の形態を指定します。
5. [保存] をクリックして、新しいテンプレートを適用します。

gcloud

gcloud compute instance-groups managed update コマンドを使用して、--target-distribution-shape フラグを含めます。

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --target-distribution-shape SHAPE

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

• INSTANCE_GROUP_NAME: インスタンス グループの名前。
• SHAPE: ターゲット分配形態。次のいずれかの値です。
  • even（デフォルト）: 選択されたゾーン全体で同じ数の VM を完成、維持するために、VM の作成と削除を行います。EVEN 分配では、2 つのゾーン間の VM の数の差が 1 つ以内になります。これは、高可用性サービスを提供するワークロードに適しています。
  • balanced: リソースが利用可能なゾーンで VM の作成を優先しますが、選択したゾーンに可能な限り均等に VM を配布して、ゾーン障害の影響を最小限に抑えます。これは、高可用性サービスを提供するワークロードやバッチ ワークロードに適しています。
  • any: リクエストされた数の VM を現在のリソース制約内で用意し、未使用のゾーン予約を最大限利用できるように、VM インスタンスの作成時にゾーンを選択します。高可用性が不要なバッチ ワークロードに適しています。
  • any-single-zone: 1 つのゾーン内にすべての VM インスタンスを作成するグループです。ゾーンは、ハードウェア サポート、現在のリソースと割り当ての可用性、および一致する予約に基づいて選択されます。 VM 間の大規模な通信が必要なワークロードには、コンパクトなインスタンス配置ポリシーと組み合わせて使用することをおすすめします。

REST

regionInstanceGroupManagers.patch メソッドを呼び出します。リクエストの本文に distributionPolicy プロパティを含め、targetShape フィールドを設定します。

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

{
    "distributionPolicy": {
        "targetShape": "SHAPE"
    }
}

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

• PROJECT_ID: このリクエストのプロジェクト ID。
• REGION: インスタンス グループのリージョン。
• INSTANCE_GROUP_NAME: インスタンス グループの名前。
• SHAPE: ターゲット分配形態。次のいずれかの値です。
  • EVEN（デフォルト）: 選択されたゾーン全体で同じ数の VM を完成、維持するために、VM の作成と削除を行います。EVEN 分配では、2 つのゾーン間の VM の数の差が 1 つ以内になります。これは、高可用性サービスを提供するワークロードに適しています。
  • BALANCED: リソースが利用可能なゾーンで VM の作成を優先しますが、選択したゾーンに可能な限り均等に VM を配布して、ゾーン障害の影響を最小限に抑えます。これは、高可用性サービスを提供するワークロードやバッチ ワークロードに適しています。
  • ANY: リクエストされた数の VM を現在のリソース制約内で用意し、未使用のゾーン予約を最大限利用できるように、VM インスタンスの作成時にゾーンを選択します。高可用性が不要なバッチ ワークロードに適しています。
  • ANY_SINGLE_ZONE: 1 つのゾーン内にすべての VM インスタンスを作成するグループです。ゾーンは、ハードウェア サポート、現在のリソースと割り当ての可用性、および一致する予約に基づいて選択されます。 VM 間の広範な通信が必要なワークロードには、 コンパクトなインスタンス配置ポリシーと組み合わせて使用することをおすすめします。

コンソール

1. Google Cloud コンソールで、[インスタンス グループ] ページに移動します。

   [インスタンス グループ] ページに移動

   既存のインスタンス グループがある場合は、このページにそのグループのリストが表示されます。
2. 確認するインスタンス グループの名前をクリックします。ページが開き、インスタンス グループ プロパティと、グループに含まれるインスタンスのリストが表示されます。
3. [詳細] をクリックします。
4. [ロケーション] セクションで、[ターゲット分配形態] を確認します。

gcloud

gcloud compute instance-groups managed describe コマンドを実行します。

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --region REGION

このコマンドは、distributionPolicy.targetShape フィールドを含むグループの詳細を返します。

...
distributionPolicy:
  targetShape: BALANCED
  zones:
  - zone: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f
  ...
name: my-group
region: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1
...

REST

regionInstanceGroupManagers.get メソッドに対して GET リクエストを作成します。

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

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

• PROJECT_ID: このリクエストのプロジェクト ID
• REGION: インスタンス グループのリージョン
• INSTANCE_GROUP_NAME: インスタンス グループの名前

ターゲット分配形態が distributionPolicy.targetShape フィールドに返されます。次に例を示します。

{
  "name": "my-instance-group",
  "distributionPolicy": {
    "targetShape": "BALANCED",
  },
  "targetSize": 50,
  ...
}