Umgebungsparameter berechnen

Rechenumgebungen sind in mehrere grundlegende Komponenten aufgeteilt: Name, Typ und Status der Rechenumgebung, die Rechenressourcendefinition (falls es sich um eine verwaltete Computerumgebung handelt), die Amazon EKS-Konfiguration (wenn sie Amazon EKS-Ressourcen verwendet), die Servicerolle, die verwendet werden soll, um IAM-Berechtigungen zu erteilen AWS Batch, und die Tags für die Rechenumgebung.

Name der Rechenumgebung

computeEnvironmentName

Der Name für Ihre Datenverarbeitungsumgebung. Der Name kann bis zu 128 Zeichen lang sein. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (_) enthalten.

Typ: Zeichenfolge

Erforderlich: Ja

Typ

type

Der Typ der Datenverarbeitungsumgebung. Wählen SieMANAGED, ob Sie die AWS Batch von Ihnen definierten EC2- oder Fargate-Rechenressourcen verwalten lassen möchten. Weitere Informationen finden Sie unter Ressourcen berechnen. UNMANAGEDEntscheiden Sie sich dafür, Ihre eigenen EC2-Rechenressourcen zu verwalten.

Typ: Zeichenfolge

Zulässige Werte: MANAGED | UNMANAGED

Erforderlich: Ja

Status

state

Der Status der Datenverarbeitungsumgebung.

Wenn der Status lautetENABLED, versucht der AWS Batch Scheduler, Jobs innerhalb der Umgebung zu platzieren. Diese Jobs stammen aus einer zugehörigen Auftragswarteschlange auf den Rechenressourcen. Wenn die Rechenumgebung verwaltet wird, werden die Instanzen je nach Bedarf in der Auftragswarteschlange automatisch nach oben oder unten skaliert.

Wenn der Status so istDISABLED, versucht der AWS Batch Scheduler nicht, Jobs innerhalb der Umgebung zu platzieren. Jobs, die sich im RUNNING Status STARTING oder befinden, werden weiterhin normal bearbeitet. Verwaltete Computerumgebungen, die sich im DISABLED Bundesstaat befinden, lassen sich nicht skalieren.

Anmerkung

Für Computerumgebungen in einem DISABLED Bundesstaat können weiterhin Abrechnungsgebühren anfallen. Um zusätzliche Gebühren zu vermeiden, schalten Sie die Rechenumgebung aus und löschen Sie sie anschließend. Weitere Informationen finden Sie DeleteComputeEnvironmentin der AWS Batch API-Referenz und unter Vermeidung unerwarteter Gebühren im AWS Billing Benutzerhandbuch.

Wenn sich eine Instance im Leerlauf befindet, wird die Instance auf den minvCpus Wert herunterskaliert. Die Instanzgröße ändert sich jedoch nicht. Stellen Sie sich zum Beispiel eine c5.8xlarge Instanz mit einem minvCpus Wert von 4 und einem desiredvCpus Wert von vor36. Diese Instanz lässt sich nicht auf eine c5.large Instanz herunterskalieren.

Typ: Zeichenfolge

Zulässige Werte: ENABLED | DISABLED

Erforderlich: Nein

Ressourcen berechnen

computeResources

Details der Datenverarbeitungsressourcen, die von der Datenverarbeitungsumgebung verwaltet werden. Weitere Informationen finden Sie unter Datenverarbeitungsumgebung.

Typ: ComputeResource Objekt

Erforderlich: Dieser Parameter ist für verwaltete Rechenumgebungen erforderlich

type

Der Typ der Datenverarbeitungsumgebung. Sie können wählen, ob Sie EC2 On-Demand-Instances (EC2) und EC2-Spot-Instances (SPOT) oder Fargate-Kapazität (FARGATE) und Fargate-Spot-Kapazität (FARGATE_SPOT) in Ihrer verwalteten Rechenumgebung verwenden möchten. Wenn Sie SPOT auswählen, müssen Sie auch eine Amazon EC2-Spot-Flottenrolle mit dem Parameter spotIamFleetRole angeben. Weitere Informationen finden Sie unter Amazon EC2-Spot-Flottenrolle.

Zulässige Werte: EC2 | SPOT | FARGATE | FARGATE_SPOT

Erforderlich: Ja

allocationStrategy

