Conductor项目中的工作流启动API详解-优快云博客

Conductor项目中的工作流启动API详解

conductor Conductor is a microservices orchestration engine. 项目地址: https://gitcode.com/gh_mirrors/co/conductor

概述

在微服务架构中，工作流引擎扮演着重要角色，Conductor作为一款开源的工作流编排引擎，提供了丰富的API来管理工作流。本文将重点介绍Conductor中启动工作流的核心API，帮助开发者快速掌握工作流启动的关键技术点。

工作流启动API基础

启动工作流是使用Conductor的最基本操作，通过向指定端点发送POST请求，可以触发工作流的执行。该API支持多种参数配置，满足不同场景下的需求。

核心参数说明

| 参数名称 | 描述 | 备注 | |---------|------|------| | name | 工作流名称 | 必须已在Conductor中注册 | | version | 工作流版本 | 默认使用最新版本 | | input | 输入参数JSON对象 | 供下游任务使用的键值对 | | correlationId | 关联ID | 用于关联多个工作流执行 | | taskToDomain | 任务到域映射 | 支持任务分组执行 | | workflowDef | 动态工作流定义 | 无需预先注册的工作流 | | externalInputPayloadStoragePath | 外部输入负载存储路径 | 由Java客户端处理 | | priority | 任务优先级 | 0-99之间的数值 |

标准工作流启动示例

{
  "name": "订单处理流程",
  "version": 2,
  "correlationId": "order_12345",
  "priority": 10,
  "input": {
    "orderId": "12345",
    "customerId": "67890",
    "items": ["item1", "item2"]
  },
  "taskToDomain": {
    "支付任务": "支付服务域",
    "库存任务": "库存服务域"
  }
}

在这个示例中，我们启动了一个名为"订单处理流程"的工作流，指定了版本号为2，并提供了订单相关的输入参数。通过taskToDomain参数，我们可以将特定任务路由到指定的服务域执行。

动态工作流技术

动态工作流是Conductor提供的一项强大功能，它允许开发者在不预先注册工作流定义的情况下直接执行工作流。这种模式特别适合以下场景：

一次性工作流需求
频繁变更的工作流逻辑
快速原型验证阶段

动态工作流示例

{
  "name": "临时数据采集流程",
  "workflowDef": {
    "name": "临时数据采集流程",
    "description": "用于临时数据采集任务",
    "version": 1,
    "tasks": [
      {
        "name": "获取用户数据",
        "type": "HTTP",
        "taskReferenceName": "get_user_data",
        "inputParameters": {
          "http_request": {
            "uri": "${workflow.input.user_api}",
            "method": "GET"
          }
        }
      },
      {
        "name": "处理用户数据",
        "type": "SIMPLE",
        "taskReferenceName": "process_user_data"
      }
    ]
  },
  "input": {
    "user_api": "https://api.example.com/users"
  }
}

在这个动态工作流示例中，我们定义了一个包含两个任务的工作流：一个HTTP任务用于获取用户数据，一个简单任务用于处理数据。整个工作流定义直接包含在请求体中，无需预先注册。