Activiti Cloud Query (JPA) 镜像文档

1. 镜像概述和主要用途

Activiti Cloud Query Service 的 JPA 实现。该服务使用关系型数据库存储 Runtime Bundles（运行时包）发出的事件，以高效方式支持读取和查询操作。作为参考实现，鼓励用户根据特定领域需求进行修改和定制。

此服务基于 activiti-cloud-starter-query 模块构建，开发者可像使用其他 Spring Boot Starter 一样，基于该模块创建自定义版本的查询服务。

2. 核心功能和特性

• JPA 数据存储：采用 JPA（Java Persistence API）与关系型数据库交互，高效存储流程事件数据
• 可扩展性：基于 Spring Boot Starter 构建，支持通过自定义实现扩展功能
• 事件消费与存储：消费流程引擎事件（如流程实例启动、任务完成等）并持久化到数据库
• 查询接口：提供标准化接口，支持查询流程实例、任务、变量等事件数据
• 微服务兼容：符合 Activiti Cloud 微服务架构，可与其他 Activiti Cloud 组件无缝集成

3. 使用场景和适用范围

• 流程事件查询：需要查询历史或实时流程事件数据（如流程状态、任务分配、变量变更等）的场景
• 流程监控与审计：企业流程管理中的监控面板、审计追踪需求
• 报表生成：基于流程事件数据生成自定义业务报表
• 自定义扩展：作为基础服务，通过扩展 activiti-cloud-starter-query 模块构建特定领域的查询服务

4. 构建与运行

4.1 从源码构建（Spring Boot）

通过 Git 和 Maven 从源码构建并运行：

bash
# 克隆代码仓库
git clone [***]
# 进入项目目录
cd activiti-cloud-query/
# 构建并运行
mvn clean install spring-boot:run

4.2 使用 Docker 镜像运行

直接使用 Docker 镜像部署：

bash
# 拉取并运行最新版镜像，映射端口 8182
docker run -p 8182:8182 -d --name activiti-cloud-query activiti/activiti-cloud-query:latest

5. 配置说明

5.1 环境变量

以下环境变量用于配置服务行为，可通过 -e 参数在 Docker 运行时指定：

6. 参考链接

• Docker 镜像地址
• Activiti & Activiti Cloud ***文档
• 源码仓库