openiamdocker/workflow-ce

工作流容器社区版 (Workflow Container Community Edition)

镜像概述

工作流容器社区版是一个轻量级、开源的容器化解决方案，专为自动化工作流流程的构建、运行与管理设计。该镜像基于开源协议分发，提供基础工作流引擎功能，支持流程定义、任务调度与依赖管理，适用于开发者和小型团队快速落地各类自动化场景，无需复杂的基础设施配置。

核心功能与特性

• 轻量级设计：镜像体积精简，资源占用低，可在物理机、虚拟机、云服务器等多种环境高效运行。
• 多平台兼容：基于Docker容器化技术，支持Linux、Windows、macOS等主流操作系统及x86/ARM架构。
• 灵活的流程定义：支持YAML/JSON格式的工作流配置文件，可定义串行、并行、条件分支等复杂流程逻辑。
• 易于集成：提供标准HTTP API接口，可与GitLab、Jenkins、GitHub Actions等开发工具无缝集成。
• 开源免费：社区版完全免费，代码开源可审计，支持用户自定义扩展与二次开发。

使用场景与适用范围

典型使用场景

• CI/CD流程自动化：代码提交后自动触发构建、测试、部署全流程。
• 数据处理自动化：定时执行数据采集、清洗、分析、报表生成等任务。
• 定时任务管理：配置周期性任务（如日志清理、数据库备份、系统监控）。
• 业务流程自动化：实现审批流程、工单流转、消息通知等重复性业务操作。

适用人群与团队

• 独立开发者与技术爱好者
• DevOps工程师与运维团队
• 小型开发团队（10人以内）
• 需要快速落地流程自动化的初创企业

使用方法与配置说明

快速启动（Docker Run）

通过以下命令启动基础工作流容器实例：

bash
docker run -d \
  --name workflow-ce \
  -p 8080:8080 \
  -v $(pwd)/workflows:/app/workflows \
  workflow-container:community-latest

参数说明：

• -d：后台运行容器
• --name workflow-ce：指定容器名称为workflow-ce
• -p 8080:8080：映射容器8080端口（默认服务端口）到主机8080端口
• -v $(pwd)/workflows:/app/workflows：挂载主机当前目录下的workflows文件夹至容器内，用于持久化存储工作流配置文件

环境变量配置

通过环境变量自定义容器运行参数，常用配置如下：

带环境变量的启动示例：

bash
docker run -d \
  --name workflow-ce \
  -p 9000:9000 \
  -v $(pwd)/workflows:/app/workflows \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/plugins:/app/plugins \
  -e WORKFLOW_PORT=9000 \
  -e LOG_LEVEL=DEBUG \
  -e ALLOW_CORS=true \
  workflow-container:community-latest

Docker Compose 配置示例

创建docker-compose.yml文件，实现容器编排与持久化配置：

yaml
version: '3'
services:
  workflow-ce:
    image: workflow-container:community-latest
    container_name: workflow-ce
    restart: always  # 容器退出时自动重启
    ports:
      - "8080:8080"  # 端口映射
    volumes:
      - ./workflows:/app/workflows  # 工作流配置文件持久化
      - ./data:/app/data            # 元数据存储持久化
      - ./plugins:/app/plugins      # 自定义插件目录
    environment:
      - WORKFLOW_PORT=8080
      - LOG_LEVEL=INFO
      - ALLOW_CORS=false
    networks:
      - workflow-net  # 自定义网络隔离

networks:
  workflow-net:
    driver: bridge  # 使用桥接网络

启动命令：docker-compose up -d（后台启动）；停止命令：docker-compose down

扩展与注意事项

功能扩展

通过挂载/app/plugins目录，可集成自定义插件（如任务执行器、通知模块、第三方系统适配器），插件开发文档可参考官方社区 GitHub 仓库（需用户自行获取社区资源）。

生产环境建议

• 数据备份：定期备份workflows和data目录，避免容器重建导致配置与元数据丢失。
• 外部数据库：生产环境建议使用MySQL/PostgreSQL等外部数据库存储元数据，替代默认的本地文件存储。
• 资源限制：通过--memory和--cpus参数限制容器资源占用（如docker run --memory=2g --cpus=1 ...）。

社区支持

社区版不提供官方技术支持，用户可通过项目GitHub Issues或社区论坛获取帮助，版本更新需关注官方镜像仓库标签（如community-latest为最新版，community-v1.0为特定版本）。