部署项目之前请确定您的电脑已经安装一下应用

  • maven
  • Git
  • jdk8
  • eclipse等IDE
  • mysql、oracle 数据库

SpringBoot 版开发部署

  1. Clone Spring Boot 版本项目

    1
    https://gitee.com/agile-bpm/agilebpm-base-spring-boot.git

  2. 对根目录执行 mvn 命令 clean install 安装相关依赖

  3. 引入 Maven Spring Boot 案例项目 agilebpm-spring-boot-samples

  4. 建表、执行初始化语句。按照 初始化SQL顺序依次执行，也可复制只读案例库 (47.106.140.247:3306/new_ public/public)

  1. 启动项目，修改数据库 配置( application.yml ) 然后在 SamplesApplication.java 中执行 main 方法

  2. 访问 http://localhost:8080 即可体验 AgileBPM ！

    最后推荐 查看 敏捷流程实施三步曲 了解 整体 流程实施 解决方案

basic 版本开发部署

以下开发环境以 eclipse 为例

  1. 配置全局工作空间字符集 UTF-8
  2. 引入 maven 项目 https://gitee.com/agilebpm/agile-bpm-basic.git
  3. 建表、执行初始化语句，按照SQL顺序依次执行。 https://gitee.com/agile-bpm/agile-bpm-basic/tree/master/_doc/mysql
使用 jetty maven 插件 启动项目

在web 项目下 mvn jetty:run 就可以直接运行项目
通过浏览器 http://localhost:8080/bpm-explorer 进入首页

使用 Tomcat server 配置 启动项目
  1. server窗口， new server 选择 Tomcat7 ，使用 jdk8
  2. 在 server 上右键 Add and Remove 选择 web 项目
  3. 设置server Modules 将 web path 设置成 /agile-bpm-platform ，Auto reloading enabled 勾去掉

  4. Add External Web Module 选择前端项目 bpm-explorer 本地路径，path 设置成 /bpm-explorer
    如图：

  5. 建表、执行初始化语句。按照 初始化SQL顺序依次执行，也可复制只读案例库 (47.106.140.247:3306/demo public/public)

  6. 修改数据连接( app-dev.properties )并启动 Tomcat

如图maven项目正常的情况下，server下会显示依赖的模块，这些模块是热部署的，修改内容无需重启。
启动成功后访问 http://localhost:8080/bpm-explorer/ （/bpm-explorer 则对应前端项目的ctx）

到此就完成了开发环境配置

如果有新模块开发请参考案例 demo 模块，以及改模块下的 readme.md

移动端开发环境部署

开发前请确认机器安装有 node js

  1. 下载项目 bpm-app
  2. 在项目目录下安装依赖 ,控制台执行 npm install
  3. 在 baseService.js文件 中配置 ctx 地址指向后台项目的服务器地址
  4. 启动热部署项目 npm run dev

部署至服务器

  1. 部署前请确认 移动端 ctx 配置是否正确
  2. 确认环境与数据库连接是否正确
  3. 对web项目执行 package 命令，将 agile-bpm-platform.war 拖至 Tomcat webapps 目录
  4. 将 pc 端 bpm-explorer 拖至 webapps 目录
  5. 对移动端执行 npm build 命令然后将 dist 目录内容 拖至 webapps 目录，修改目录名为移动端 ctx：bpm-app

建议使用Jenkins构建
server 启动后对应的访问地址：
pc端： http://ip:port/bpm-explorer/
移动端： http://ip:port/bpm-app/

他们对应的后端资源地址为 http://ip:port/agile-bpm-platform/

这里只提供一种部署方式，当然使用网关、独立部署都没关系、只要保证前端项目请求到后端项目地址无误即可

开发部署中常见问题

  • jar 包下载不到
    可能是自己配置了私服，导致无法从root 目录 pom 中配置的私服下载部分jar ，如果还有问题请 对 root 目录 执行 clean install 命令做检查

  • 首页菜单不展示，不跳转登录页
    可能是：前后端项目 ctx 配置的问题。 大多是重新部署后，后端项目ctx 没有配置，导致前端请求 404。所以请打开控制台，检查前端项目url访问地址，此地址与后端部署项目是否一致。

  • 系统不支持当前域名的访问，请联系管理员
    在app-security.xml 配置文件中 对csrfFilter 的 ingores 进行域名忽略配置。
    移动端开发部署，目前是不同域名的，所以必须添加忽略。否则会出如上异常提示

  • PC前端项目修改ctx，修改公共js
    在 app-conf.js 中可以修改 ctx 地址，然后项目目录下 执行webpack 命令打包压缩js

  • 添加新的 controller 无法访问
    可以参考 demo 模块下的 readme.md 有关于 包扫描的描述，也有可能是项目 没有热部署、那就需要手动 install 相关模块 ，也请检查web模块 代码版本是否与源码一致

  • 项目没有使用什么特殊奇葩技术，均为最常用的组件，最普通的开发形式，有问题也可以百度

IDEA 配置 Tomcat

一、配置 Run Configurations,添加Tomcat Server

  • 添加一个Tomcat
  • 配置Tomcat启动后打开的地址（设置为前端 ctx 对应的地址）
    如图：

二、如图 配置Deployment

  • web app 设置为 /agile-bpm-platform
  • bpm-explorer目录为前端项目，前端访问的 ctx 可以设置为 “/“

如图配置

  • 点击启动即可