jdidata/flowbot

FlowBot Docker镜像文档

镜像概述

FlowBot是一个基于规则驱动的业务引擎，构建于mcr.microsoft.com/dotnet/aspnet:5.0-focal基础镜像之上。其核心目标是允许用户通过Web图形界面扩展现有系统和应用的功能，无需（或仅需最小化）编程更改，从而避免昂贵的软件开发生命周期（SDLC）成本。

核心功能与特性

主要操作能力

• 发送电子邮件
• 发送短信（TXT消息）
• 生成多种格式的文档
• 生成机器可读文件
• 连接第三方数据库提取数据
• 图像分析（物体和场景检测）
• 调用REST API

内置监听器

FlowBot包含内置"监听器"，可监控以下事件并触发操作：

• FTP/FTPS/SFTP站点变更
• Windows文件系统变更
• Office 365***新消息
• 树莓派数字引脚状态变化
• 树莓派+MCP3008 ADC模拟引脚状态变化

触发方式

• 通过REST API按需触发（开箱即用，无需额外配置）
• 通过Amazon SQS队列消息触发（需额外配置）

使用场景

• 企业自动化工作流（如文件处理、数据同步）
• 系统集成（连接不同应用和服务）
• 事件响应自动化（如文件变更触发处理流程）
• 低代码业务流程扩展（非开发人员配置业务规则）

使用方法

访问URL

启动后，可通过以下URL访问FlowBot：

• Web界面：http://localhost:8080
• API端点：http://localhost:8080/api
• API文档（Swagger）：http://localhost:8080/swagger

注意：默认运行在8080端口，可根据需求修改。

环境变量配置

需创建env.list文件配置运行环境变量，示例如下（详细参数说明）：

batch
# 数据库配置
DB_SERVER=localhost          # 数据库服务器地址
DB_NAME=cor                  # 数据库名称
DB_USER=someuser             # 数据库用户名
DB_PASS=somepass             # 数据库密码

# 消息队列配置
MessageQueueOptions__MQQueueingEnabled=false  # 是否启用消息队列
MessageQueueOptions__QueueUrl=                # 队列URL

# 缓存配置
CacheManagerOptions__DistributedCacheType=Memory  # 分布式缓存类型

# 第三方服务配置（Amazon相关）
ThirdPartyOptions__AmazonSQSOptions__AccountId=   # Amazon SQS账户ID
ThirdPartyOptions__AmazonSQSOptions__AccessKey=   # 访问密钥
ThirdPartyOptions__AmazonSQSOptions__SecretKey=   # 密钥
ThirdPartyOptions__AmazonSQSOptions__RegionName=  # 区域名称

# 系统管理员配置
System__SystemAdminUserName=system@jdiflowbot.com  # 系统管理员邮箱
System__SystemAdminPassword=                       # 系统管理员密码

# SMTP配置
SmtpServer__SMTPServer=       # SMTP服务器地址
SmtpServer__SMTPUser=         # SMTP用户名
SmtpServer__SMTPPassword=     # SMTP密码
SmtpServer__SMTPPort=         # SMTP端口
SmtpServer__RequireSMTPAuthentication=  # 是否需要SMTP认证

Docker运行示例

Windows平台（使用批处理脚本）

1. 创建env.list文件（参考上述示例）
2. 下载run_container.bat脚本：

batch
@echo off

echo. 
echo ================================================================
echo Welcome to the JDi Data FlowBot Docker Container Run Script
echo ================================================================
echo. 
echo Docker Community Edition MUST be installed BEFORE running this script
echo. 
echo This script will run the user-specified version of FlowBot. Please select a version that is available in the "jdidata / flowbot" repository on Docker Hub.
echo.
echo Please note that this script is NOT designed to start FlowBot in production environments

SETLOCAL ENABLEDELAYEDEXPANSION

SET VERSION=
SET DB_SERVER=
SET REUSE_VOLUME=
SET EXISTS=1

SET VOLUME_NAME=flowbot_vol

if not exist env.list (
	echo. 
	echo ERROR: You must create an env.list file that will contain the runtime environment variables for FlowBot. See SAMPLE_env.list for an example.
	exit /B
)

:prompt1
	set /p VERSION="Version: (i.e. 2019.02.32753): "
	IF "%VERSION%" == "" (
		goto :prompt1
	)
	echo.

