Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

インスタンスの柔軟性を使用して取得可能性を改善する

このドキュメントでは、インスタンスの柔軟性を使用する Batch ジョブを作成して実行する方法について説明します。インスタンスの柔軟性を使用すると、指定した複数のマシンタイプでジョブを実行できます。必要に応じて、ランク付けすることもできます。

ジョブで使用できるマシンタイプを増やすことで、インスタンスの柔軟性を使用して、ジョブを実行できるリソースの確率である取得可能性を向上させることができます。ワークロードに使用する取得可能性機能を決定する方法については、リソースの取得可能性を向上させるをご覧ください。たとえば、インスタンスの柔軟性を使用すると、次のことができます。

リソース可用性エラーと関連するスケジュールの遅延の可能性を減らす。
取得可能性の高いリソースを選択して、ジョブをより早く完了させる。例:
- 並列処理をサポートするジョブで、より多くのインスタンスを取得できる可能性を高める。
- プリエンプトされる可能性の低い Spot VM を取得する。

始める前に

Batch を以前に使用したことがない場合は、 Batch を使ってみるを確認し、プロジェクトとユーザーの前提条件を完了して Batch を有効にします。
ジョブの作成に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- バッチジョブ編集者（roles/batch.jobsEditor）プロジェクトの
- ジョブのサービスアカウントのサービスアカウントユーザー（roles/iam.serviceAccountUser）。これは、デフォルトでは Compute Engine のデフォルトのサービスアカウントです。
ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

制限事項

ジョブでインスタンスの柔軟性を使用する場合、次の制限がすべて適用されます。

取得可能性の向上は、ジョブで使用できるマシンタイプの数に応じて増加します。

重要: ジョブにマシンタイプの要件がない場合は、インスタンスの柔軟性を使用する代わりに、マシンタイプを完全に省略することで、取得可能性をさらに向上させることができます。ただし、 Google Cloud コンソールでジョブを作成する場合や、インスタンステンプレートを使用するジョブを作成する場合は、マシンタイプを省略できません。
ジョブで FLEX_START プロビジョニングモデルまたは RESERVATION_BOUND プロビジョニングモデルを指定することはできません。
ジョブで対象となる特定の予約を使用することはできません。（ reservation フィールドは未定義にするか、NO_RESERVATION に設定する必要があります）。

対象となる特定の予約には、RESERVATION_BOUND プロビジョニングモデルのすべての予約と、STANDARD プロビジョニングモデルの一部の予約が含まれます。インスタンスの作成は予約のマシンタイプでのみ成功するため、これらの機能は本質的に互換性がありません。
各ジョブには最大 50 個のインスタンス選択を設定できます。
ジョブ内の各インスタンス選択には、一意の名前、一意のランク、1 つ以上の一意のマシンタイプが必要です。
マシンタイプを繰り返すことはできません。ジョブごとに 1 つのインスタンス選択にのみ各マシンタイプを含めます。
各ジョブには、インスタンス選択全体で最大 200 個の一意のマシンタイプを設定できます。
同じインスタンス選択で複数のマシンタイプを指定することは省略可能ですが、取得可能性の高いリソースが必要な場合は必須です。
- Batch は、ランクのインスタンス選択に複数のマシンタイプがある場合にのみ、取得可能性が最も高い 1 つ以上のマシンタイプを選択しようとします。たとえば、プリエンプトされる可能性の低い Spot VM をジョブに含める場合や、タスクを並行して実行できるジョブにインスタンスを追加する場合は、この選択が重要になります。
- それ以外の場合、ランクのインスタンス選択にマシンタイプが 1 つしかない場合、インスタンスの柔軟性はリソース可用性エラーの防止にのみ役立ちます。
ジョブに machineTypeフィールドを含めることはできません。ジョブで指定されたインスタンステンプレートのマシンタイプは無視されます。
ジョブに指定するすべてのプロパティが、許可されているすべてのマシンタイプと互換性があることを確認する必要があります。そうしないと、インスタンスを作成できないため、ジョブが送信後に失敗する可能性があります。たとえば、ジョブの次のプロパティが少なくともすべてのマシンタイプと互換性があることを確認することをおすすめします。
- ロケーション（指定されている場合は allowedLocations[] フィールド。それ以外の場合は location）
- タスクあたりのコンピューティングリソース（computeResource フィールド）
- ディスクとイメージ（volumes[] フィールド、disk[] フィールド、bootDisk フィールド）
- ネットワーク（network フィールド）
- その他すべてのインスタンスプロパティ（instances[] サブフィールド）:
  - 最小 CPU プラットフォーム（minCpuPlatform フィールド）
  - プロビジョニングモデル（provisioningModel フィールド）
  - GPU（accelerators[] フィールド）