Die Zuweisungsstrategie, die für die Rechenressource verwendet werden soll, wenn nicht genügend Instances des am besten geeigneten EC2-Instance-Typs zugewiesen werden können. Dies kann an der Verfügbarkeit des Instance-Typs in den AWS-Region oder an den Amazon EC2-Servicelimits liegen. Weitere Informationen finden Sie unter Zuweisungsstrategien.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

BEST_FIT (Standard)

AWS Batch wählt einen Instance-Typ aus, der den Anforderungen der Jobs am besten entspricht, wobei der Instance-Typ mit den niedrigsten Kosten bevorzugt wird. Wenn zusätzliche Instances des ausgewählten Instance-Typs nicht verfügbar sind, wird AWS Batch gewartet, bis die zusätzlichen Instances verfügbar sind. Wenn nicht genügend Instances verfügbar sind oder wenn Sie die Amazon EC2-Servicelimits überschreiten, werden zusätzliche Jobs erst ausgeführt, nachdem die aktuell ausgeführten Jobs abgeschlossen sind. Diese Zuweisungsstrategie hält die Kosten niedriger, kann aber die Skalierung einschränken. Wenn Sie Spot-Flotten mit verwendenBEST_FIT, muss die IAM-Rolle Spot-Flotte angegeben werden. Rechenressourcen, die eine BEST_FIT Zuweisungsstrategie verwenden, unterstützen keine Infrastrukturaktualisierungen und können einige Parameter nicht aktualisieren. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Anmerkung

BEST_FITwird für Rechenumgebungen, die Amazon EKS-Ressourcen verwenden, nicht unterstützt.

BEST_FIT_PROGRESSIVE

Verwenden Sie zusätzliche Instance-Typen, die groß genug sind, um die Anforderungen der Jobs in der Warteschlange zu erfüllen. Bevorzugen Sie Instance-Typen mit niedrigeren Kosten für jede vCPU-Einheit. Wenn zusätzliche Instances der zuvor ausgewählten Instanztypen nicht verfügbar sind, AWS Batch wählt neue Instanztypen aus.

SPOT_CAPACITY_OPTIMIZED

(Nur für Spot-Instance-Rechenressourcen verfügbar) Verwenden Sie zusätzliche Instance-Typen, die groß genug sind, um die Anforderungen der Jobs in der Warteschlange zu erfüllen. Bevorzugen Sie Instance-Typen, bei denen die Wahrscheinlichkeit einer Unterbrechung geringer ist.

SPOT_PRICE_CAPACITY_OPTIMIZED

(Nur für Spot-Instance-Rechenressourcen verfügbar) Bei der preis- und kapazitätsoptimierten Zuweisungsstrategie werden sowohl der Preis als auch die Kapazität berücksichtigt, um die Spot-Instance-Pools auszuwählen, bei denen die Wahrscheinlichkeit einer Unterbrechung am geringsten ist und die den niedrigstmöglichen Preis haben.

Anmerkung

Wir empfehlen, dass Sie SPOT_PRICE_CAPACITY_OPTIMIZED eher als SPOT_CAPACITY_OPTIMIZED in den meisten Instances verwenden.

Bei SPOT_PRICE_CAPACITY_OPTIMIZED Strategien BEST_FIT_PROGRESSIVESPOT_CAPACITY_OPTIMIZED, bei denen On-Demand-Instances oder Spot-Instances verwendet werden, und bei der BEST_FIT Strategie, die Spot-Instances verwendet, müssen AWS Batch möglicherweise höhere Anforderungen erfüllt werden, maxvCpus um Ihre Kapazitätsanforderungen zu erfüllen. Überschreitet maxvCpus in diesem Fall AWS Batch nie mehr als eine einzelne Instance.

Zulässige Werte: BEST_FIT | BEST_FIT_PROGRESSIVE | SPOT_CAPACITY_OPTIMIZED | SPOT_PRICE_CAPACITY_OPTIMIZED

Erforderlich: Nein

minvCpus

Die Mindestanzahl von vCPUs, die eine Umgebung verwaltet, auch wenn es sich um eine Rechenumgebung handelt. DISABLED

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Typ: Ganzzahl

Erforderlich: Nein

maxvCpus

Die maximale Anzahl von vCPUs, die die AWS Batch Rechenumgebung unterstützen kann.