:prompt2
	docker volume inspect %VOLUME_NAME%	> nul 2>&1
	IF ERRORLEVEL 1 SET EXISTS=0

	IF "%REUSE_VOLUME%" == "" (
		IF "%EXISTS%" == "1" (
			echo Provided you have not changed versions of FlowBot, you may reuse your existing storage volume to preserve your data stored within FlowBot.	
			CHOICE /M "Reuse existing volume?"
			IF ERRORLEVEL 1 SET REUSE_VOLUME=y
			IF ERRORLEVEL 2 SET REUSE_VOLUME=n
			echo.
			echo.
		)
	)
	
set IMAGE_NAME=jdidata/flowbot:%VERSION%

IF "%REUSE_VOLUME%" == "n" (
	echo Deleting volume %VOLUME_NAME%...
	docker volume rm %VOLUME_NAME% > nul 2>&1
	SET EXISTS=0
)

IF "%EXISTS%" == "0" (
	echo Creating volume %VOLUME_NAME%...
	docker volume create %VOLUME_NAME% > nul 2>&1
)

docker run -p 8080:80 -it --rm --name flowbot_app --mount source=%VOLUME_NAME%,target=/flowbot_data --env-file ./env.list %IMAGE_NAME%

3. 运行脚本，按提示输入版本号并选择是否复用现有卷

Linux/Unix平台（使用Shell脚本）

1. 创建env.list文件（参考上述示例）
2. 下载run_container.sh脚本：

bash
#!/bin/bash

echo
echo "=============================================================="
echo "Welcome to the JDi Data Claims Manager Docker Startup Script"
echo "=============================================================="
echo 
echo "Docker Community Edition MUST be installed BEFORE running this script"
echo
echo "This script will run the user-specified version of FlowBot. Please select a version that is available in the jdidata / flowbot repository on Docker Hub."
echo
echo "Please note that this script is NOT designed to start FlowBot in production environments"

VOLUME_NAME=flowbot_vol

if [ ! -f "env.list" ]; then
    echo ERROR: You must create an env.list file that will contain the runtime environment variables for FlowBot. See SAMPLE_env.list for an example of what your env.list file should contain.
    exit
fi

while [ -z ${VERSION+x} ]; do
    read -p "Version: (i.e. 2019.02.32753): " VERSION
done

VOLUME_EXISTS=$(docker volume inspect $VOLUME_NAME 2>/dev/null)
if [ "$VOLUME_EXISTS" != "[]" ]; then
    EXISTS=1
    echo "Provided you have not changed versions of FlowBot, you may reuse your existing storage volume to preserve your data stored within FlowBot."
    echo "Reuse existing volume (y/n)?"
    options=("Yes" "No")
    select opt in "${options[@]}"
    do
	case $opt in
	    "Yes") 
		REUSE_VOLUME=y
		break
		;;
	    "No") 
		REUSE_VOLUME=n
		break
		;;
	    *)
		echo "Invalid entry '$REPLY'. You must enter 1 or 2.";;
	esac
    done
fi

IMAGE_NAME=jdidata/flowbot:$VERSION

if [[ "$EXISTS" == "1" && "$REUSE_VOLUME" == "n" ]]; then
    echo "Deleting volume $VOLUME_NAME..."
    docker volume rm $VOLUME_NAME > /dev/null 2>&1
    EXISTS=0
fi

if [ "$EXISTS" == "0" ]; then 
    echo "Creating volume $VOLUME_NAME..."
    docker volume create $VOLUME_NAME > /dev/null 2>&1
fi

docker run -p 8080:80 -it --rm --name flowbot_app --mount source=$VOLUME_NAME,target=/flowbot_data --env-file ./env.list $IMAGE_NAME

3. 赋予执行权限并运行：

bash
chmod +x run_container.sh
./run_container.sh

4. 按提示输入版本号并选择是否复用现有卷

手动运行命令

若不使用脚本，可直接执行Docker命令：

bash
# 创建数据卷（首次运行）
docker volume create flowbot_vol

# 运行容器
docker run -p 8080:80 -it --rm --name flowbot_app \
  --mount source=flowbot_vol,target=/flowbot_data \
  --env-file ./env.list \
  docker.xuanyuan.run/jdidata/flowbot:版本号

注意：替换命令中的"版本号"为实际需要使用的FlowBot版本（如2019.02.32753）。