Batch ジョブのディスクと最小 CPU プラットフォームをオーバーライドすることはできません。すべてのマシンタイプは、指定された値（policy サブフィールドまたはインスタンステンプレート）を使用します。指定されていない場合は、優先度の高いインスタンス選択のマシンタイプのデフォルト値を使用します。そのため、次のすべてを行うことをおすすめします。
- ブートディスクのタイプが、許可されているすべてのマシンタイプと互換性があることを確認します。まとめると、第 4 世代以降のマシンタイプは Persistent Disk をサポートしていません。第 2 世代以前のマシンタイプは Hyperdisk をサポートしていません。第 3 世代以前のマシンタイプはデフォルトで Persistent Disk ブートディスクを使用します。
  
  重要なポイント: ブートディスクの互換性がないため、第 4 世代以降のマシンタイプと第 2 世代以前のマシンタイプを組み合わせることはできません。第 3 世代のマシンタイプをそれ以降のマシンタイプと組み合わせるには、ブートディスクのタイプが Hyperdisk であることを確認してください。
- 許可されているすべてのマシンタイプでサポートされていることを確認するまで、最小 CPU プラットフォームまたは省略可能なディスクを指定しないでください。

複数のマシンタイプを使用できるジョブを作成する

複数のマシンタイプを使用できるジョブを作成するには、次のいずれかの方法を選択します。

gcloud

Google Cloud CLI を使用してジョブを作成するときに複数のマシンタイプを構成するには、次の操作を行います。

ジョブの構成の詳細を指定する JSON ファイルの allocationPolicy フィールドに、 instanceFlexibilityPolicy フィールドとサブフィールドを含めます。instanceFlexibilityPolicy フィールドは、1 つ以上のインスタンス選択をサポートします。各インスタンス選択には、一意の名前、一意のランク、1 つ以上のマシンタイプのリストがあります。
```
"allocationPolicy":{
  "instanceFlexibilityPolicy":{
    "instanceSelections":{
      "INSTANCE_SELECTION_NAME":{
        "rank": RANK,
        "machineTypes": [MACHINE_TYPES]
      }
    }
  }
}
```
次のように置き換えます。
- INSTANCE_SELECTION_NAME: インスタンス選択の名前。ジョブに複数のインスタンス選択がある場合は、このジョブ内の各名前が一意であることを確認してください。
- RANK: 省略可。このインスタンス選択の優先度を表すゼロ以上の整数。値が小さいほど優先度が高くなります。指定しない場合、デフォルト値は 0（最優先）です。ジョブに複数のインスタンス選択がある場合は、このジョブ内の各ランクが一意であることを確認してください。
- MACHINE_TYPES: このインスタンス選択の 1 つ以上のマシンタイプのカンマ区切りのリスト。文字列として記述されます。ジョブごとに 1 つのインスタンス選択にのみ各マシンタイプを含めることができます。たとえば、3 つのマシンタイプのリストは次のように記述できます。
```
"MACHINE_TYPE_1", "MACHINE_TYPE_2", "MACHINE_TYPE_3"
```
  MACHINE_TYPE_1、MACHINE_TYPE_2、MACHINE_TYPE_3 をそれぞれマシンタイプ（e2-micro、e2-small、n1-standard-2 など）に置き換えます。
