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

このドキュメントでは、GPU が関連付けられている仮想マシン（VM）インスタンスのマネージドインスタンスグループ（MIG）でサイズ変更リクエストを作成する方法について説明します。

MIG でサイズ変更リクエストを作成すると、GPU などの需要の高いリソースを取得し、正確な数の VM を一度に作成して費用を最適化できます。

始める前に

サイズ変更リクエストの仕組みを確認します。
リクエストするリソースに十分な GPU 割り当てがあることを確認するには、GPU 割り当てを確認するをご覧ください。
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
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.

必要なロール

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

この事前定義ロールには、MIG でサイズ変更リクエストを作成するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

MIG でサイズ変更リクエストを作成するには、次の権限が必要です。

インスタンステンプレートを作成する: プロジェクトに対する compute.instanceTemplates.create
ゾーン MIG を作成する: プロジェクトに対する compute.instanceGroupManagers.create
MIG でサイズ変更リクエストを作成する: プロジェクトに対する compute.instanceGroupManagers.update

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

サイズ変更リクエスト用に MIG を準備する

MIG でサイズ変更リクエストを作成するには、次のセクションで説明するように、インスタンステンプレートと MIG を構成する必要があります。

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

MIG でサイズ変更リクエストを作成する場合は、MIG で次の構成のインスタンステンプレートを使用する必要があります。

ホストメンテナンスイベント中に VM を停止します。
予約は使用しないでください。

MIG でサイズ変更リクエストを作成するように構成されたインスタンステンプレートを作成するには、次のいずれかの方法を選択します。

コンソール

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

[インスタンステンプレート] に移動
[インスタンステンプレートを作成] をクリックします。
[名前] フィールドに、インスタンステンプレートの名前を入力します。
[ロケーション] セクションで、次のいずれかのオプションを選択します。
- グローバルインスタンステンプレートを作成するには、[グローバル] を選択します（まだ選択されていない場合）。
- リージョンインスタンステンプレートを作成するには、[リージョン] を選択し、インスタンステンプレートを作成するリージョンを選択します。
[マシンの構成] セクションで、次の操作を行います。
1. [GPU] タブをクリックします。
2. [GPU のタイプ] リストで、GPU のタイプを選択します。
3. [GPU の数] リストで、GPU の数を選択します。
4. 省略可: GPU モデルがグラフィックワークロード用の NVIDIA RTX 仮想ワークステーション（vWS）グラフィックを多用するワークロードを実行する場合は、仮想ワークステーション（NVIDIA GRID）を有効にするをご覧ください。
5. [マシンタイプ] セクションでマシンタイプを選択します。
省略可: デフォルト値のブートディスクのタイプまたはイメージを変更するには、[ブートディスク] セクションで [変更] をクリックします。プロンプトに沿ってブートディスクを変更します。
[詳細オプション] セクションを開き、次の操作を行います。
1. [管理] セクションを開きます。
2. [予約] リストで、[使用しない] を選択します。
[作成] をクリックします。

gcloud

MIG でサイズ変更リクエストを作成するように構成されたインスタンステンプレートを作成するには、次のフラグを指定して instance-templates create コマンドを使用します。

--maintenance-policy フラグが TERMINATE に設定されています。
--reservation-affinity フラグが none に設定されています。

たとえば、次のコマンドを使用してリージョンインスタンステンプレートを作成します。グローバルインスタンステンプレートを作成する場合は、--instance-template-region フラグを使用せずに同じコマンドを使用します。

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --reservation-affinity=none

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

INSTANCE_TEMPLATE_NAME: 作成するインスタンステンプレートの名前。
IMAGE_PROJECT: イメージを含むイメージプロジェクト。例: debian-cloud サポートされているイメージプロジェクトの詳細については、公開イメージをご覧ください。
IMAGE_FAMILY: イメージファミリー。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、debian-12 を指定すると、Debian 12 イメージファミリーの最新バージョンが使用されます。イメージファミリーの使用の詳細については、イメージファミリーのベストプラクティスをご覧ください。

debian-12-buster-v20240701 など、特定のバージョンの OS イメージを使用する場合は、--image-family フラグを --image フラグに置き換えます。
REGION: インスタンステンプレートを作成するリージョン。
MACHINE_TYPE: GPU をサポートするマシンタイプ。N1 マシンタイプを指定する場合は、--accelerator フラグを設定して、VM にアタッチする GPU の数とタイプを指定します。

REST

MIG でサイズ変更リクエストを作成するように構成されたインスタンステンプレートを作成するには、次のいずれかのメソッドに POST リクエストを送信します。

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

リクエストの本文で、次の操作を行います。

scheduling.onHostMaintenance フィールドを追加して、TERMINATE に設定します。
reservationAffinity.consumeReservationType フィールドを追加して、NO_RESERVATION に設定します。

