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

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

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

Step Functions 可以直接从 Amazon States Language (ASL) 控制某些 Amazon 服务。有关使用 Amazon Step Functions 及其集成的更多信息，请参阅以下内容：

优化的 Amazon ECS/Fargate 集成与 Amazon ECS 或 Fargate Amazon 开发工具包集成有何不同

  • 支持运行作业 (.sync) 集成模式。

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

    • 请求响应：返回响应，任务不会失败。这与不进行优化相同。

    • 运行作业或任务令牌：如果遇到非空 Failures 字段，则任务会因 AmazonECS.Unknown 错误而失败。

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

注意

Step Functions 中的参数以 PascalCase 表示，即使原生服务 API 使用 camelCase 也是如此。例如，您可以使用 Step Functions API 操作 startSyncExecution 并将其参数指定为 StateMachineArn。

向 Amazon ECS 任务传递数据

Step Functions 可以直接从 Amazon States Language (ASL) 控制某些 Amazon 服务。有关使用 Amazon Step Functions 及其集成的更多信息，请参阅以下内容：

您可以使用 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
      }
   }
}

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