詳細については、ジョブの例もご覧ください。
この機能はプレビュー版であるため、 gcloud alpha batch jobs submit コマンドを使用してジョブを作成して送信する必要があります。
```
gcloud alpha batch jobs submit JOB_NAME \
  --location LOCATION \
  --config JSON_CONFIGURATION_FILE
```
次のように置き換えます。
- JOB_NAME: ジョブの名前。
- LOCATION: ジョブのロケーション。
- JSON_CONFIGURATION_FILE: ジョブの構成の詳細を含む JSON ファイルへのパス。

REST

Batch API を使用して複数のマシンタイプを使用するジョブを作成するには、この機能がプレビュー版の間に v1alpha jobs.create メソッドを使用します。

ジョブに複数のマシンタイプを指定するには、JSON ファイルの本文の instanceFlexibilityPolicyフィールドとサブフィールドをallocationPolicyフィールドに含めます。instanceFlexibilityPolicy フィールドは、1 つ以上のインスタンス選択をサポートします。各インスタンス選択には、一意の名前、一意のランク、1 つ以上のマシンタイプのリストがあります。

"allocationPolicy":{
  "instanceFlexibilityPolicy":{
    "instanceSelections":{
      "INSTANCE_SELECTION_NAME":{
        "rank": RANK,
        "machineTypes": [MACHINE_TYPES]
      }
    }
  }
}

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

INSTANCE_SELECTION_NAME: インスタンス選択の名前。ジョブに複数のインスタンス選択がある場合は、このジョブ内の各名前が一意であることを確認してください。
RANK: 省略可。このインスタンス選択の優先度を表すゼロ以上の整数。値が小さいほど優先度が高くなります。指定しない場合、デフォルト値は 0（最優先）です。ジョブに複数のインスタンス選択がある場合は、このジョブ内の各ランクが一意であることを確認してください。
MACHINE_TYPES: このインスタンス選択の 1 つ以上のマシンタイプのカンマ区切りのリスト。文字列として記述されます。ジョブごとに 1 つのインスタンス選択にのみ各マシンタイプを含めることができます。たとえば、3 つのマシンタイプのリストは次のように記述できます。
```
"MACHINE_TYPE_1", "MACHINE_TYPE_2", "MACHINE_TYPE_3"
```
MACHINE_TYPE_1、MACHINE_TYPE_2、MACHINE_TYPE_3 をそれぞれマシンタイプ（e2-micro、e2-small、n1-standard-2 など）に置き換えます。

詳細については、ジョブの例もご覧ください。

ジョブの JSON 構成ファイルの例

たとえば、gcloud CLI または Batch API を使用する場合、次の JSON 構成ファイルを使用して、2 つのインスタンス選択を持つ基本的なスクリプトジョブを作成できます。

first-choice という名前のインスタンス選択は、最優先（"rank": 0）で、3 つのマシンタイプ（e2-micro、e2-small、および n1-standard-2）があります。
second-choice という名前のインスタンス選択は、2 番目の優先度（"rank": 1）で、1 つのマシンタイプ（e2-medium）があります。

{
  "taskGroups": [
    {
      "taskSpec": {
        "runnables": [
          {
            "script": {
              "text": "echo Hello World! This is task $BATCH_TASK_INDEX."
            }
          }
        ]
      },
      "taskCount": 3
    }
  ],
  "allocationPolicy":{
    "instanceFlexibilityPolicy":{
      "instanceSelections":{
        "first-choice":{
          "rank": 0,
          "machineTypes": ["e2-micro", "e2-small", "n1-standard-2"]
        },
        "second-choice":{
          "rank": 1,
          "machineTypes": ["e2-medium"]
        }
      }
    }
  }
}

次のステップ

ジョブの作成または実行で問題が発生した場合は、トラブルシューティングをご覧ください。
ジョブとタスクを表示する。
別のジョブ作成オプションについて学習する。