たとえば、リージョンインスタンステンプレートを作成するには、次のように POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/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"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "onHostMaintenance": "TERMINATE"
    }
  }
}

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

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

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

MIG を作成または更新する

前のセクションの説明に従ってインスタンステンプレートを作成したら、そのインスタンステンプレートを使用して次のように MIG を作成するか、MIG を更新します。また、サイズ変更リクエスト用に MIG を準備するには、次のことを行う必要があります。

MIG の更新タイプを追従型に設定する（デフォルト）。
修復を無効にする。
MIG で自動スケーリングを構成している場合は、自動スケーリングの構成を削除します。

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

コンソール

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

[インスタンスグループ] に移動
[インスタンスグループの作成] をクリックします。

[インスタンスグループの作成] ページが開きます。
[名前] フィールドに、MIG の名前を入力します。
[インスタンステンプレート] リストで、前のセクションで作成したインスタンステンプレートを選択します。リージョンインスタンステンプレートを選択すると、[リージョン] リストはインスタンステンプレートのリージョンに設定されます。
[ロケーション] セクションで、次の操作を行います。
1. [シングルゾーン] を選択します（まだ選択されていない場合）。
2. MIG のリージョンとゾーンを選択します。
自動スケーリング構成を削除するには、次の操作を行います。
1. [自動スケーリング] セクションで、[自動スケーリングモード] リストをクリックし、[自動スケーリングの構成を削除] をクリックします。
2. 確認ダイアログで [削除] をクリックします。
修復を無効にするには、[VM インスタンスのライフサイクル] セクションで、[障害時のデフォルトのアクション] リストをクリックして、[アクションなし] を選択します。
次のいずれかを行います。
- この時点でサイズ変更リクエストを作成する場合は、次の操作を行います。
  1. [インスタンス数] フィールドに、一度に作成する VM の数を入力します。
  2. [Use resize request to create VMs all at once] チェックボックスをオンにします。
  3. [リクエストされた実行時間] フィールドと [単位] リストで、VM の実行期間を指定します。期間は 1 時間から 7 日の範囲で指定してください。
- それ以外の場合は、[インスタンス数] フィールドに「0」と入力します。後で、サイズ変更リクエストを作成して、グループに VM を追加できます。
[作成] をクリックします。

gcloud

サイズ変更リクエストを作成するように構成されたゾーン MIG を作成するには、--default-action-on-vm-failure フラグを do_nothing に設定して instance-groups managed create コマンドを使用します。

たとえば、リージョンインスタンステンプレートを使用してゾーン MIG を作成するには、次のコマンドを使用します。

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE_URL \
    --size=0 \
    --zone=ZONE \
    --default-action-on-vm-failure=do_nothing

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

INSTANCE_GROUP_NAME: 作成する MIG の名前。
INSTANCE_TEMPLATE_URL: 前のセクションで作成したインスタンステンプレートの部分的な URL。次のいずれかの値を指定します。
- リージョンインスタンステンプレートの場合: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
- グローバルインスタンステンプレートの場合: INSTANCE_TEMPLATE_NAME
ZONE: MIG を作成するゾーン。リージョンインスタンステンプレートを使用して MIG を作成する場合は、テンプレートのリージョン内にのみ MIG を作成できます。

REST

サイズ変更リクエストを作成するように構成されたゾーン MIG を作成するには、instanceGroupManagers.insert メソッドに POST リクエストを行います。リクエストの本文に、DO_NOTHING に設定された defaultActionOnFailure フィールドを含めます。

たとえば、リージョンインスタンステンプレートを使用してゾーン MIG を作成するには、次のように POST リクエストを送信します。

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

{
  "versions": [
    {
      "instanceTemplate": "INSTANCE_TEMPLATE_URL"
    }
  ],
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": 0,
  "instanceLifecyclePolicy": {
    "defaultActionOnFailure": "DO_NOTHING"
  }
}

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

PROJECT_ID: 前のセクションで作成したインスタンステンプレートが配置されているプロジェクトの ID。
ZONE: MIG を作成するゾーン。リージョンインスタンステンプレートを使用して MIG を作成する場合は、テンプレートのリージョン内にのみ MIG を作成できます。
INSTANCE_TEMPLATE_URL: 前のセクションで作成したインスタンステンプレートの部分的な URL。次のいずれかの値を指定します。
- リージョンインスタンステンプレートの場合: regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
- グローバルインスタンステンプレートの場合: global/instanceTemplates/INSTANCE_TEMPLATE_NAME
INSTANCE_GROUP_NAME: 作成する MIG の名前。

ゾーン MIG の作成の詳細については、シングルゾーンに MIG を作成するをご覧ください。