工作流执行
了解工作流的执行模型、生命周期和执行选项。
核心概念
工流执行是工作流的一次具体运行。每次执行都有唯一的 RunID, 但可以共享相同的 WorkflowID。
工作流 ID vs Run ID
Workflow ID
工作流的业务标识符,由您指定。同一个 Workflow ID 可以有多个执行(Run ID)。
order-12345
Run ID
每次工作流执行的唯一标识符,由 Temporal Server 自动生成。
52e34b03-93b1-4d24-bfb9-6c0c8389d3f6
启动工作流执行
start_workflow.go
package main
import (
"context"
"log"
"go.temporal.io/sdk/client"
)
func startWorkflow(c client.Client) {
// 配置启动选项
options := client.StartWorkflowOptions{
ID: "my-workflow-id", // 工作流 ID
TaskQueue: "my-task-queue", // 任务队列
}
// 启动工作流
we, err := c.ExecuteWorkflow(
context.Background(),
options,
MyWorkflow, // 工作流函数
"input-param", // 工作流参数
)
if err != nil {
log.Fatalf("Failed to execute workflow: %v", err)
}
log.Printf("Started workflow. WorkflowID: %s, RunID: %s",
we.GetID(), we.GetRunID())
}
工作流执行选项
ID
工作流的业务标识符。如果 ID 已存在且工作流正在运行, 将返回已有执行的 WorkflowExecution。
TaskQueue
指定运行此工作流的 Worker 订阅的任务队列。
WorkflowExecutionTimeout
工作流执行的超时时间。包括所有活动和子工作流的执行时间。
WorkflowRunTimeout
单次工作流运行的超时时间。不包括重试和子工作流的时间。
WorkflowTaskTimeout
单个工作流任务的超时时间。
工作流生命周期
1. 启动(Started)
客户端调用 ExecuteWorkflow,工作流开始执行。
2. 运行中(Running)
Worker 接收工作流任务,开始执行工作流代码。
3. 等待(Waiting)
工作流等待活动完成、定时器到期或外部信号。
4. 完成(Completed)
工作流成功执行完成并返回结果。
5. 失败(Failed)
工作流执行失败,可以配置重试策略。
工作流重试
retry_policy.go
package main
import (
"time"
"go.temporal.io/sdk/client"
"go.temporal.io/sdk/temporal"
)
func startWorkflowWithRetry(c client.Client) {
// 配置重试策略
retryPolicy := &temporal.RetryPolicy{
InitialInterval: time.Second, // 初始间隔
BackoffCoefficient: 2.0, // 退避系数
MaximumInterval: 10 * time.Second, // 最大间隔
MaximumAttempts: 5, // 最大尝试次数
}
options := client.StartWorkflowOptions{
ID: "workflow-with-retry",
TaskQueue: "my-task-queue",
RetryPolicy: retryPolicy,
}
we, err := c.ExecuteWorkflow(
context.Background(),
options,
MyWorkflow,
)
// ...
}
获取工作流结果
get_result.go
package main
import (
"context"
"log"
)
func getWorkflowResult(we client.WorkflowExecution) {
// 等待工作流完成
var result string
err := we.Get(context.Background(), &result)
if err != nil {
log.Fatalf("Workflow failed: %v", err)
}
log.Printf("Workflow result: %s", result)
}
// 异步获取结果
func getWorkflowResultAsync(we client.WorkflowExecution) {
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
var result string
err := we.Get(ctx, &result)
if err != nil {
log.Printf("Workflow failed or timed out: %v", err)
return
}
log.Printf("Workflow result: %s", result)
}
相关主题
版权与许可:Temporal 官方文档及其中文译文项目采用 MIT License;保留原作者声明,详见许可证。