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

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

準備

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

このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
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. デフォルトのリージョンとゾーンを設定します。
REST

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

必要なロール

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 に設定されています。

たとえば、次のコマンドを使用します。

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

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

INSTANCE_TEMPLATE_NAME: 作成するインスタンステンプレートの名前。
IMAGE_PROJECT: イメージを含むイメージプロジェクト。例: debian-cloud サポートされているイメージプロジェクトの詳細については、公開イメージをご覧ください。
IMAGE_FAMILY または IMAGE: 次のいずれかを指定します。
- IMAGE_FAMILY: イメージファミリー。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、debian-10 を指定すると、Debian 10 イメージファミリーの最新バージョンが使用されます。イメージファミリーの使用の詳細については、イメージファミリーのベストプラクティスをご覧ください。
- IMAGE: OS イメージの特定のバージョン。例: debian-10-buster-v20200309 特定のバージョンの OS イメージを指定する場合は、--image-family フラグを --image フラグに置き換える必要があります。
MACHINE_TYPE: GPU をサポートするマシンタイプ。N1 マシンタイプを指定する場合は、--accelerator フラグを設定して、VM にアタッチする GPU の数とタイプを指定します。

REST

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

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

たとえば、次のように POST リクエストを作成します。

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "mode": "READ_WRITE",
        "type": "PERSISTENT",
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ],
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "onHostMaintenance": "TERMINATE"
    }
  }
}

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

PROJECT_ID: インスタンステンプレートを作成するプロジェクトの ID。
INSTANCE_TEMPLATE_NAME: 作成するインスタンステンプレートの名前。
IMAGE_PROJECT: イメージを含むイメージプロジェクト。例: debian-cloud サポートされているイメージプロジェクトの詳細については、公開イメージをご覧ください。
IMAGE または IMAGE_FAMILY: 次のいずれかを指定します。
- IMAGE: OS イメージの特定のバージョン。例: debian-10-buster-v20200309
- IMAGE_FAMILY: イメージファミリー。これにより、非推奨ではない最新の OS イメージが指定されます。たとえば、family/debian-10 を指定すると、Debian 10 イメージファミリーの最新バージョンが使用されます。イメージファミリーの使用の詳細については、イメージファミリーのベストプラクティスをご覧ください。
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 コマンドを使用します。

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

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

INSTANCE_GROUP_NAME: 作成する MIG の名前。
INSTANCE_TEMPLATE_NAME: 前のセクションで作成したインスタンステンプレートの名前。
ZONE: MIG を作成するゾーン。

REST

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

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

{
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    }
  ],
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": 0,
  "instanceLifecyclePolicy": {
    "defaultActionOnFailure": "DO_NOTHING"
  }
}

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

PROJECT_ID: 前のセクションで作成したインスタンステンプレートが配置されているプロジェクトの ID。
ZONE: MIG を作成するゾーン。
INSTANCE_TEMPLATE_NAME: 前のセクションで作成したインスタンステンプレートの名前。
INSTANCE_GROUP_NAME: 作成する MIG の名前。