「簡単なジョブ実行でサーバーを使うのはもうやめよう」ということでStep Functionsとコンテナで簡単にジョブ実行させる方法のご紹介です。

はじめに

こんにちは。サーバーワークスの松井です。今回はAWS StepFunctionsとコンテナで簡単にジョブ実行をする方法についてご紹介します。

前提条件

以下のリソースは事前に作成済みであることを前提とします。

ECS タスク定義
ECS タスク実行用IAMロール
ECS タスク用IAMロール
ECS クラスター
ECR レポジトリ
Docker イメージ
VPC サブネット(ECS タスク実行用)
ECS用セキュリティグループ

AWS Step Functionsの準備

AWSのマネージメントコンソールログイン後にAWS Step Functionsのコンソール画面へ移動し、ステートマシンを作成します

「ステートマシンの作成」を押下します

Blankのまま「選択」を押下します

Workflow Studioからデフォルトの「デザイン」から「コード」に変更します

以下のJSON文を貼り付けてステートマシーンを定義し、「作成」を押下します(「$.commands」部分は、AWS Step Functionsの入力値に置き換えられます)

{
  "Comment": "execute an ECS task",
  "StartAt": "Run an ECS Task",
  "States": {
    "Run an ECS Task": {
      "Type": "Task",
      "Resource": "arn:aws:states:::ecs:runTask.sync",
      "Parameters": {
        "LaunchType": "FARGATE",
        "Cluster": "arn:aws:ecs:ap-northeast-1:<AWSアカウントID>:cluster/<ECSクラスター名>",
        "TaskDefinition": "arn:aws:ecs:ap-northeast-1:<AWSアカウントID>:task-definition/<タスク定義名>:<リビジョン番号>",
        "NetworkConfiguration": {
          "AwsvpcConfiguration": {
            "Subnets": [
              "<サブネットID_1>",
              "<サブネットID_2>"
            ],
            "SecurityGroups": [
              "<セキュリティグループID>"
            ],
            "AssignPublicIp": "ENABLED"
          }
        }
      },
      "Overrides": {
          "ContainerOverrides": [
            {
              "Name": "<コンテナ名>",
              "Command.$": "$.commands"
            }
          ]
        }
      },
      "Retry": [
        {
          "ErrorEquals": [
            "States.ALL"
          ],
          "IntervalSeconds": 1,
          "MaxAttempts": 2,
          "BackoffRate": 3
        }
      ],
      "End": true
    }
  }
}

ロールの作成を確認の画面で、「確認」を押下します

※ このままですと実行時にIAM Passロールがないとエラーが出ますので、IAMポリシーを新しく作成して、作成されたIAMロールにアタッチします

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EcsIamPass",
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": [
                "arn:aws:iam::<AWSアカウントID>:role/<タスク実行ロールのID>",
                "arn:aws:iam::<AWSアカウントID>:role/<タスクロールのID>"
            ]
        }
    ]
}