Step Functions を使用して Amazon ECSまたは Fargate タスクを実行する

Step Functions を Amazon ECSまたは Fargate と統合してタスクを実行および管理する方法を説明します。Amazon ではECS、タスクは計算の基本単位です。タスクは、コンテナイメージ、CPUメモリ制限、ネットワーク設定、その他のパラメータなど、Docker コンテナの実行方法を指定するタスク定義によって定義されます。このページには、使用可能な Amazon ECSAPIアクションと、Step Functions を使用して Amazon ECSタスクにデータを渡す方法の説明が記載されています。

Step Functions は、 Amazon ステートメント言語 () から直接特定の AWS サービスを制御できますASL。詳細については、「他のサービスの統合」および「Step Functions APIのサービスへのパラメータの受け渡し」を参照してください。

サポートされている Amazon ECS/Fargate APIsと構文：

Amazon ECSタスクへのデータの受け渡し

Step Functions は、 Amazon ステートメント言語 () から直接特定の AWS サービスを制御できますASL。詳細については、「他のサービスの統合」および「Step Functions APIのサービスへのパラメータの受け渡し」を参照してください。

overrides を使用してコンテナのデフォルトコマンドを上書きし、Amazon ECSタスクに入力を渡すことができます。「ContainerOverride」を参照してください。この例では、 JsonPath を使用して、入力Taskから Task状態に値を渡しています。

以下には、Amazon ECSタスクを実行し、完了するまで待機する Task 状態が含まれています。

{
 "StartAt": "Run an ECS Task and wait for it to complete",
 "States": {
   "Run an ECS Task and wait for it to complete": {
     "Type": "Task",
     "Resource": "arn:aws:states:::ecs:runTask.sync",
     "Parameters": {
                "Cluster": "cluster-arn",
                "TaskDefinition": "job-id",
                "Overrides": {
                    "ContainerOverrides": [
                        {
                            "Name": "container-name",
                            "Command.$": "$.commands" 
                        }
                    ]
                }
            },
     "End": true
    }
  }
}

ContainerOverrides の "Command.$": "$.commands" 行は状態の入力からコンテナにコマンドを渡します。​

前の例では、実行への入力が次の場合、各コマンドはコンテナのオーバーライドとして渡されます。

{
  "commands": [
    "test command 1",
    "test command 2",
    "test command 3"
  ]
}

以下には、Amazon ECSタスクを実行し、タスクトークンが返されるのを待機するTask状態が含まれています。「タスクトークンのコールバックまで待機する」を参照してください。

{  
   "StartAt":"Manage ECS task",
   "States":{  
      "Manage ECS task":{  
         "Type":"Task",
         "Resource":"arn:aws:states:::ecs:runTask.waitForTaskToken",
         "Parameters":{  
            "LaunchType":"FARGATE",
            "Cluster":"cluster-arn",
            "TaskDefinition":"job-id",
            "Overrides":{  
               "ContainerOverrides":[  
                  {  
                     "Name":"container-name",
                     "Environment":[  
                        {  
                           "Name":"TASK_TOKEN_ENV_VARIABLE",
                           "Value.$":"$$.Task.Token"
                        }
                     ]
                  }
               ]
            }
         },
         "End":true
      }
   }
}

を他の AWS サービスStep Functionsで使用するときにIAMアクセス許可を設定する方法については、「」を参照してくださいStep Functions が統合サービスのIAMポリシーを生成する方法。