View a markdown version of this page

AWSSupport-TroubleshootAWSBatchJob - AWS Systems Manager Runbook-Referenz für Automation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSSupport-TroubleshootAWSBatchJob

Beschreibung

Das AWSSupport-TroubleshootAWSBatchJob Runbook hilft Ihnen bei der Behebung von Problemen, die verhindern, dass ein AWS Batch Job vom Status RUNNABLE zum STARTING nächsten übergeht.

Wie funktioniert es?

Dieses Runbook führt die folgenden Prüfungen durch:

  • Wenn sich die Rechenumgebung in einem INVALID DISABLED OR-Zustand befindet.

  • Wenn der Max vCPU Parameter der Rechenumgebung groß genug ist, um das Auftragsvolumen in der Auftragswarteschlange aufzunehmen.

  • Wenn die Jobs mehr vCPUs oder Speicherressourcen benötigen, als die Instanztypen der Computerumgebung bereitstellen können.

  • Wenn die Jobs auf GPU-based Instanzen ausgeführt werden sollen, die Rechenumgebung jedoch nicht für die Verwendung GPU-based von Instanzen konfiguriert ist.

  • Wenn die Auto Scaling-Gruppe für die Computerumgebung keine Instances starten konnte.

  • Wenn die gestarteten Instances dem zugrunde liegenden Amazon Elastic Container Service (Amazon ECS) -Cluster beitreten können; wenn nicht, wird das AWSSupport-TroubleshootECSContainerInstance Runbook ausgeführt.

  • Wenn ein Berechtigungsproblem bestimmte Aktionen blockiert, die zur Ausführung des Jobs erforderlich sind.

Wichtig

  • Dieses Runbook muss in derselben AWS Region initiiert werden wie Ihr Job, der den RUNNABLE Status „Festgefahren“ hat.

  • Dieses Runbook kann für AWS Batch Jobs initiiert werden, die auf Amazon ECS AWS Fargate - oder Amazon Elastic Compute Cloud (Amazon EC2) -Instances geplant sind. Wenn die Automatisierung für einen AWS Batch Job auf Amazon Elastic Kubernetes Service (Amazon EKS) initiiert wird, stoppt die Initiierung.

  • Wenn Instances zur Ausführung des Jobs verfügbar sind, der Amazon ECS-Cluster jedoch nicht registriert wird, initiiert dieses Runbook das AWSSupport-TroubleshootECSContainerInstance Automatisierungs-Runbook, um herauszufinden, warum. Weitere Informationen finden Sie im Runbook. AWSSupport-TroubleshootECSContainerInstance

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

LinuxmacOS, Windows

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

  • JobId

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Die ID des AWS Batch Jobs, der den RUNNABLE Status „Festgefahren“ hat.

    Zulässiges Muster: ^[a-f0-9]{8}(-[a-f0-9]{4}){3}-[a-f0-9]{12}(:[0-9]+)?(#[0-9]+)?$

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • autoscaling:DescribeAutoScalingGroups

  • autoscaling:DescribeScalingActivities

  • batch:DescribeComputeEnvironments

  • batch:DescribeJobs

  • batch:DescribeJobQueues

  • batch:ListJobs

  • cloudtrail:LookupEvents

  • ec2:DescribeIamInstanceProfileAssociations

  • ec2:DescribeInstanceAttribute

  • ec2:DescribeInstances

  • ec2:DescribeInstanceTypeOfferings

  • ec2:DescribeInstanceTypes

  • ec2:DescribeNetworkAcls

  • ec2:DescribeRouteTables

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSpotFleetInstances

  • ec2:DescribeSpotFleetRequests

  • ec2:DescribeSpotFleetRequestHistory

  • ec2:DescribeSubnets

  • ec2:DescribeVpcEndpoints

  • ec2:DescribeVpcs

  • ecs:DescribeClusters

  • ecs:DescribeContainerInstances

  • ecs:ListContainerInstances

  • iam:GetInstanceProfile

  • iam:GetRole

  • iam:ListRoles

  • iam:PassRole

  • iam:SimulateCustomPolicy

  • iam:SimulatePrincipalPolicy

  • ssm:DescribeAutomationExecutions

  • ssm:DescribeAutomationStepExecutions

  • ssm:GetAutomationExecution

  • ssm:StartAutomationExecution

  • sts:GetCallerIdentity

Anweisungen

  1. Navigieren Sie AWSSupport-TroubleshootAWSBatchJob in der AWS Systems Manager Konsole zu.

  2. Wählen Sie Automatisierung ausführen

  3. Geben Sie für Eingabeparameter Folgendes ein:

    • AutomationAssumeRole(Fakultativ):

      Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

    • JobId(Erforderlich):

      Die ID des AWS Batch Jobs, der im RUNNABLE Status feststeckt.

    Eingabeparameterformular mit AutomationAssumeRole und JobId Feldern für die AWS Batch Jobkonfiguration.

  4. Wählen Sie Ausführen aus.

  5. Beachten Sie, dass die Automatisierung initiiert wird.

  6. Das Dokument führt die folgenden Schritte aus:

    • PreflightPermissionChecks:

      Führt Preflight-IAM-Berechtigungsprüfungen anhand des Initiators durch. user/role Falls Berechtigungen fehlen, werden in diesem Schritt die API-Aktionen bereitgestellt, die im Abschnitt „Globale Ausgabe“ fehlen.

    • ProceedOnlyIfUserHasPermission:

      Verzweigungen hängen davon ab, ob Sie über Berechtigungen für alle erforderlichen Aktionen für das Runbook verfügen.

    • AWSBatchJobEvaluation:

      Führt Prüfungen mit dem AWS Batch Job durch und stellt sicher, dass er existiert und sich im RUNNABLE Status befindet.

    • ProceedOnlyIfBatchJobExistsAndIsinRunnableState:

      Verzweigt je nachdem, ob der Job existiert und sich im RUNNABLE Status befindet.

    • BatchComputeEnvironmentEvaluation:

      Führt Prüfungen anhand der AWS Batch Rechenumgebung durch.

    • ProceedOnlyIfComputeEnvironmentChecksAreOK:

      Verzweigungen basieren darauf, ob die Prüfungen der Rechenumgebung erfolgreich waren.

    • UnderlyingInfraEvaluation:

      Führt Prüfungen anhand der zugrunde liegenden Auto Scaling-Gruppen- oder Spot-Flottenanforderung durch.

    • ProceedOnlyIfInstancesNotJoiningEcsCluster:

      Branches basieren darauf, ob es Instances gibt, die dem Amazon ECS-Cluster nicht beitreten.

    • EcsAutomationRunner:

      Führt die Amazon ECS-Automatisierung für die Instances aus, die dem Cluster nicht beitreten.

    • ExecutionResults:

      Generiert eine Ausgabe auf der Grundlage früherer Schritte.

  7. Nach Abschluss des Vorgangs wird der URI für die HTML-Datei des Bewertungsberichts bereitgestellt:

    Link zur S3-Konsole und Amazon S3-URI für den Bericht über die erfolgreiche Ausführung des Runbooks

    Zusammenfassung der Ausführungsergebnisse mit Fehlern bei der Einrichtung der Rechenumgebung und der Auftragswarteschlange.

Referenzen

Systems Manager Automation