Anmerkung

Bei BEST_FIT_PROGRESSIVESPOT_CAPACITY_OPTIMIZED, und SPOT_PRICE_CAPACITY_OPTIMIZED Zuweisungsstrategien mit On-Demand-Instances oder Spot-Instances und bei der BEST_FIT Strategie, bei der Spot-Instances verwendet werden, müssen AWS Batch möglicherweise höhere Werte erreicht werden, maxvCpus um Ihre Kapazitätsanforderungen zu erfüllen. In diesem Fall maxvCpus wird AWS Batch niemals mehr als eine einzige Instance überschritten. AWS Batch Verwendet beispielsweise nicht mehr als eine einzelne Instanz aus den in Ihrer Rechenumgebung angegebenen Instanzen.

Typ: Ganzzahl

Erforderlich: Nein

desiredvCpus

Die gewünschte Anzahl von vCPUs in der Rechenumgebung. AWS Batch ändert diesen Wert je nach Nachfrage in der Job-Warteschlange zwischen dem Minimal- und dem Maximalwert.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Typ: Ganzzahl

Erforderlich: Nein

instanceTypes

Die Instance-Typen, die gestartet werden können. Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden. Geben Sie es nicht an. Sie können Instance-Familien angeben, um jeden Instance-Typ innerhalb dieser Familien zu starten (z. B.c5,c5n, oderp3). Sie können auch bestimmte Größen innerhalb einer Familie angeben (z. B.c5.8xlarge). Beachten Sie, dass Metallexemplartypen nicht zu den Exemplarfamilien gehören (z. B. c5 nicht c5.metal enthalten) Außerdem können Sie optimal wählen, um Instance-Typen (aus den C-, M- und R-Instance-Familien) auszuwählen, die den Anforderungen der Auftragswarteschlangen entsprechen.

Anmerkung

Wenn Sie eine Compute-Umgebung erstellen, müssen die Instance-Typen, die Sie für die Compute-Umgebung auswählen, dieselbe Architektur verwenden. Beispielsweise ist es nicht möglich, x86- und ARM-Instances in derselben Compute-Umgebung zu kombinieren.

Anmerkung

Derzeit nutzt optimal Instance-Typen aus den Instance-Familien C4, M4 und R4. Falls AWS-Regionen es keine Instance-Typen aus diesen Instance-Familien gibt, werden Instance-Typen aus den Instance-Familien C5, M5 und R5 verwendet.

Typ: Zeichenfolgen-Array

Erforderlich: Ja

imageId

Dieser Parameter ist veraltet.

Die Amazon Machine Image (AMI)-ID, die für in der Datenverarbeitungsumgebung gestartete Instances verwendet wird. Dieser Parameter wird vom imageIdOverride-Mitglied der Ec2Configuration-Struktur überschrieben.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Anmerkung

Das AMI, das Sie für eine Rechenumgebung auswählen, muss der Architektur der Instance-Typen entsprechen, die Sie für diese Rechenumgebung verwenden möchten. Wenn Ihre Rechenumgebung beispielsweise A1 Instanztypen verwendet, muss das von Ihnen gewählte Compute-Ressourcen-AMI Arm Instances unterstützen. Amazon ECS verkauft x86 sowohl Arm Versionen als auch Versionen des für Amazon ECS optimierten Amazon Linux 2-AMI. Weitere Informationen finden Sie unter Amazon ECS-optimiertes Amazon Linux 2-AMI im Amazon Elastic Container Service Developer Guide.

Typ: Zeichenfolge

Erforderlich: Nein

subnets

Die VPC-Subnetze, in denen die Datenverarbeitungsressourcen gestartet werden. Diese Subnetze müssen sich in derselben VPC befinden. Fargate-Rechenressourcen können maximal 16 Subnetze enthalten. Weitere Informationen finden Sie unter VPCs und Subnetze im Amazon-VPC-Benutzerhandbuch.

Anmerkung

AWS Batch auf Amazon EC2 und AWS Batch auf Amazon EKS unterstützen Local Zones. Weitere Informationen finden Sie unter Local Zones im Amazon EC2 EC2-Benutzerhandbuch, Amazon EKS and AWS Local Zones im Amazon EKS-Benutzerhandbuch und Amazon ECS-Cluster in Local Zones, Wavelength Zones und AWS Outposts im Amazon Elastic Container Service Developer Guide.

