AgileBPM的项目部署

文档地址：https://agile-bpm.gitee.io/docs/

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

• 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 可以设置为 “/“

如图配置

• 点击启动即可