本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
提交作业
在注册作业定义后,您可以将其作为作业提交到 Amazon Batch 作业队列。在运行时,可以覆盖作业定义中指定的许多参数。
提交作业
-
打开Amazon Batch控制台https://console.aws.amazon.com/batch/
. -
从导航栏中,选择要使用的区域。
-
在导航窗格中,选择 Jobs 和 Submit job。
-
对于 Job name,请为您的队列选择唯一的名称。
-
对于 Job definition,为作业选择之前创建的作业定义。有关更多信息,请参阅 创建单节点作业定义 。
-
对于 Job queue,选择之前创建的作业队列。有关更多信息,请参阅 创建作业队列。
-
对于 Job type,为单个作业选择 Single,或选择 Array 以提交数组作业。有关更多信息,请参阅 数组作业。此选项不适用于多节点 parallel 作业。
-
(仅限数组作业) 对于 Array size,指定一个介于 2 和 10000 之间的数组大小。
-
(可选) 声明任何作业依赖项。一个作业最多可有 20 个依赖项。有关更多信息,请参阅 作业依赖项。
-
对于 Job depends on,输入必须在此作业启动前完成的任何作业的作业 ID。
-
(仅限数组作业) 对于 N-To-N job dependencies,指定任何数组作业的一个或多个作业 ID (此作业的每个子作业索引均依赖于依赖项的相应子索引作业)。例如,
JobB:1
依赖于JobA:1
,依此类推。 -
(仅限数组作业) 选择 Run children sequentially 来为当前数组作业创建
SEQUENTIAL
依赖项。这可确保每个子索引作业等待其之前的作业完成。例如,JobA:1
依赖于JobA:0
,依此类推。
-
-
对于 Job attempts,指定尝试作业的最大次数 (在尝试失败的情况下)。有关更多信息,请参阅 自动作业重试。
-
(可选)对于 Execution timeout (执行超时),指定允许作业尝试运行的最大秒数。如果某次尝试超过了超时时间,该尝试将停止,状态将转为
FAILED
。有关更多信息,请参阅 作业超时。重要 在 Fargate 资源上运行的作业不能期望运行超过 14 天。14 天后,Fargate 资源可能不再可用,任务将被终止。
-
(可选)在 Parameters (参数) 部分中,您可以指定参数替代默认值和占位符,以便在您的作业容器启动时所运行的命令中使用。有关更多信息,请参阅 参数。
-
选择 Add parameter (添加参数)。
-
对于 Key,指定参数的键。
-
对于 Value,指定参数的值。
-
-
对于 vCPUs,指定要为容器预留的 vCPU 数量。此参数将映射到 Docker Remote API
的创建容器 部分中的 CpuShares
以及 docker run的 --cpu-shares
选项。每个 vCPU 相当于 1024 个 CPU 份额。您必须指定至少一个 vCPU。 -
对于 Memory,指定要提供给作业容器的内存硬限制 (以 MiB 为单位)。如果您的容器尝试使用超出此处指定的内存,该容器将被终止。此参数将映射到 Docker Remote API
的创建容器 部分中的 Memory
以及 docker run的 --memory
选项。您必须为任务指定至少 4 MiB 内存。 -
(可选)对于 Number of GPU ,指定您的作业将使用的 GPU 的数量。
该作业将在固定有指定数量的 GPU 的容器上运行。
-
对于 Command,指定要传递到容器的命令。对于简单的命令,您可以在 Space delimited 选项卡上键入命令,就像在命令提示符中键入命令一样。确保 JSON 结果 (该结果将传递到 Docker 守护程序) 正确无误。对于较复杂的命令 (例如,带有特殊字符),您可以切换到 JSON 选项卡,然后在该选项卡中输入等效字符串数组。
此参数映射到 Docker Remote API
创建容器 部分中的 Cmd
,以及 docker run的 COMMAND
参数。有关 DockerCMD
参数的更多信息,请转到 https://docs.docker.com/engine/reference/builder/#cmd。 注意 您可以在命令中使用参数替代默认值和占位符。有关更多信息,请参阅 参数。
-
(可选) 您可以指定要传递到您的作业容器的环境变量。此参数将映射到 Docker Remote API
的创建容器 部分中的 Env
以及 docker run的 --env
选项。重要 建议不要对敏感信息(如凭证数据)使用纯文本环境变量。
-
选择 Add environment variable (添加环境变量)。
-
对于 Key,指定环境变量的键。
注意 环境变量不能以
AWS_BATCH
开头;此命名约定是为 Amazon Batch 服务所设置的变量保留的。 -
对于 Value,指定环境变量的值。
-
-
(可选)在标签部分,您可以为要与作业关联的每个标签指定键和值。有关更多信息,请参阅 给您的 Amazon Batch 资源加标签。
-
选择 Submit job。
注意 的 日志
RUNNING
、SUCCEEDED
, 和FAILED
在任务中可用 CloudWatch 日志;日志组是/aws/batch/job
,日志流名称格式为
(这种格式 future 可能会更改)。first200CharsOfJobDefinitionName
/default/ecs_task_id
在任务到达
RUNNING
状态后,您可以使用 DescribeJobs API 操作以编程方式检索其日志流名称。有关更多信息,请参阅 。查看发送到 的日志数据 CloudWatch 日志中的亚马逊 CloudWatch 日志用户指南. 默认情况下,这些日志设置为永不过期,但您可以修改保留期。有关更多信息,请参阅 。更改 中的日志数据保留期 CloudWatch 日志中的亚马逊 CloudWatch 日志用户指南.