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

实现并注册 Activity 与 Worker

实现并注册 Activity 与 Worker

这一节把一个会读取本地文件的 I/O 操作放进 Activity,并用 Go Worker 注册 Workflow 与 Activity。完成后,你会得到一个能连接本地 Temporal Service、监听指定 Task Queue 并等待领取任务的最小 Worker。

学习目标

  • 判断哪些外部 I/O 必须从 Workflow 移到 Activity。
  • 使用 Go SDK 注册 Workflow、Activity,并启动 Worker。
  • 说明 Worker、Task Queue 与任务领取之间的关系。

把外部 I/O 放进 Activity

Workflow 代码会在故障恢复和任务重放时再次执行,因此它必须保持确定性。读取文件、访问数据库、发 HTTP 请求这类操作依赖进程外部状态,结果可能随时间变化,应放进 Activity;Workflow 只负责决定“何时执行 Activity、等待什么结果、下一步做什么”。

下面的示例让 ReadMessage 读取文件,而 FileWorkflow 仅通过 workflow.ExecuteActivity 调用它。Activity 失败时,错误会返回给 Temporal,后续是否重试由 Activity 的重试与超时策略决定。

实现可运行的 Worker

前置条件是本机已有 Temporal Service 监听 localhost:7233,并且当前目录可以创建 Go Module。先初始化依赖:

bash
go mod init temporal-worker-demo
go get go.temporal.io/sdk@latest

预期结果:目录中生成 go.mod 和 go.sum,go.mod 记录 go.temporal.io/sdk 依赖;具体下载日志与版本号可能不同。

创建 main.go:

go
package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"strings"
	"time"

	"go.temporal.io/sdk/activity"
	"go.temporal.io/sdk/client"
	"go.temporal.io/sdk/worker"
	"go.temporal.io/sdk/workflow"
)

const taskQueue = "file-io"

func ReadMessage(ctx context.Context, path string) (string, error) {
	data, err := os.ReadFile(path)
	if err != nil {
		return "", fmt.Errorf("read %s: %w", path, err)
	}
	activity.GetLogger(ctx).Info("message loaded", "path", path, "bytes", len(data))
	return strings.TrimSpace(string(data)), nil
}

func FileWorkflow(ctx workflow.Context, path string) (string, error) {
	ctx = workflow.WithActivityOptions(ctx, workflow.ActivityOptions{
		StartToCloseTimeout:    10 * time.Second,
		ScheduleToCloseTimeout: 30 * time.Second,
	})

	var result string
	err := workflow.ExecuteActivity(ctx, ReadMessage, path).Get(ctx, &result)
	return result, err
}

func main() {
	c, err := client.Dial(client.Options{
		HostPort:  client.DefaultHostPort,
		Namespace: client.DefaultNamespace,
	})
	if err != nil {
		log.Fatal(err)
	}
	defer c.Close()

	w := worker.New(c, taskQueue, worker.Options{})
	w.RegisterWorkflow(FileWorkflow)
	w.RegisterActivity(ReadMessage)

	log.Printf("worker ready: task_queue=%s workflow=FileWorkflow activity=ReadMessage", taskQueue)
	if err := w.Run(worker.InterruptCh()); err != nil {
		log.Fatal(err)
	}
}

这里必须先调用 RegisterWorkflow 和 RegisterActivity,再执行 w.Run。注册动作建立的是 Worker 进程内的类型映射;真正的 Workflow Execution 与 Activity Execution 仍由 Temporal Service 创建和调度。

运行 Worker:

bash
go run .

预期输出:

text
<TIME> worker ready: task_queue=file-io workflow=FileWorkflow activity=ReadMessage

进程随后保持运行并持续轮询 Task Queue;<TIME> 会随实际运行时间变化。

Worker 如何通过 Task Queue 领取任务

Temporal Service 把待执行的 Workflow Task 或 Activity Task 放到命名 Task Queue。Worker 对 file-io 做长轮询;拿到 Workflow Task 后执行已注册的 FileWorkflow,Workflow 再调度 ReadMessage Activity;对应 Activity Task 被领取后,Worker 才真正访问文件系统。

Worker 通过 Task Queue 领取并执行 Workflow 与 Activity 任务

Task Queue 负责把任务路由给合适的 Worker,但它不是业务消息队列。多个 Worker 可以监听同一个队列来水平扩展;如果启动 Workflow 时填写了不同的 Task Queue,即使代码已注册,当前 Worker 也不会收到那次执行的任务。

注册失败时先检查什么

如果 Worker 启动后一直没有执行,先核对启动 Workflow 使用的 Task Queue 是否与 file-io 完全一致。若队列一致但类型未注册,Worker 无法按类型名找到对应 Workflow 或 Activity,任务会失败或继续重试,而不是自动调用一个“名字相近”的函数。

Activity 中可以进行外部 I/O,Workflow 中则只保留可重放的编排逻辑。把这个边界守住,再确保“注册类型”和“监听队列”同时匹配,Worker 才能稳定领取并执行 Temporal 任务。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现并注册 Activity 与 Worker

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

登录哪都通