View a markdown version of this page

AWSSupport-TroubleshootAWSBatchJob - AWS Systems Manager Riferimento al runbook dell’automazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWSSupport-TroubleshootAWSBatchJob

Descrizione

Il AWSSupport-TroubleshootAWSBatchJob runbook ti aiuta a risolvere i problemi che impediscono a un AWS Batch job di passare allo stato. RUNNABLE STARTING

Come funziona?

Questo runbook esegue i seguenti controlli:

  • Se l'ambiente di elaborazione è in uno stato INVALID orDISABLED.

  • Se il Max vCPU parametro dell'ambiente di calcolo è sufficientemente grande da contenere il volume del lavoro nella coda dei lavori.

  • Se i processi richiedono più vCPU o risorse di memoria rispetto a quelle fornite dai tipi di istanza dell'ambiente di calcolo.

  • Se i processi devono essere eseguiti su GPU-based istanze ma l'ambiente di calcolo non è configurato per l'utilizzo di istanze. GPU-based

  • Se il gruppo Auto Scaling per l'ambiente di calcolo non è riuscito ad avviare le istanze.

  • Se le istanze avviate possono unirsi al cluster Amazon Elastic Container Service (Amazon ECS) sottostante, in caso contrario, esegue il runbook. AWSSupport-TroubleshootECSContainerInstance

  • Se qualche problema di autorizzazione sta bloccando le azioni specifiche necessarie per eseguire il job.

Importante
  • Questo runbook deve essere avviato nella stessa AWS regione in cui si trova il job che è bloccato. RUNNABLE

  • Questo runbook può essere avviato per i AWS Batch processi pianificati su istanze Amazon ECS AWS Fargate o Amazon Elastic Compute Cloud (Amazon EC2). Se l'automazione viene avviata per un AWS Batch processo su Amazon Elastic Kubernetes Service (Amazon EKS), l'avvio si interrompe.

  • Se le istanze sono disponibili per eseguire il job ma non riescono a registrare il cluster Amazon ECS, questo runbook avvia il runbook di automazione per cercare di determinare il motivo. AWSSupport-TroubleshootECSContainerInstance Per ulteriori informazioni, consulta il runbook. AWSSupport-TroubleshootECSContainerInstance

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

  • AutomationAssumeRole

    Tipo: stringa

    Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

  • JobId

    Tipo: stringa

    Descrizione: (Obbligatorio) L'ID del AWS Batch job il cui stato è bloccato. RUNNABLE

    Schema consentito: ^[a-f0-9]{8}(-[a-f0-9]{4}){3}-[a-f0-9]{12}(:[0-9]+)?(#[0-9]+)?$

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il 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

Istruzioni

  1. Accedere a AWSSupport-TroubleshootAWSBatchJob nella AWS Systems Manager Console.

  2. Seleziona Execute Automation

  3. Per i parametri di input, inserisci quanto segue:

    • AutomationAssumeRole(Facoltativo):

      L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

    • JobId(Obbligatorio):

      L'ID del AWS Batch lavoro bloccato nello RUNNABLE stato.

    Modulo dei parametri di input con JobId campi AutomationAssumeRole e per la configurazione del AWS Batch lavoro.
  4. Seleziona Esegui.

  5. Notate che l'automazione viene avviata.

  6. Il documento esegue i seguenti passaggi:

    • PreflightPermissionChecks:

      Esegue controlli preliminari delle autorizzazioni IAM rispetto a quelle user/role inizianti. Se mancano delle autorizzazioni, questo passaggio fornisce le azioni API mancanti nella sezione di output globale.

    • ProceedOnlyIfUserHasPermission:

      Dipende se disponi delle autorizzazioni per tutte le azioni richieste per il runbook.

    • AWSBatchJobEvaluation:

      Esegue controlli sul AWS Batch Job verificandone l'esistenza e lo stato. RUNNABLE

    • ProceedOnlyIfBatchJobExistsAndIsinRunnableState:

      Si ramifica in base all'esistenza e RUNNABLE allo stato del job.

    • BatchComputeEnvironmentEvaluation:

      Esegue controlli rispetto all'ambiente di AWS Batch calcolo.

    • ProceedOnlyIfComputeEnvironmentChecksAreOK:

      Si dirama in base all'esito positivo dei controlli dell'ambiente di calcolo.

    • UnderlyingInfraEvaluation:

      Esegue controlli rispetto all'Auto Scaling Group o alla Spot Fleet Request sottostanti.

    • ProceedOnlyIfInstancesNotJoiningEcsCluster:

      Si ramifica in base alla presenza di istanze che non si uniscono al cluster Amazon ECS.

    • EcsAutomationRunner:

      Esegue l'automazione Amazon ECS per le istanze che non si uniscono al cluster.

    • ExecutionResults:

      Genera output in base ai passaggi precedenti.

  7. Al termine, viene fornito l'URI per il file HTML del rapporto di valutazione:

    Link alla console S3 e URI Amazon S3 per il report sulla corretta esecuzione del runbook

    Riepilogo dei risultati dell'esecuzione che mostra gli errori nella configurazione dell'ambiente di calcolo e nella coda dei lavori.

Riferimenti

Systems Manager Automation