本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Step Functions 管理 Amazon ECS 或 Fargate 任务
Step Functions 可以控制某些Amazon直接来自 Amazon 状态语言的服务。有关使用的更多信息Amazon Step Functions请参阅以下内容以下内容:
.sync 集成模式可用。
ecs:runTask
可以返回 HTTP 200 响应,但有一个非空的响应Failures
字段,如下所示:请求响应:返回响应,不要失败任务。这与没有优化是一样的。
运行作业: 如果是非空的
Failures
字段遇到,该任务失败并显示AmazonECS.Unknown
错误消息。任务令牌: 如果是非空的
Failures
字段遇到,该任务失败并显示AmazonECS.Unknown
错误消息。
支持的 Amazon ECS/Fargate API 和语法:
Step Functions 中的参数表示为PascalCase
,即使本机服务 API 是camelCase
.
-
RunTask
使用指定的任务定义启动新任务。
对于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 策略.