Ordre de sélection de l'AMI

AMI de remplacement du modèle de lancement : si une modification du modèle de lancement pour l'instance lancée contient une image, celle-ci est utilisée.

ID d'image des ressources informatiques (obsolète) : si cette option est définie, cette AMI d'environnement de calcul est utilisée. Remarque : champ obsolète ; utilisez EC2Configuration. imageIdOverride à la place.

Modification de l'ID de l'image de configuration EC2 : si cela est spécifié, l'image de ce champ est utilisée.

Modèle de lancement AMI : si l'environnement de calcul possède un modèle de lancement associé à une image, cette image sera utilisée.

AWS AMI par défaut - Si aucune des options ci-dessus n'est configurée, AWS Batch sélectionne une AMI par défaut en fonction du type d'image spécifié dans la configuration EC2.

Le modèle de lancement remplace l'AMI (priorité la plus élevée)

Champ API : overrides[].launchTemplateId avec les types d'instances cibles

Référence : LaunchTemplateSpecification

Les modèles de remplacement ciblent des types d'instances spécifiques et fournissent un contrôle plus précis que le modèle de lancement par défaut. Elles ont priorité sur toutes les autres spécifications de l'AMI pour les types d'instances correspondants.

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

ID de l'image des ressources informatiques

Champ API : computeResources.imageId

Référence : CreateComputeEnvironment

Vous pouvez spécifier une AMI directement au niveau de l'environnement informatique. Cela a priorité sur les remplacements de configuration EC2 et les modèles de lancement (à l'exception des modèles de remplacement).

Dans un environnement informatique comportant plusieurs configurations EC2 (par exemple pour ECS_AL2023 etECS_AL2023_NVIDIA), l'ID d'AMI spécifié ici est utilisé pour toutes les configurations EC2.

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

Modification de l'ID de l'image de configuration EC2

Champ API : computeResources.ec2Configuration[].imageIdOverride

Référence : Ec2Configuration

La configuration EC2 fournit des remplacements spécifiques au type d'image. Ce paramètre remplace la sélection d'AMI par défaut et l'AMI modèle de lancement pour le type d'image spécifié.

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

Modèle de lancement AMI

Champ API : ImageId dans le modèle de lancement Amazon EC2

Référence : Utilisez les modèles de lancement Amazon EC2 avec AWS Batch

Lorsque vous spécifiez une AMI dans le modèle de lancement, elle a priorité sur la sélection d'AMI par défaut, mais elle est remplacée par des paramètres de priorité plus élevés.

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

Référencé par le modèle de AWS Batch lancement :

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

AWS AMI par défaut (priorité la plus basse)

Champ API : déterminé par computeResources.ec2Configuration[].imageType

Référence : Ec2Configuration ImageType

Lorsqu'aucune AMI personnalisée n'est spécifiée, sélectionne AWS Batch automatiquement la dernière AMI optimisée pour Amazon ECS approuvée en fonction du type d'image.

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