使用 Step Functions 管理 Amazon ECS 或 Fargate 任务 - Amazon Step Functions
将数据传递给 Amazon ECS 任务
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Step Functions 管理 Amazon ECS 或 Fargate 任务

Step Functions 可以控制某些Amazon直接来自 Amazon 状态语言的服务。有关使用的更多信息Amazon Step Functions请参阅以下内容以下内容：

优化的亚马逊ECS/Fargate 集成与 Amazon ECS 或 Fargate 的不同AmazonSDK 集成

  • .sync 集成模式可用。

  • ecs:runTask可以返回 HTTP 200 响应，但有一个非空的响应Failures字段，如下所示：

    • 请求响应：返回响应，不要失败任务。这与没有优化是一样的。

    • 运行作业: 如果是非空的Failures字段遇到，该任务失败并显示AmazonECS.Unknown错误消息。

    • 任务令牌: 如果是非空的Failures字段遇到，该任务失败并显示AmazonECS.Unknown错误消息。

支持的 Amazon ECS/Fargate API 和语法：

注意

Step Functions 中的参数表示为PascalCase，即使本机服务 API 是camelCase.

注意

对于Overrides参数，Step Functions 不支持executionRoleArn要么taskRoleArn如同ContainerOverrides.

将数据传递给 Amazon ECS 任务

Step Functions 可以控制某些Amazon直接来自 Amazon 状态语言的服务。有关使用的更多信息Amazon Step Functions请参阅以下内容以下内容：

您可以使用overrides覆盖容器的默认命令，并将输入传递给 Amazon ECS 任务。请参阅ContainerOverride。在该示例中，我们使用 JsonPath 将值从 Task 状态的输入传递给 Task。

下面这个Task状态，运行 Amazon ECS 任务并等待任务完成。

{
 "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"
  ]
}

下面这个Task状态，运行 Amazon ECS 任务，然后等待返回任务令牌。请参阅等待具有任务令牌的回调。

{  
   "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
      }
   }
}

有关在将 Step Functions 与其他一起使用时如何配置 IAM 的信息。Amazon服务，请参阅针对集成服务的 IAM 策略.