AWS Batch on Fargate unterstützt derzeit keine Local Zones.

Wenn Sie beim Aktualisieren von Rechenumgebungen eine leere Liste von VPC-Subnetzen angeben, unterscheidet sich das resultierende Verhalten zwischen Fargate- und EC2-Rechenressourcen. Für Fargate-Rechenressourcen wird die Bereitstellung einer leeren Liste so behandelt, als ob dieser Parameter nicht angegeben wäre und keine Änderung vorgenommen würde. Bei EC2-Rechenressourcen werden durch das Bereitstellen einer leeren Liste die VPC-Subnetze aus der Rechenressource entfernt. Wenn Sie die VPC-Subnetze ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Dies ist sowohl bei Fargate- als auch bei EC2-Rechenressourcen der Fall. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Typ: Zeichenfolgen-Array

Erforderlich: Ja

securityGroupIds

Die Amazon EC2-Sicherheitsgruppen, die den in der Datenverarbeitungsumgebung gestarteten Instances zugeordnet sind. Eine oder mehrere Sicherheitsgruppen müssen angegeben werden, entweder in securityGroupIds oder unter Verwendung einer Startvorlage, auf die in launchTemplate verwiesen wird. Dieser Parameter ist für Jobs erforderlich, die auf Fargate-Ressourcen ausgeführt werden und mindestens eine Sicherheitsgruppe enthalten müssen. (Fargate unterstützt keine Startvorlagen.) Wenn Sicherheitsgruppen sowohl mit securityGroupIds als auch launchTemplate angegeben werden, werden die Werte in securityGroupIds verwendet.

Wenn Sie beim Aktualisieren von Rechenumgebungen eine leere Liste von Sicherheitsgruppen angeben, unterscheidet sich das resultierende Verhalten zwischen Fargate- und EC2-Rechenressourcen. Für Fargate-Rechenressourcen wird die Bereitstellung einer leeren Liste so behandelt, als ob dieser Parameter nicht angegeben wäre und keine Änderung vorgenommen würde. Bei EC2-Rechenressourcen werden durch das Bereitstellen einer leeren Liste die Sicherheitsgruppen aus der Rechenressource entfernt. Wenn Sie die Sicherheitsgruppen ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Dies ist sowohl bei Fargate- als auch bei EC2-Rechenressourcen der Fall. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Typ: Zeichenfolgen-Array

Erforderlich: Ja

ec2KeyPair

Das EC2-Schlüsselpaar, das für Instances verwendet wird, die in der Rechenumgebung gestartet wurden. Sie können dieses Schlüsselpaar für die Anmeldung bei Ihren Instances mit SSH verwenden. Wenn Sie bei der Aktualisierung einer Rechenumgebung das EC2-Schlüsselpaar ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Typ: Zeichenfolge

Erforderlich: Nein

instanceRole

Das Amazon ECS-Instance-Profil, das an Amazon EC2 EC2-Instances in einer Rechenumgebung angehängt werden soll. Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden. Geben Sie es nicht an. Sie können den kurzen Namen oder den vollständigen Amazon Resource Namen (ARN) eines Instance-Profil angeben. Zum Beispiel ecsInstanceRole oder arn:aws:iam::aws_account_id:instance-profile/ecsInstanceRole. Weitere Informationen finden Sie unter Amazon-ECS-Instance-Rolle.

Wenn Sie bei der Aktualisierung einer Rechenumgebung diese Einstellung ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Typ: Zeichenfolge

Erforderlich: Nein

tags

Schlüssel-Wert-Paar-Tags, die auf EC2-Instances angewendet werden, die in der Rechenumgebung gestartet werden. Sie können z. B. "Name": "AWS Batch Instance - C4OnDemand" als Tag angeben, sodass jede Instance in Ihrer Datenverarbeitungsumgebung diesen Namen erhält. Dies ist hilfreich, um Ihre AWS Batch Instances in der Amazon EC2 EC2-Konsole zu erkennen. Diese Tags werden bei der Verwendung des AWS BatchListTagsForResourceAPI-Vorgangs nicht angezeigt.

Wenn Sie eine Rechenumgebung aktualisieren und die EC2-Tags ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Erforderlich: Nein

placementGroup

