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

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

MIG サイズ変更リクエストを作成すると、GPU などの需要の高いリソースを取得し、正確な数の VM を一度に作成して費用を最適化できます。Cluster Director で利用可能な機能とサービスを使用できる MIG サイズ変更リクエストを作成するには、AI Hypercomputer のドキュメントで MIG とサイズ変更リクエストを作成するをご覧ください。

始める前に

リクエストするリソースに十分な 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

必要なロール

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 サイズ変更リクエストを作成するように構成されたインスタンステンプレートを作成するには、テンプレートで次の項目を指定します。

ホストメンテナンスイベント中に VM を停止します。
実行期間の終了時に VM を削除します。
予約は使用しないでください。
Flex Start プロビジョニングモデルを使用します。

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

コンソール

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

[インスタンステンプレート] に移動
[インスタンステンプレートを作成] をクリックします。[インスタンステンプレートの作成] ページが開きます。
[名前] フィールドに、インスタンステンプレートの名前を入力します。
[ロケーション] セクションで、次のいずれかのオプションを選択します。
- リージョンインスタンステンプレートを作成するには、[リージョン（推奨）] を選択し、テンプレートを作成するリージョンを選択します。
- グローバルインスタンステンプレートを作成するには、[グローバル] を選択します。
[マシンの構成] セクションで、次の操作を行います。
1. [GPU] タブをクリックします。
2. [GPU のタイプ] リストで、GPU のタイプを選択します。
3. [GPU の数] リストで、GPU の数を選択します。
4. 省略可: GPU モデルがグラフィックワークロード用の NVIDIA RTX 仮想ワークステーション（vWS）グラフィックを多用するワークロードを実行する場合は、仮想ワークステーション（NVIDIA GRID）を有効にするをご覧ください。
5. [マシンタイプ] セクションでマシンタイプを選択します。
[プロビジョニングモデル] セクションで、次の操作を行います。
1. [VM プロビジョニングモデル] リストで、[Flex Start] を選択します。
  
  注: Flex Start プロビジョニングモデルを選択すると、予約を使用できません。 Google Cloud コンソールで、[詳細オプション] > [管理] > [予約] セクションで [予約を使用しない] オプションが自動的に選択されます。
2. インスタンステンプレートによって作成される VM の実行時間を設定するには、[時間を入力] フィールドに時間数を入力します。値は 1 時間（1）～7 日間（168）の範囲で指定してください。
省略可: デフォルト値のブートディスクのタイプまたはイメージを変更するには、[ブートディスク] セクションで [変更] をクリックします。プロンプトに従ってブートディスクを変更します。
[作成] をクリックします。

gcloud

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

--maintenance-policy フラグ。TERMINATE に設定します。
--instance-termination-action フラグ。DELETE に設定します。
--max-run-duration フラグ。
--provisioning-model フラグ。FLEX_START に設定します。
--reservation-affinity フラグ。none に設定します。

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

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-termination-action=DELETE \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --max-run-duration=RUN_DURATION \
    --provisioning-model=FLEX_START \
    --reservation-affinity=none

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

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

注: debian-12-bookworm-v20240701 など、特定のバージョンの OS イメージを使用する場合は、--image-family フラグを --image フラグに置き換えます。
REGION: インスタンステンプレートを作成するリージョン。
MACHINE_TYPE: GPU マシンタイプ。N1 マシンタイプを指定する場合は、--accelerator フラグを設定して、VM にアタッチする GPU の数とタイプを定義します。
RUN_DURATION: リクエストされた VM を実行する期間。値は、日数、時間、分、秒として指定し、その後にそれぞれ d、h、m、s を続ける必要があります。たとえば、30 分の場合は 30m を指定し、1 日と 2 時間 3 分 4 秒の場合は 1d2h3m4s を指定します。値は 10 分～7 日の範囲で指定してください。

REST

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

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

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

scheduling.onHostMaintenance フィールド。TERMINATE に設定します。
scheduling.instanceTerminationAction フィールド。DELETE に設定します。
scheduling.maxRunDuration フィールド。
scheduling.provisioningModel フィールド。FLEX_START に設定します。
reservationAffinity.consumeReservationType フィールド。NO_RESERVATION に設定します。

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

