AMI 선택 순서

시작 템플릿 재정의 AMI - 시작된 인스턴스에 대한 시작 템플릿 재정의에 이미지가 있는 경우 해당 이미지가 사용됩니다.

컴퓨팅 리소스 이미지 ID(사용되지 않음) - 설정하면이 컴퓨팅 환경 AMI가 사용됩니다. 참고: 더 이상 사용되지 않는 필드입니다. 대신 ec2Configuration.imageIdOverride를 사용합니다.

EC2 구성 이미지 ID 재정의 - 지정된 경우이 필드의 이미지가 사용됩니다.

시작 템플릿 AMI - 컴퓨팅 환경에 이미지와 연결된 시작 템플릿이 있는 경우이 이미지가 사용됩니다.

AWS 기본 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"
      }
    ]
  }
}