Die Amazon EC2-Platzierungsgruppe, die Ihren Datenverarbeitungsressourcen zugeordnet werden soll. Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden. Geben Sie es nicht an. Wenn Sie beabsichtigen, parallel Jobs mit mehreren Knoten an Ihre Rechenumgebung zu senden, sollten Sie erwägen, eine Cluster-Platzierungsgruppe zu erstellen und sie Ihren Rechenressourcen zuzuordnen. Auf diese Weise bleibt Ihr paralleler Auftrag mit mehreren Knoten in einer logischen Gruppierung von Instances innerhalb einer einzelnen Availability Zone mit hohem Netzwerk-Flow-Potenzial. Weitere Informationen finden Sie unter Platzierungsgruppen im Amazon EC2-Benutzerhandbuch für Linux-Instances.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Typ: Zeichenfolge

Erforderlich: Nein

bidPercentage

Der maximale Prozentsatz, den ein EC2-Spot-Instance-Preis im Vergleich zum On-Demand-Preis für diesen Instance-Typ vor dem Start der Instances erreichen kann. Wenn Ihr maximaler Prozentsatz beispielsweise 20% beträgt, muss der Spot-Preis weniger als 20% des aktuellen On-Demand-Preises für diese EC2-Instance betragen. Sie zahlen immer nur den niedrigsten (Markt-) Preis und niemals mehr als Ihren maximalen Prozentsatz. Wenn Sie dieses Feld leer lassen, ist der Standardwert 100 % des On-Demand-Preises. Für die meisten Anwendungsfälle empfehlen wir, dieses Feld leer zu lassen.

Wenn Sie bei der Aktualisierung einer Rechenumgebung den Gebotsprozentsatz ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Erforderlich: Nein

spotIamFleetRole

Der Amazon-Ressourcenname (ARN) der Amazon EC2-Spot-Flotten-IAM-Rolle für eine SPOT-Datenverarbeitungsumgebung. Diese Rolle ist erforderlich, wenn die Zuordnungsstrategie auf BEST_FIT festgelegt ist oder wenn die Zuordnungsstrategie nicht angegeben ist. Weitere Informationen finden Sie unter Amazon EC2-Spot-Flottenrolle.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Wichtig

Um Ihre Spot-Instances bei der Erstellung zu taggen, muss die hier angegebene Spot-Flotte-IAM-Rolle die neuere verwaltete AmazonEC2-Richtlinie SpotFleet TaggingRole verwenden. Die zuvor empfohlene Richtlinie zur Verwaltung von SpotFleetAmazonEC2-Rollen verfügt nicht über die erforderlichen Berechtigungen, um Spot-Instances zu taggen. Weitere Informationen finden Sie unter Spot-Instances wurden bei der Erstellung nicht markiert.

Typ: Zeichenfolge

Erforderlich: Dieser Parameter ist für SPOT-Datenverarbeitungsumgebungen erforderlich.

launchTemplate

Eine optionale Startvorlage, die zu Ihren Datenverarbeitungsressourcen zugeordnet werden soll. Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden. Geben Sie es nicht an. Alle anderen Rechenressourcenparameter, die Sie in einem CreateComputeEnvironmentoder UpdateComputeEnvironmentAPI-Vorgang angeben, haben Vorrang vor denselben Parametern in der Startvorlage. Um eine Startvorlage zu starten, müssen Sie entweder die Startvorlagen-ID oder den Namen der Startvorlage in der Anfrage eingeben, aber nicht beides. Weitere Informationen finden Sie unter Support für Startvorlagen.

Wenn Sie eine Rechenumgebung aktualisieren, um die benutzerdefinierte Startvorlage zu entfernen und die standardmäßige Startvorlage zu verwenden, setzen Sie das launchTemplateId oder launchTemplateName -Element der Startvorlagenspezifikation auf eine leere Zeichenfolge. Durch das Entfernen der Startvorlage aus einer Rechenumgebung wird das in der Startvorlage angegebene AMI nicht entfernt, sofern es das verwendete war. Um das aus einer Startvorlage ausgewählte AMI zu aktualisieren, muss der updateToLatestImageVersion Parameter auf gesetzt seintrue. Wenn Sie bei der Aktualisierung einer Rechenumgebung die Startvorlage ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Typ: LaunchTemplateSpecification

object

