AMI-Auswahlreihenfolge

AMI für Startvorlagen überschreiben — Wenn eine Startvorlagen-Überschreibung für die gestartete Instance über ein Image verfügt, wird das zugehörige Image verwendet.

Compute Resources Image ID (veraltet) — Falls gesetzt, wird dieses Compute-Environment-AMI verwendet. Hinweis: Dieses Feld ist veraltet. Verwenden Sie EC2Configuration. imageIdOverride stattdessen.

Image-ID der EC2-Konfiguration außer Kraft setzen — Falls angegeben, wird das Bild in diesem Feld verwendet.

Startvorlage AMI — Wenn der Rechenumgebung eine Startvorlage mit einem Image verknüpft ist, wird dieses Image verwendet.

AWS Standard-AMI — Wenn keines der oben genannten Optionen konfiguriert ist, AWS Batch wird ein Standard-AMI ausgewählt, das auf dem angegebenen ImageType in der EC2-Konfiguration basiert.

AMI mit Startvorlage überschreiben (höchste Priorität)

API-Feld: overrides[].launchTemplateId mit Zielinstanztypen

Referenz: LaunchTemplateSpecification

Override-Vorlagen zielen auf bestimmte Instance-Typen ab und bieten eine detailliertere Steuerung als die Standard-Startvorlage. Sie haben Vorrang vor allen anderen AMI-Spezifikationen für übereinstimmende Instance-Typen.

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

Image-ID der Ressourcen berechnen

API-Feld: computeResources.imageId

Referenz: CreateComputeEnvironment

Sie können ein AMI direkt auf der Ebene der Rechenumgebung angeben. Dies hat Vorrang vor EC2-Konfigurationsüberschreibungen und Startvorlagen (außer Override-Vorlagen).

In einer Rechenumgebung mit mehreren EC2-Konfigurationen (z. B. für ECS_AL2023 undECS_AL2023_NVIDIA) wird die hier angegebene AMI-ID für alle EC2-Konfigurationen verwendet.

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

Image-ID der EC2-Konfiguration überschreiben

API-Feld: computeResources.ec2Configuration[].imageIdOverride

Referenz: Ec2Configuration

Die EC2-Konfiguration bietet bildtypspezifische Überschreibungen. Diese Einstellung überschreibt die standardmäßige AMI-Auswahl und das Startvorlagen-AMI für den angegebenen Imagetyp.

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

Vorlagen-AMI starten

API-Feld: ImageId in der Amazon EC2 EC2-Startvorlage

Referenz: Verwenden Sie Amazon EC2 EC2-Startvorlagen mit AWS Batch

Wenn Sie in der Startvorlage ein AMI angeben, hat es Vorrang vor der Standard-AMI-Auswahl, wird jedoch durch Einstellungen mit höherer Priorität außer Kraft gesetzt.

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

In der Startvorlage wird darauf verwiesen: AWS Batch

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

AWS Standard-AMI (niedrigste Priorität)

API-Feld: Bestimmt von computeResources.ec2Configuration[].imageType

Referenz: Ec2Configuration ImageType

Wenn kein benutzerdefiniertes AMI angegeben ist, wird AWS Batch automatisch das neueste genehmigte Amazon Amazon ECS-optimierte AMI basierend auf dem Image-Typ ausgewählt.

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