View a markdown version of this page

AWSSupport-TroubleshootAWSBatchJob - AWS Systems Manager Référence du dossier d’exploitation Automation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWSSupport-TroubleshootAWSBatchJob

Description

Le AWSSupport-TroubleshootAWSBatchJob runbook vous aide à résoudre les problèmes qui empêchent une AWS Batch tâche de passer de l'état à l'autre. RUNNABLE STARTING

Fonctionnement

Ce runbook effectue les vérifications suivantes :

  • Si l'environnement informatique est dans un DISABLED état INVALID ou.

  • Si le Max vCPU paramètre de l'environnement de calcul est suffisamment grand pour prendre en charge le volume de tâches dans la file d'attente des tâches.

  • Si les tâches nécessitent plus de processeurs virtuels ou de ressources mémoire que ce que les types d'instances de l'environnement informatique peuvent fournir.

  • Si les tâches doivent être exécutées sur GPU-based des instances mais que l'environnement de calcul n'est pas configuré pour utiliser GPU-based des instances.

  • Si le groupe Auto Scaling de l'environnement informatique n'a pas réussi à lancer les instances.

  • Si les instances lancées peuvent rejoindre le cluster Amazon Elastic Container Service (Amazon ECS) sous-jacent, sinon, le AWSSupport-TroubleshootECSContainerInstance runbook est exécuté.

  • Si un problème d'autorisations bloque des actions spécifiques requises pour exécuter la tâche.

Important

  • Ce runbook doit être lancé dans la même AWS région que votre job dont le RUNNABLE statut est bloqué.

  • Ce runbook peut être lancé pour des AWS Batch tâches planifiées sur des instances Amazon ECS AWS Fargate ou Amazon Elastic Compute Cloud (Amazon EC2). Si l'automatisation est lancée pour une AWS Batch tâche sur Amazon Elastic Kubernetes Service (Amazon EKS), le lancement s'arrête.

  • Si des instances sont disponibles pour exécuter la tâche mais ne parviennent pas à enregistrer le cluster Amazon ECS, ce runbook lance le runbook AWSSupport-TroubleshootECSContainerInstance d'automatisation pour essayer de déterminer pourquoi. Pour plus d'informations, consultez le AWSSupport-TroubleshootECSContainerInstance runbook.

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

  • AutomationAssumeRole

    Type : Chaîne

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

  • JobId

    Type : Chaîne

    Description : (Obligatoire) L'ID de la AWS Batch tâche dont le RUNNABLE statut est bloqué.

    Schéma autorisé : ^[a-f0-9]{8}(-[a-f0-9]{4}){3}-[a-f0-9]{12}(:[0-9]+)?(#[0-9]+)?$

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • 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

Instructions

  1. Accédez AWSSupport-TroubleshootAWSBatchJob à la AWS Systems Manager console.

  2. Sélectionnez Exécuter l'automatisation

  3. Pour les paramètres d'entrée, entrez les informations suivantes :

    • AutomationAssumeRole(Facultatif) :

      Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

    • JobId(Obligatoire) :

      L'ID de la AWS Batch tâche dont le RUNNABLE statut est bloqué.

    Les paramètres d'entrée se forment avec des JobId champs AutomationAssumeRole et des champs pour la configuration des AWS Batch tâches.

  4. Sélectionnez Exécuter.

  5. Notez que l'automatisation démarre.

  6. Le document exécute les étapes suivantes :

    • PreflightPermissionChecks:

      Effectue des contrôles d'autorisation IAM avant le vol par rapport à l'initiateur. user/role Si des autorisations sont manquantes, cette étape indique les actions d'API manquantes dans la section de sortie globale.

    • ProceedOnlyIfUserHasPermission:

      Branches selon que vous êtes autorisé à effectuer toutes les actions requises pour le runbook.

    • AWSBatchJobEvaluation:

      Effectue des vérifications par rapport à la AWS Batch tâche pour vérifier qu'elle existe et qu'elle est en bon RUNNABLE état.

    • ProceedOnlyIfBatchJobExistsAndIsinRunnableState:

      Branches en fonction de l'existence de l'emploi et de RUNNABLE son statut.

    • BatchComputeEnvironmentEvaluation:

      Effectue des vérifications par rapport à l'environnement AWS Batch informatique.

    • ProceedOnlyIfComputeEnvironmentChecksAreOK:

      Branches en fonction de la réussite des vérifications de l'environnement de calcul.

    • UnderlyingInfraEvaluation:

      Effectue des vérifications par rapport au groupe Auto Scaling Group ou à la Spot Fleet Request sous-jacent.

    • ProceedOnlyIfInstancesNotJoiningEcsCluster:

      Branches en fonction du fait que certaines instances ne rejoignent pas le cluster Amazon ECS.

    • EcsAutomationRunner:

      Exécute l'automatisation Amazon ECS pour les instances qui ne rejoignent pas le cluster.

    • ExecutionResults:

      Génère une sortie en fonction des étapes précédentes.

  7. Une fois terminé, l'URI du fichier HTML du rapport d'évaluation est fourni :

    Lien vers la console S3 et URI Amazon S3 pour le rapport sur l'exécution réussie du runbook

    Résumé des résultats d'exécution indiquant les erreurs dans la configuration de l'environnement informatique et la file d'attente des tâches.

Références

Systems Manager Automation