Erforderlich: Nein

launchTemplateId

Die ID der Startvorlage.

Typ: Zeichenfolge

Erforderlich: Nein

launchTemplateName

Der Name der Startvorlage.

Typ: Zeichenfolge

Erforderlich: Nein

version

Die Versionsnummer der Startvorlage: $Latest oder $Default.

Wenn der Wert $Latest lautet, wird die neueste Version der Einführungsvorlage verwendet. Wenn der Wert $Default lautet, wird die Standardversion der Einführungsvorlage verwendet. Bei einem Infrastruktur-Update wird die Version der Startvorlage AWS Batch neu bewertet, sofern entweder $Latest oder für die Rechenumgebung angegeben $Default wurde, und es wird möglicherweise eine andere Version der Startvorlage verwendet. Dies gilt auch dann, wenn die Startvorlage im Update nicht angegeben wurde.

Standard: $Default.

Typ: Zeichenfolge

Erforderlich: Nein

ec2Configuration

Stellt Informationen bereit, die zur Auswahl von Amazon Machine Images (AMIs) für Instances in der EC2-Rechenumgebung verwendet werden. Wenn Ec2Configuration nicht angegeben, ist die Standardeinstellung Amazon Linux 2 (ECS_AL2). Vor dem 31. März 2021 war dieser Standard Amazon Linux (ECS_AL1) für Nicht-GPU- und AWS Nicht-Graviton-Instances.

Wenn Sie bei der Aktualisierung einer Rechenumgebung diesen Parameter ändern, ist ein Infrastruktur-Update der Rechenumgebung erforderlich. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Anmerkung

Dieser Parameter ist nicht auf Aufträge anwendbar, die auf Fargate-Ressourcen ausgeführt werden.

Typ: Array von Ec2Configuration-Objekten

Erforderlich: Nein

imageIdOverride

Die AMI-ID, die für Instances verwendet wird, die in der Rechenumgebung gestartet wurden und dem Image-Typ entspricht. Diese Einstellung überschreibt imageId, die im Objekt computeResource eingestellt ist.

Typ: Zeichenfolge

Erforderlich: Nein

imageKubernetesVersion

Die Kubernetes Version für die Rechenumgebung. Wenn Sie keinen Wert angeben, wird die neueste Version, die AWS Batch unterstützt, verwendet.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Nein

imageType

Der Image-Typ, der mit dem Instance-Typ übereinstimmen muss, um ein AMI auszuwählen. Die unterstützten Werte unterscheiden sich für ECS- und EKS-Ressourcen.

ECS

Wenn der Parameter imageIdOverride nicht angegeben wird, wird ein aktuelles Amazon-ECS-optimiertes Linux–2-AMI (ECS_AL2) verwendet. Wenn in einem Update ein neuer Image-Typ angegeben wird, aber imageId weder ein noch ein imageIdOverride Parameter angegeben ist, wird das neueste Amazon ECS-optimierte AMI für diesen Image-Typ verwendet, das von unterstützt AWS Batch wird.

ECS_AL2

Amazon Linux2: Standard für alle Nicht-GPU-Instance-Familien.

ECS_AL2_NVIDIA

Amazon Linux 2 (GPU): Standard für alle GPU-Instance-Familien (zum Beispiel P4 undG4) und kann für alle Instance-Typen verwendet werden, die nicht AWS auf Graviton basieren.

ECS_AL1

Amazon Linux. Amazon Linux hat den end-of-life Standardsupport erreicht. Weitere Informationen finden Sie unter Amazon Linux AMI.

EKS

Wenn der Parameter imageIdOverride nicht angegeben wird, wird ein aktuelles Amazon-EKS-optimiertes Linux-AMI (EKS_AL2) verwendet. Wenn in einem Update ein neuer Image-Typ angegeben wird, aber imageId weder ein noch ein imageIdOverride Parameter angegeben ist, wird das neueste Amazon EKS-optimierte AMI für diesen Image-Typ verwendet, das AWS Batch unterstützt wird.

EKS_AL2

Amazon Linux2: Standard für alle Nicht-GPU-Instance-Familien.

EKS_AL2_NVIDIA

Amazon Linux 2 (beschleunigt): Standard für alle GPU-Instance-Familien (z. B. P4 undG4) und kann für alle Instance-Typen verwendet werden, die nicht auf AWS Graviton basieren.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Ja

