第2章 创建任务定义
创建 / 更新任务定义
任务定义规定了任务的通用实现细节:
超时策略 重试逻辑 速率限制和执行限制 输入/输出 keys 输入模板
该定义适用于该任务在所有工作流中的所有实例。 可以通过 Conductor UI、CLI 或 API 创建任务定义,适用于以下场景:
Worker 任务:所有 worker 任务(SIMPLE)必须先在 Conductor 服务器上注册为任务定义,才能在工作流中执行。 系统任务:系统任务不需要任务定义,但可以创建同名定义来自定义重试、超时和速率限制行为。
使用 Conductor UI
通过 UI 可以可视化地创建或更新任务定义。
创建任务定义
创建步骤:
在左侧导航中打开 Definitions,选择 Task。 点击 Define task。 在 Task 表单中配置任务,或打开 Code 标签页直接编辑 JSON。完整参数说明参见 Task Definitions。 点击 Save。
更新任务定义
更新步骤:
在左侧导航中打开 Definitions,选择 Task,然后选择要更新的任务定义。 在 Task 表单或 Code 标签页中修改任务。完整参数说明参见 Task Definitions。 点击 Save。
使用 CLI
将任务定义保存为 JSON 文件,然后运行: conductor task create taskdef.json
文件可以包含单个任务定义对象,也可以是对象数组。要更新已有定义,先编辑文件,再运行: conductor task update taskdef.json
完整参数说明参见 Task Definitions。
使用 API
完整参数说明参见 Task Definitions。
创建任务定义
也可以通过 Create Task Definition API(POST /api/metadata/taskdefs)创建任务定义。该 API 接受任务定义数组,支持批量创建。
cURL 示例 curl 'http://localhost:8080/api/metadata/taskdefs' \ -H 'accept: */*' \ -H 'content-type: application/json' \ --data-raw '[{"name":"sample_task_name_1","description":"This is a sample task for demo","responseTimeoutSeconds":10,"timeoutSeconds":30,"inputKeys":[],"outputKeys":[],"timeoutPolicy":"TIME_OUT_WF","retryCount":3,"retryLogic":"FIXED","retryDelaySeconds":5,"inputTemplate":{},"rateLimitPerFrequency":0,"rateLimitFrequencyInSeconds":1}]'
更新任务定义
可以通过 Update Task Definition API(PUT /api/metadata/taskdefs)更新任务定义。该 API 每次只能更新一个任务定义。
cURL 示例 curl 'http://localhost:8080/api/metadata/taskdefs' \ -X 'PUT' \ -H 'accept: */*' \ -H 'content-type: application/json' \ --data-raw '{"name":"sample_task_name_1","description":"This is a sample task for demo","responseTimeoutSeconds":10,"timeoutSeconds":30,"inputKeys":[],"outputKeys":[],"timeoutPolicy":"TIME_OUT_WF","retryCount":3,"retryLogic":"FIXED","retryDelaySeconds":5,"inputTemplate":{},"rateLimitPerFrequency":0,"rateLimitFrequencyInSeconds":1}'
使用 SDK
每个客户端 SDK 都提供 metadata-client 方法,调用相同的创建和更新接口。当任务注册属于应用或部署代码的一部分,而不是手动操作时,可以使用 SDK。
复用任务
任务在 Conductor 中定义后,可以被多次复用:
同一工作流内:使用同一任务,但指定不同的任务引用名称。 跨工作流:任何工作流都可以引用任何已注册的任务定义。
在多租户系统中复用任务时,分配给某个任务的所有工作默认进入同一个队列。如果某个“吵闹的邻居”导致轮询延迟,可以增加 worker 数量,或使用 task-to-domain 将任务负载路由到独立队列。