AMI 選択順序

起動テンプレートオーバーライド AMI - 起動されたインスタンスの起動テンプレートオーバーライドにイメージがある場合、そのイメージが使用されます。

コンピューティングリソースイメージ ID (非推奨) - 設定されている場合、このコンピューティング環境 AMI が使用されます。注: 非推奨のフィールド。代わりに ec2Configuration.imageIdOverride を使用してください。

EC2 設定イメージ ID オーバーライド - 指定した場合、このフィールドのイメージが使用されます。

起動テンプレート AMI - コンピューティング環境にイメージに関連付けられた起動テンプレートがある場合、このイメージが使用されます。

AWS default AMI - 上記のいずれも設定されていない場合、 は ec2Configuration で指定された imageType に基づいてデフォルトの AMI AWS Batch を選択します。

起動テンプレートオーバーライド AMI (最高優先順位)

API フィールド: ターゲットインスタンスタイプoverrides[].launchTemplateIdを含む

リファレンス: LaunchTemplateSpecification

テンプレートを上書きすると、特定のインスタンスタイプがターゲットになり、デフォルトの起動テンプレートよりも詳細な制御が可能になります。これらは、一致するインスタンスタイプの他のすべての AMI 仕様よりも優先されます。

{
  "computeResources": {
    "launchTemplate": {
      "launchTemplateId": "lt-default",
      "overrides": [
        {
          "launchTemplateId": "lt-gpu-optimized",
          "targetInstanceTypes": ["p3.2xlarge", "g4dn.xlarge"]
        }
      ]
    }
  }
}

コンピューティングリソースイメージ ID

API フィールド: computeResources.imageId

リファレンス: CreateComputeEnvironment

コンピューティング環境レベルで AMI を直接指定できます。これは、EC2 設定オーバーライドと起動テンプレート (オーバーライドテンプレートを除く) よりも優先されます。

複数の EC2 設定 (例: ECS_AL2023および ECS_AL2023_NVIDIA) を持つコンピューティング環境では、ここで指定された AMI ID がすべての EC2 設定に使用されます。

{
  "computeResources": {
    "imageId": "ami-12345678",
    "instanceTypes": ["m5.large", "m5.xlarge"]
  }
}

EC2 設定イメージ ID の上書き

API フィールド: computeResources.ec2Configuration[].imageIdOverride

リファレンス: Ec2Configuration

EC2 設定は、イメージタイプ固有のオーバーライドを提供します。この設定は、指定されたイメージタイプのデフォルトの AMI 選択と起動テンプレート AMI を上書きします。

{
  "computeResources": {
    "ec2Configuration": [
      {
        "imageType": "ECS_AL2",
        "imageIdOverride": "ami-87654321"
      }
    ]
  }
}

テンプレート AMI を起動する

API フィールド: Amazon EC2 起動テンプレートImageIdの

リファレンス: で Amazon EC2 起動テンプレートを使用する AWS Batch

起動テンプレートで AMI を指定すると、デフォルトの AMI 選択よりも優先されますが、優先順位の設定が高いほど上書きされます。

// EC2 Launch Template content
{
  "LaunchTemplateName": "my-batch-template",
  "LaunchTemplateData": {
    "ImageId": "ami-12345678"
  }
}

AWS Batch 起動テンプレートによって参照されます。

// Batch Launch Template content
{
  "computeResources": {
    "launchTemplate": {
      "launchTemplateName": "my-batch-template",
      "version": "$Latest"
    }
  }
}

AWS デフォルトの AMI (最も低い優先順位)

API フィールド: によって決定 computeResources.ec2Configuration[].imageType

リファレンス: Ec2Configuration imageType

カスタム AMI が指定されていない場合、 はイメージタイプに基づいて、承認された最新の Amazon ECS 最適化 AMI AWS Batch を自動的に選択します。

{
  "computeResources": {
    "ec2Configuration": [
      {
        "imageType": "ECS_AL2023"
      }
    ]
  }
}