Ordem de seleção da AMI

AMI de substituição do modelo de execução: se uma substituição do modelo de execução da instância executada tiver uma imagem, essa imagem será usada.

ID da imagem de recursos computacionais (obsoleto) — se definido, essa AMI de ambiente computacional será usada. Nota: Campo obsoleto; use EC2Configuration. imageIdOverride em vez disso.

Substituição da ID da imagem de configuração do EC2 - Se especificada, a imagem nesse campo será usada.

AMI do modelo de execução: se o ambiente computacional tiver um modelo de execução associado a uma imagem, essa imagem será usada.

AWS AMI padrão - Se nenhuma das opções acima estiver configurada, AWS Batch seleciona uma AMI padrão com base no tipo de imagem especificado na configuração do EC2.

O modelo de lançamento substitui a AMI (precedência mais alta)

Campo de API: overrides[].launchTemplateId com tipos de instância de destino

Referência: LaunchTemplateSpecification

Os modelos de substituição têm como alvo tipos de instância específicos e fornecem um controle mais granular do que o modelo de execução padrão. Elas têm precedência sobre todas as outras especificações da AMI para combinar os tipos de instância.

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

ID da imagem dos recursos de computação

Campo da API: computeResources.imageId

Referência: CreateComputeEnvironment

Você pode especificar uma AMI diretamente no nível do ambiente computacional. Isso tem precedência sobre as substituições de configuração e os modelos de execução do EC2 (exceto os modelos de substituição).

Em um ambiente computacional com várias configurações do EC2 (por exemplo, para ECS_AL2023 eECS_AL2023_NVIDIA), o ID da AMI especificado aqui é usado para todas as configurações do EC2.

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

Substituição do ID da imagem de configuração do EC2

Campo da API: computeResources.ec2Configuration[].imageIdOverride

Referência: Ec2Configuration

A configuração do EC2 fornece substituições específicas do tipo de imagem. Essa configuração substitui a seleção padrão da AMI e o modelo de execução da AMI para o tipo de imagem especificado.

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

Inicie o modelo AMI

Campo API: ImageId no modelo de lançamento do Amazon EC2

Referência: Use os modelos de lançamento do Amazon EC2 com AWS Batch

Quando você especifica uma AMI no modelo de execução, ela tem precedência sobre a seleção padrão da AMI, mas é substituída por configurações de precedência mais altas.

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

Referenciado pelo modelo de AWS Batch lançamento:

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

AWS AMI padrão (precedência mais baixa)

Campo da API: determinado por computeResources.ec2Configuration[].imageType

Referência: Ec2 Configuration ImageType

Quando nenhuma AMI personalizada é especificada, seleciona AWS Batch automaticamente a última AMI otimizada para Amazon Amazon ECS aprovada com base no tipo de imagem.

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