服务注册与分布式协调 / 系统课时

认识 Client、Server、Worker 与 Task Queue

认识 Client、Server、Worker 与 Task Queue

这一课解决 Temporal 四个核心角色的职责边界:谁发起请求、谁保存执行事实、谁分发任务、谁真正运行代码。理解这条通信链后,就能正确判断启动、恢复、扩容和排障时各组件应承担的责任。

学习目标

  • 说清 Client、Temporal Server、Worker 与 Task Queue 的职责边界
  • 跟踪一次 Workflow 启动后,Workflow Task 与 Activity Task 如何被分发和处理
  • 判断常见架构误解,例如“Client 直接调用 Worker”或“Task Queue 保存 Workflow 状态”

四个角色各自负责什么

Client 是应用访问 Temporal 的入口。它通过 SDK 调用 Temporal Server,用于启动 Workflow、发送 Signal 或 Update、发起 Query、取消执行以及读取结果。Client 不需要知道某个 Worker 实例的地址,也不会把业务任务直接推给 Worker。

Temporal Server 是可靠执行的控制平面。它接收 Client 与 Worker 的请求,维护 Workflow Execution 的 Event History 和执行元数据,并根据历史中的事件推进后续调度。Server 负责持久化与协调,但不会加载并执行你的 Workflow 或 Activity 业务代码。

Worker 是运行应用代码的进程。Worker 启动后向指定 Task Queue 进行长轮询,拿到 Workflow Task、Activity Task 等任务后,在本地执行已经注册的 Workflow 或 Activity 代码,再把命令或执行结果返回给 Server。

Task Queue 是 Server 侧的轻量级动态任务队列,用名字连接“要处理的任务”和“能够处理这些任务的 Worker”。它承担路由和负载分发,不是 Workflow 业务状态的权威存储,也不是让 Client 与 Worker 直接通信的通道。

角色 主要职责 不负责什么
Client 向 Server 发起控制与查询请求 不直接选择具体 Worker 实例
Server 持久化执行事实、生成并协调任务 不执行用户业务代码
Task Queue 把待处理 Task 路由给轮询它的 Worker 不保存完整 Workflow 状态
Worker 轮询 Task Queue 并执行应用代码 不成为 Workflow 状态的唯一持有者

一次启动如何穿过系统

启动 Workflow 时,Client 先把 Workflow Type、Workflow ID、Task Queue 和输入提交给 Server。Server 创建执行并记录事件,然后把需要推进 Workflow 的 Workflow Task 放到对应 Task Queue。某个 Worker 长轮询拿到任务后执行 Workflow 代码,根据结果生成命令,例如安排 Activity、创建 Timer 或完成 Workflow,再把这些命令交回 Server。

如果 Workflow 安排了 Activity,Server 会记录这一决定并产生 Activity Task。轮询相应 Task Queue 的 Worker 执行 Activity 后,把完成结果或失败返回 Server;Server 再记录事件并安排新的 Workflow Task,让 Workflow 代码基于新增历史继续推进。整个过程中,Worker 可以重启或横向扩容,因为执行事实保存在 Server 管理的持久化状态中。

Client、Server、Task Queue 与 Worker 的通信关系

下面是片段示例,依赖已经创建的 Go SDK client.Client、context.Context,以及 Worker 中已注册的 OrderWorkflow。它不是独立可运行程序,只用于观察一次启动请求里 Workflow ID 与 Task Queue 的位置。

go
// Workflow ID 表达业务身份;TaskQueue 决定任务路由到哪组轮询者。
run, err := temporalClient.ExecuteWorkflow(
    ctx,
    client.StartWorkflowOptions{
        ID:        "order-123",
        TaskQueue: "order-processing",
    },
    OrderWorkflow,
    "order-123",
)
if err != nil {
    return err
}
// Run ID 由 Server 为这一次运行分配。
fmt.Println(run.GetID(), run.GetRunID())

这段调用只把启动意图发送给 Server。TaskQueue: "order-processing" 表示后续 Workflow Task 应路由到哪一组轮询者,并不表示 Client 已经选中了某个 Worker。只要兼容的 Worker 轮询同名 Task Queue,就可以竞争领取任务。

Task Queue 不是传统消息队列替身

把 Task Queue 当成 Kafka 或 RabbitMQ 的业务消息主题,会造成错误设计。Temporal 的 Task 是 Server 为推进 Workflow Execution 生成的内部工作单元;应用真正需要长期可靠保存的执行事实进入 Event History,而不是由业务代码自己消费一条消息后手工维护状态机。

同一个 Task Queue 可以由多个 Worker 共同轮询,从而横向扩展处理能力。反过来,如果没有兼容 Worker 轮询某个 Task Queue,任务会等待,Workflow 也不会凭空在 Server 上执行。排查“Workflow 一直不动”时,因此既要看执行历史,也要确认目标 Task Queue 是否有正确的 Worker 在轮询。

用通信方向快速判断职责

遇到 Temporal 架构问题时,可以先按通信方向判断:Client 面向 Server 发起控制请求,Server 根据持久化历史生成 Task,Worker 主动从 Task Queue 拉取 Task,再把命令或结果交回 Server。只要记住“Server 保证执行事实,Worker 提供计算能力,Task Queue 连接二者”,大多数职责边界就不会混淆。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识 Client、Server、Worker 与 Task Queue

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通