Netflix Conductor 从源码构建与运行指南

Netflix Conductor 从源码构建与运行指南

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

前言

Netflix Conductor 是一个由 Netflix 开源的分布式工作流编排引擎，它通过可视化工作流定义和执行，帮助开发者构建复杂的微服务编排系统。本文将详细介绍如何从源码构建并运行 Netflix Conductor 系统，包括服务端和 UI 部分的完整搭建过程。

环境准备

在开始构建之前，请确保您的开发环境满足以下要求：

1. Java 开发环境：需要 JDK 17 或更高版本
2. Node.js 环境：用于构建和运行 UI 界面（建议使用 Node 14+）
3. Yarn 包管理器：用于管理前端依赖
4. Docker（可选）：用于运行测试环境

服务端构建与运行

1. 获取源码

首先需要获取 Netflix Conductor 的源代码。您可以通过版本控制工具获取最新代码。

git clone <conductor代码仓库地址>

2. 构建并运行服务端

进入项目目录后，使用 Gradle 构建并启动服务：

cd conductor/server
../gradlew bootRun

Mac 用户特别说明

如果您使用的是搭载 Apple Silicon 芯片的新款 Mac，需要对 conductor/grpc/build.gradle 文件进行以下修改：

protobuf {
    protoc {
        artifact = "com.google.protobuf:protoc:${revProtoBuf}:osx-x86_64"
    }
    plugins {
        grpc {
            artifact = "io.grpc:protoc-gen-grpc-java:${revGrpc}:osx-x86_64"
        }
    }
}

此外，您可能需要安装 Rosetta 兼容层：

softwareupdate --install-rosetta

3. 验证服务运行

服务启动后，您可以通过以下方式验证：

1. 访问 Swagger API 文档界面：http://localhost:8080/swagger-ui/index.html
2. 查看服务健康状态端点

使用预编译版本运行

如果您不想从源码构建，也可以直接下载预编译的 JAR 包运行：

export CONDUCTOR_VER=3.3.4
export REPO_URL=<maven仓库地址>
curl $REPO_URL/$CONDUCTOR_VER/conductor-server-$CONDUCTOR_VER-boot.jar \
--output conductor-server-$CONDUCTOR_VER-boot.jar; java -jar conductor-server-$CONDUCTOR_VER-boot.jar

UI 界面构建与运行

Netflix Conductor 提供了一个基于 React 的单页应用管理界面。

1. 安装依赖

进入 UI 目录并安装所需依赖：

cd conductor/ui
yarn install

2. 运行开发服务器

yarn run start

注意：运行 UI 前需要确保服务端已经在 8080 端口运行。

3. 访问 UI 界面

开发服务器启动后，在浏览器中访问：http://localhost:5000

重要注意事项

1. 数据持久性：默认使用内存存储，服务停止后所有工作流数据将丢失
2. 搜索功能：未配置索引服务时，UI 中的搜索功能将无法正常工作
3. 生产环境建议：对于生产环境，建议使用 Docker 部署并配置持久化存储和索引服务

结语

通过本文的步骤，您应该已经成功在本地搭建了 Netflix Conductor 的完整开发环境。这个强大的工作流引擎可以帮助您更好地管理和编排微服务架构中的复杂业务流程。下一步，您可以尝试创建自己的第一个工作流定义，体验 Conductor 的强大功能。

对于生产环境部署和更高级的配置，建议参考官方文档中的 Docker 部署指南，配置适当的持久化存储和索引服务，以获得完整的 Conductor 功能体验。

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