POST https://compute.googleapis.com/compute/beta/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": {
      "instanceTerminationAction": "DELETE",
      "maxRunDuration": {
        "seconds": RUN_DURATION
      },
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "FLEX_START"
    }
  }
}

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

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 の数とタイプを定義します。
RUN_DURATION: リクエストされた VM の実行時間（秒単位）。値は 600（600 秒、10 分）から 604800（604,800 秒、7 日間）の範囲で指定する必要があります。

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

MIG を作成または更新する

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

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

サイズ変更リクエストと互換性のある MIG を作成するには、次のいずれかのオプションを選択します。

コンソール

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

[インスタンスグループ] に移動
[インスタンスグループを作成] をクリックします。[インスタンスグループの作成] ページが開きます。
[名前] フィールドに、MIG の名前を入力します。
インスタンステンプレートを選択する前に、自動スケーリングの構成を削除し、次のように修復を無効にする必要があります。
1. 自動スケーリング構成を削除するには、次の操作を行います。
  1. [自動スケーリング] セクションで、[自動スケーリングモード] リストをクリックし、[自動スケーリングの構成を削除] をクリックします。
  2. 確認ダイアログで [削除] をクリックします。
2. 修復を無効にするには、[VM インスタンスのライフサイクル] セクションで、[障害発生時のデフォルトのアクション] リストをクリックして、[アクションなし] を選択します。
[インスタンステンプレート] フィールドに戻ります。[インスタンステンプレート] リストで、前のセクションで作成したインスタンステンプレートを選択します。リージョンインスタンステンプレートを選択すると、[リージョン] リストはテンプレートのリージョンに設定されます。
次のいずれかを行います。
- MIG の作成時にサイズ変更リクエストを作成するには、次の操作を行います。
  1. [インスタンス数] フィールドに、一度に作成する VM の数を入力します。
  2. [サイズ変更リクエストを使用して VM を一度に作成する] チェックボックスを選択します。
  3. 省略可: インスタンステンプレートで設定された実行時間とは異なる実行時間を VM に指定するには、[リクエストされた実行時間] フィールドと [単位] リストで期間を指定します。期間は 1 時間～7 日の範囲で指定してください。
- MIG の作成後にサイズ変更リクエストを作成するには、[インスタンス数] フィールドに「0」と入力します。
[ロケーション] セクションで、ゾーン MIG またはリージョン MIG を作成するかどうかを次のように指定します。
1. ゾーン MIG を作成するには、[単一ゾーン] を選択します。リージョン MIG を作成する場合は、[マルチゾーン] を選択します。
2. MIG のリージョンとゾーンを選択します。
3. リージョン MIG を作成する場合は、次の操作を行います。
  1. [ターゲット分配形態] フィールドで、[任意のシングルゾーン] を選択します。
  2. 表示されたダイアログで、[インスタンスの再分配を無効化] をクリックします。
[作成] をクリックします。

gcloud

--default-action-on-vm-failure フラグを do_nothing に設定して instance-groups managed create コマンドを使用します。リージョン MIG を作成する場合は、--target-distribution-shape フラグを any-single-zone に設定し、--instance-redistribution-type フラグを none に設定することも必要です。

ゾーン 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

リージョン MIG を作成するには、次のコマンドを実行します。

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE_URL \
    --size=0 \
    --region=REGION \
    --target-distribution-shape=any-single-zone \
    --instance-redistribution-type=none \
    --default-action-on-vm-failure=do_nothing

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

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

REST

ゾーン MIG を作成するには、次のように instanceGroupManagers.insert メソッドを使用して 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"
  }
}

リージョン MIG を作成するには、次のように regionInstanceGroupManagers.insert メソッドを使用して POST リクエストを送信します。

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

{
  "versions": [
    {
      "instanceTemplate": "INSTANCE_TEMPLATE_URL"
    }
  ],
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": 0,
  "distributionPolicy": {
    "targetShape": "ANY_SINGLE_ZONE"
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  },
  "instanceLifecyclePolicy": {
    "defaultActionOnFailure": "DO_NOTHING"
  }
}

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

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