Netflix Conductor 项目 Docker 部署完全指南

Netflix Conductor 项目 Docker 部署完全指南

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

前言

Netflix Conductor 是一个功能强大的微服务编排引擎，它可以帮助开发者构建复杂的业务流程和工作流。本文将详细介绍如何使用 Docker 快速部署 Conductor 系统，包括其核心组件 API 服务器、UI 界面以及 Elasticsearch 搜索服务。

环境准备

在开始部署前，请确保您的系统满足以下要求：

1. 已安装 Docker 环境
2. 建议主机配置至少 16GB 内存，以支持多个容器同时运行
3. 确保 8080 和 5000 端口未被占用

基础部署步骤

1. 获取项目代码

首先需要获取 Conductor 项目的源代码，这是构建 Docker 镜像的基础。

2. 构建 Docker 镜像

进入项目目录后，执行以下命令构建 Docker 镜像：

cd docker
docker-compose build

这个命令会根据 docker-compose.yaml 文件中的配置构建所有必要的服务镜像。

3. 启动服务

构建完成后，使用以下命令启动所有服务：

docker-compose up

启动成功后，系统将运行以下三个核心服务：

1. Conductor API 服务器 - 提供工作流编排的核心功能
2. Conductor UI - 可视化界面，用于监控和管理工作流
3. Elasticsearch - 提供工作流搜索功能

服务访问验证

API 服务器

访问地址：http://localhost:8080

这里会显示 Swagger UI 界面，您可以在这里查看和测试所有可用的 API 接口。

管理界面

访问地址：http://localhost:5000

这是 Conductor 的图形化管理界面，您可以在这里创建、监控和管理工作流。

服务停止

要停止运行的服务，可以：

1. 在终端按 Ctrl+C 组合键
2. 完全停止并移除容器，执行：

docker-compose down

持久化存储选项

默认配置使用内存数据库，数据在服务停止后会丢失。Conductor 提供了多种持久化存储方案：

1. 内存模式 (docker-compose.yaml) - 适合测试和演示
2. Dynomite Redis (docker-compose-dynomite.yaml) - 高性能键值存储
3. PostgreSQL (docker-compose-postgres.yaml) - 关系型数据库方案
4. Prometheus (docker-compose-prometheus.yaml) - 监控方案

例如，要使用 PostgreSQL 作为后端存储，可以执行：

docker-compose -f docker-compose.yaml -f docker-compose-postgres.yaml up

独立组件部署

单独部署 API 服务器

docker build -t conductor:server -f server/Dockerfile ../
docker run -p 8080:8080 -d --name conductor_server conductor:server

单独部署 UI 界面

docker build -t conductor:ui -f ui/Dockerfile ../
docker run -p 5000:5000 -d --name conductor_ui conductor:ui

注意：单独部署 UI 时需要确保 API 服务器已在运行，且 Elasticsearch 服务可用，否则部分功能将无法使用。

监控集成

Conductor 支持与 Prometheus 集成进行监控：

docker-compose -f docker-compose-prometheus.yaml up -d

启动后可通过 http://127.0.0.1:9090 访问 Prometheus 监控界面。

常见问题解决方案

内存不足问题

1. 建议至少 16GB 内存运行完整环境
2. 如内存有限，可修改配置不使用 Elasticsearch

Elasticsearch 相关问题

1. ARM64 架构支持：6.8.x 版本无 ARM64 镜像，需使用 7.x 版本并做定制配置
2. 健康状态黄色：可通过设置 conductor.elasticsearch.clusterHealthColor=yellow 解决
3. 连接超时：单节点默认为黄色状态，建议部署集群或调整健康状态要求

配置更新问题

配置文件在构建时被复制到镜像中，如需更新配置：

1. 重新构建镜像
2. 或使用卷挂载方式动态加载配置

服务启动问题排查

1. 检查服务器日志：位于容器内的 /app/logs 目录
2. API 服务启动可能需要时间，请耐心等待并检查日志

高级部署选项

Conductor 还提供了服务器和 UI 合并部署的镜像方案：

docker build -t conductor:serverAndUI -f serverAndUI/Dockerfile ../

运行合并镜像：

• 使用内部数据库：docker run -p 8080:8080 -p 80:5000 -d -t conductor:serverAndUI
• 使用外部数据库：docker run -p 8080:8080 -p 80:5000 -d -t -e "CONFIG_PROP=config.properties" conductor:serverAndUI

结语

通过 Docker 部署 Netflix Conductor 可以快速搭建一个功能完整的工作流编排系统。本文涵盖了从基础部署到高级配置的完整流程，以及常见问题的解决方案。根据您的实际需求选择合适的存储后端和部署方式，可以构建出稳定可靠的微服务编排平台。

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