进阶 docs.conductor-oss.org 2026-10-18 06:22:09 · 23 阅读

第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 将任务负载路由到独立队列。

评论 (0)