AWSSupport-TroubleshootAWSBatchJob - AWS Systems Manager 自動化ランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSSupport-TroubleshootAWSBatchJob

説明

AWSSupport-TroubleshootAWSBatchJob ランブックは、 AWS Batch ジョブが から STARTINGステータスRUNNABLEに進行するのを妨げる問題のトラブルシューティングに役立ちます。

動作の仕組み

このランブックは、次のチェックを実行します。

  • コンピューティング環境が INVALIDまたは DISABLED状態の場合。

  • コンピューティング環境の Max vCPUパラメータが、ジョブキュー内のジョブボリュームに対応するのに十分な大きさである場合。

  • ジョブが、コンピューティング環境のインスタンスタイプが提供できるよりも多くの vCPUs またはメモリリソースを必要とする場合。

  • ジョブを GPU ベースのインスタンスで実行する必要があるが、コンピューティング環境が GPU ベースのインスタンスを使用するように設定されていない場合。

  • コンピューティング環境の Auto Scaling グループがインスタンスの起動に失敗した場合。

  • 起動されたインスタンスが基盤となる Amazon Elastic Container Service (Amazon ECS) クラスターに参加できる場合、そうでない場合は、AWSSupport-TroubleshootECSContainerInstance ランブックを実行します。

  • アクセス許可の問題により、ジョブの実行に必要な特定のアクションがブロックされている場合。

重要

  • このランブックは、 RUNNABLEステータスでスタックしているジョブと同じ AWS リージョンで開始する必要があります。

  • このランブックは、Amazon ECS AWS Fargate または Amazon Elastic Compute Cloud (Amazon EC2) インスタンスでスケジュールされた AWS Batch ジョブに対して開始できます。Amazon Elastic Kubernetes Service (Amazon EKS) で AWS Batch ジョブのオートメーションが開始されると、開始は停止します。

  • インスタンスでジョブを実行できても Amazon ECS クラスターの登録に失敗した場合、このランブックはAWSSupport-TroubleshootECSContainerInstanceオートメーションランブックを開始して、その理由を判断します。詳細については、AWSSupport-TroubleshootECSContainerInstance ランブックを参照してください。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

[Platforms] (プラットフォーム)

Linux、macOS、Windows

パラメータ

  • AutomationAssumeRole

    タイプ: 文字列

    説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

  • JobId

    タイプ: 文字列

    説明: (必須) RUNNABLEステータスでスタックしている AWS Batch ジョブの ID。

    許可されたパターン: ^[a-f0-9]{8}(-[a-f0-9]{4}){3}-[a-f0-9]{12}(:[0-9]+)?(#[0-9]+)?$

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

  • 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

指示

  1. コンソールで AWSSupport-TroubleshootAWSBatchJob AWS Systems Manager に移動します。

  2. [Execute automation] (オートメーションを実行) を選択します。

  3. 次の入力パラメータを入力できます。

    • AutomationAssumeRole（オプション):

      Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

    • JobId (必須):

      RUNNABLE ステータスでスタックしている AWS Batch ジョブの ID。

    Input parameters form with AutomationAssumeRole and JobId fields for AWS Batch job configuration.

  4. [実行] を選択します。

  5. オートメーションが開始されることに注意してください。

  6. ドキュメントは以下のステップを実行します。

    • PreflightPermissionChecks:

      開始するユーザー/ロールに対してプリフライト IAM アクセス許可チェックを実行します。不足しているアクセス許可がある場合、このステップでは、グローバル出力セクションに欠落している API アクションが表示されます。

    • ProceedOnlyIfUserHasPermission:

      ランブックに必要なすべてのアクションに対するアクセス許可があるかどうかに基づいて分岐します。

    • AWSBatchJobEvaluation:

      AWS Batch ジョブに対してチェックを実行し、ジョブが存在し、 RUNNABLEステータスであることを確認します。

    • ProceedOnlyIfBatchJobExistsAndIsinRunnableState:

      ジョブが存在し、 RUNNABLEステータスであるかどうかに基づいて分岐します。

    • BatchComputeEnvironmentEvaluation:

      AWS Batch コンピューティング環境に対してチェックを実行します。

    • ProceedOnlyIfComputeEnvironmentChecksAreOK:

      コンピューティング環境チェックが成功したかどうかに基づいて分岐します。

    • UnderlyingInfraEvaluation:

      基盤となる Auto Scaling グループまたはスポットフリートリクエストに対してチェックを実行します。

    • ProceedOnlyIfInstancesNotJoiningEcsCluster:

      Amazon ECS クラスターに参加していないインスタンスがあるかどうかに基づいて分岐します。

    • EcsAutomationRunner:

      クラスターに参加していないインスタンスの Amazon ECS オートメーションを実行します。

    • ExecutionResults:

      前のステップに基づいて出力を生成します。

  7. 完了すると、評価レポートの HTML ファイルの URI が提供されます。

    ランブックが正常に実行された場合のレポートの S3 コンソールリンクと Amazon S3 URI

    Execution result summary showing errors in compute environment setup and job queue.

リファレンス

Systems Manager Automation