Activiti Modeling Application 7.9.0 详细介绍与快速部署清单

文章目录

• • [一、Activiti Modeling App 7.9.0 核心特性与架构](#一、Activiti Modeling App 7.9.0 核心特性与架构)
  • • [1.1. 核心功能](#1.1. 核心功能)
    • [1.2. 技术架构](#1.2. 技术架构)
    • [1.3. 兼容环境](#1.3. 兼容环境)
  • [二、快速部署清单（分 2 种部署模式）](#二、快速部署清单（分 2 种部署模式）)
  • • 2.1.前置条件
    • [2.2.模式 1：Docker Compose 快速部署](#2.2.模式 1：Docker Compose 快速部署)
    • [2.3.模式 2：源码编译部署（适合二次开发）](#2.3.模式 2：源码编译部署（适合二次开发）)
    • 2.4.生产环境部署补充清单
  • 三、常见问题与解决
  • 四、核心目录结构（源码部署参考）

Activiti Modeling Application (AMA) 7.9.0 是 Alfresco 推出的低代码流程建模工具，基于 Activiti 7 核心引擎，专注于可视化设计 BPMN 2.0 流程、DMN 决策表、表单等，支持与 Activiti Runtime 集成实现流程执行，适用于企业级流程自动化场景。以下是详细介绍和可落地的快速部署清单。

---

一、Activiti Modeling App 7.9.0 核心特性与架构

1.1. 核心功能

模块	核心能力
BPMN 2.0 建模	可视化拖拽设计流程（网关、任务、事件、边界事件等），支持流程校验、导出 BPMN XML
DMN 决策表设计	可视化编辑决策表、决策逻辑，支持 FEEL 表达式，导出 DMN 1.3 标准文件
表单设计器	拖拽式设计表单（文本、下拉、日期、附件等控件），支持表单与流程任务绑定
版本管理	模型版本化管理，支持版本对比、回滚、发布
团队协作	模型权限控制（查看 / 编辑）、评论功能，支持多人协同建模
集成能力	与 Activiti Runtime 7.x 无缝集成，一键发布模型到运行时引擎；支持 REST API 扩展
自定义扩展	支持自定义建模规则、表单控件、BPMN 元素属性，适配企业个性化需求

1.2. 技术架构

• 前端：基于 Angular 12 + TypeScript，使用 bpmn-js/dmn-js 作为核心建模引擎，UI 框架采用 Clarity Design。
• 后端：基于 Spring Boot 2.6.x，核心依赖 Activiti Core 7.9.0、Activiti Cloud Services，支持微服务 / 单体部署。
• 存储：默认嵌入式 H2（开发环境），生产支持 PostgreSQL/MySQL；可选集成 Alfresco Content Services 存储模型文件。
• 认证授权：默认 Keycloak（OpenID Connect），支持 LDAP/Active Directory 集成。

1.3. 兼容环境

• JDK：11（必须，7.9.0 不再支持 JDK 8）
• 浏览器：Chrome 88+、Firefox 85+、Edge 88+
• 后端依赖：Activiti Core 7.9.0、Activiti Cloud 7.9.0（微服务部署时）
• 数据库：PostgreSQL 12+、MySQL 8.0+（生产）、H2 1.4.200（开发）
• Keycloak：15.0.2+（认证服务）

二、快速部署清单（分 2 种部署模式）

2.1.前置条件

• 服务器 / 本地环境：至少 2 核 4G 内存，10G 磁盘空间
• 安装：Docker + Docker Compose（推荐容器部署），或 JDK 11 + Maven 3.8.x（源码部署）
• 网络：允许访问 Maven 中央仓库、Docker Hub

2.2.模式 1：Docker Compose 快速部署

• 步骤 1：下载官方部署配置

# 创建部署目录
mkdir activiti-modeling-7.9.0 && cd activiti-modeling-7.9.0

# 下载官方docker-compose.yml（7.9.0 版本）
curl -O https://raw.githubusercontent.com/Activiti/activiti-modeling-app/7.9.0/docker/docker-compose.yml

# （可选）下载自定义配置文件（如数据库、Keycloak配置）
curl -O https://raw.githubusercontent.com/Activiti/activiti-modeling-app/7.9.0/docker/.env

• 步骤 2：修改配置（关键）
  编辑 .env 文件，调整核心参数：

# 基础配置
ACTIVITI_VERSION=7.9.0
SPRING_PROFILES_ACTIVE=dev,auth

# 数据库配置（默认H2，生产改MySQL/PostgreSQL）
DB_TYPE=h2
DB_URL=jdbc:h2:mem:activiti;DB_CLOSE_DELAY=-1
DB_USER=sa
DB_PASSWORD=

# Keycloak 配置（默认内置，生产建议独立部署）
KEYCLOAK_URL=http://localhost:8180/auth
KEYCLOAK_REALM=activiti
KEYCLOAK_CLIENT_ID=activiti-modeling
KEYCLOAK_USER=admin
KEYCLOAK_PASSWORD=admin

# 端口配置
MODELING_APP_PORT=8080
KEYCLOAK_PORT=8180

• 步骤 3：启动服务

# 启动所有服务（Modeling App + Keycloak + 内置数据库）
docker-compose up -d

# 查看启动日志
docker-compose logs -f activiti-modeling-app

• 步骤 4：访问验证
  访问地址：http://<服务器 IP>:8080
  默认账号：admin/admin
  验证：登录后可创建 BPMN 流程、DMN 决策表，确认建模功能正常。

2.3.模式 2：源码编译部署（适合二次开发）

• 步骤 1：拉取源码

# 克隆7.9.0版本源码
git clone -b 7.9.0 https://github.com/Activiti/activiti-modeling-app.git
cd activiti-modeling-app

• 步骤 2：编译前端（Node.js 14+ 环境）

# 安装前端依赖
cd app
npm install

# 编译前端资源（输出到dist目录）
npm run build --prod

• 步骤 3：编译后端（Maven 3.8+ + JDK 11）

# 返回根目录
cd ..

# 编译后端工程（跳过测试）
mvn clean package -DskipTests

• 步骤 4：启动后端服务

# 运行打包后的JAR包
java -jar backend/target/activiti-modeling-app-7.9.0.jar \
  --spring.profiles.active=dev \
  --server.port=8080 \
  --spring.datasource.url=jdbc:h2:mem:activiti \
  --keycloak.auth-server-url=http://localhost:8180/auth

• 步骤 5：访问验证
  前端访问：http://localhost:8080（后端内置前端静态资源）
  账号：admin/admin（需先启动 Keycloak，参考 Docker 部署的 Keycloak 配置）

2.4.生产环境部署补充清单

检查项	配置要求
数据库	替换 H2 为 PostgreSQL/MySQL，配置连接池（如 HikariCP），开启数据库备份
认证授权	独立部署 Keycloak，配置 HTTPS，创建专属 Realm 和用户组，限制权限
网络安全	开启 HTTPS（配置 SSL 证书），限制 Modeling App 端口访问（仅内网 / 指定 IP）
存储	模型文件存储到 Alfresco Content Services，开启版本备份
性能优化	JVM 参数：-Xms2G -Xmx4G，调整 Tomcat 线程池，数据库索引优化
监控	集成 Prometheus + Grafana，监控 JVM、数据库、接口响应时间
日志	配置 logback 输出 JSON 格式日志，对接 ELK 栈，开启审计日志（模型创建 / 修改 / 删除）

三、常见问题与解决

1. Keycloak 登录失败：检查 Keycloak 是否启动，Realm/Client ID 是否匹配，默认密码是否修改。
2. 前端编译报错：确保 Node.js 版本为 14.x（7.9.0 不支持 Node.js 16+），删除 node_modules 后重新安装。
3. 后端启动报 JDK 版本错误：确认环境变量 JAVA_HOME 指向 JDK 11，执行java -version验证。
4. BPMN 模型发布失败：检查 Activiti Runtime 是否部署，Modeling App 与 Runtime 的版本是否均为 7.9.0。

四、核心目录结构（源码部署参考）

activiti-modeling-app/
├── app/                # 前端源码（Angular）
│   ├── src/app/        # 核心组件（BPMN/DMN/表单设计器）
│   └── dist/           # 编译后前端资源
├── backend/            # 后端源码（Spring Boot）
│   ├── src/main/java/  # 核心API、权限、集成逻辑
│   └── target/         # 编译后JAR包
└── docker/             # Docker部署配置
    ├── docker-compose.yml # 一键部署配置
    └── .env            # 环境变量配置

Activiti Modeling App 7.9.0 是轻量级但功能完整的流程建模工具，Docker Compose 部署最快（5 分钟完成），适合快速验证；源码部署适合二次开发。生产环境需重点关注数据库、认证、网络安全的配置，确保稳定性和安全性。

• 

---

"人的一生会经历很多痛苦，但回头想想，都是传奇"。

---