Amazon EKS-Konfiguration

Konfiguration für den Amazon EKS-Cluster, der die AWS Batch Rechenumgebung unterstützt. Der Cluster muss existieren, bevor die Rechenumgebung erstellt werden kann.

eksClusterArn

Der Amazon-Ressourcenname (ARN) für den Amazon-EKS-Cluster. Ein Beispiel ist arn:aws:eks:us-east-1:123456789012:cluster/ClusterForBatch.

Typ: Zeichenfolge

Erforderlich: Ja

kubernetesNamespace

Der Namespace des Amazon EKS-Clusters. AWS Batch verwaltet Pods in diesem Namespace. Der Wert darf nicht leer oder null sein. Er muss weniger als 64 Zeichen lang sein, darf nicht auf default gesetzt werden, darf nicht mit „kube-“ beginnen und muss mit diesem regulären Ausdruck übereinstimmen: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$. Weitere Informationen finden Sie unter Namespaces in der Kubernetes-Dokumentation.

Typ: Zeichenfolge

Erforderlich: Ja

Typ: Objekt EksConfiguration

Erforderlich: Nein

Servicerolle

serviceRole

Der vollständige Amazon-Ressourcenname (ARN) der IAM-Rolle, mit der Sie AWS Batch in Ihrem Namen Anrufe an andere AWS Dienste tätigen können. Weitere Informationen finden Sie unter Verwenden von serviceverknüpften Rollen für AWS Batch. Wir empfehlen, dass Sie die Servicerolle nicht angeben. Auf diese Weise wird die AWSServiceRoleForBatchdienstbezogene Rolle AWS Batch verwendet.

Wichtig

Wenn Ihr Konto die AWS Batch dienstverknüpfte Rolle (AWSServiceRoleForBatch) bereits erstellt hat, wird diese Rolle standardmäßig für Ihre Rechenumgebung verwendet, sofern Sie hier keine Rolle angeben. Wenn die AWS Batch dienstverknüpfte Rolle in Ihrem Konto nicht existiert und hier keine Rolle angegeben ist, versucht der Dienst, die AWS Batch dienstverknüpfte Rolle in Ihrem Konto zu erstellen. Weitere Informationen zur serviceverknüpften AWSServiceRoleForBatch-Rolle finden Sie unter Dienstbezogene Rollenberechtigungen für AWS Batch.

Wenn die Datenverarbeitungsumgebung mithilfe der AWSServiceRoleForBatchserviceverknüpften Rolle erstellt wurde, kann sie nicht geändert werden, sodass sie eine reguläre IAM-Rolle verwendet. Ebenso kann die Rechenumgebung, wenn sie mit einer regulären IAM-Rolle erstellt wurde, nicht geändert werden, sodass sie die AWSServiceRoleForBatchserviceverknüpfte Rolle verwendet. Um die Parameter für die Rechenumgebung zu aktualisieren, für deren Änderung ein Infrastruktur-Update erforderlich ist, muss die AWSServiceRoleForBatchserviceverknüpfte Rolle verwendet werden. Weitere Informationen finden Sie unter Aktualisieren von Datenverarbeitungsumgebungen.

Wenn Ihre angegebene Rolle einen anderen Pfad als hat/, stellen Sie sicher, dass Sie entweder den vollständigen Rollen-ARN (empfohlen) angeben oder dem Rollennamen den Pfad voranstellen.

Anmerkung

Je nachdem, wie Sie Ihre AWS Batch Servicerolle erstellt haben, kann ihr Amazon-Ressourcenname (ARN) das service-role Pfadpräfix enthalten. Wenn Sie nur den Namen der Servicerolle angeben, AWS Batch wird davon ausgegangen, dass Ihr ARN das service-role Pfadpräfix nicht verwendet. Aus diesem Grund empfehlen wir, dass Sie den vollständigen ARN Ihrer Service-Rolle beim Erstellen von Datenverarbeitungsumgebungen angeben.

Typ: Zeichenfolge

Erforderlich: Nein

Tags

tags

Schlüssel-Wert-Paar-Tags, die der Rechenumgebung zugeordnet werden sollen. Weitere Informationen finden Sie unter Markieren Ihrer AWS Batch-Ressourcen.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Erforderlich: Nein