MyApps平台开发环境部署-v5.0sp1
本文档为天翎内部员工及获得天翎MyApps产品源代码用户准备。
环境准备
准备java环境
MyApps平台依赖JDK8环境,从Oracle官网下载或从源码目录下,“env”子目录下获取。以env子目录下获取为例,设置步骤如下:
1 - 将目录下获得得jdk1.8.0_131.zip文件解压到任意目录
2 - 设置环境变量JAVA_HOME到解压的jdk目录,如:D:\Java\jdk1.8.0_131
3 - 设置环境变量path,将%JAVA_HOME%\bin;添加到系统path中
测试:
在windows的cmd窗口下,输入:java -version,如图则安装正确。
准备Maven环境
MyApps平台通过Maven进行打包,需要配置Maven基础环境。
1 - 从Apache下载Maven,如:apache-maven-3.6.3-bin.tar.gz
2 - 解压到任意目录
3 - 设置环境变量MAVEN_HOME到解压的目录,如:D:\Java\apache-maven-3.6.3
4 - 设置环境变量path,将%MAVEN_HOME%\bin;添加到系统path中
测试:
在windows的cmd窗口下,输入:java -version,如图则安装正确。
准备数据库环境
MyApps平台支持多种数据库,包括MySQL、Ms SQL、Oracle、DB2、人大金昌等,开发环境数据库一般采用MySQL。配置如下:
1 - 从源码目录中,env子目录下获取mysql-5.7.22-winx64.zip,如从其他途径获取,建议用mysql5.7版本
2 - 解压到任意目录,如:D:\DB\mysql-5.7.22-winx64
3 - 用管理员身份执行解压后目录中的安装MySQL服务批处理:installService.bat
4 - 设置环境变量MYSQL_HOME,为:D:\DB\mysql-5.7.22-winx64
5 - 设置环境变量path,将%MYSQL_HOME%\bin;添加到系统path中
测试:
在windows的cmd窗口下,输入:mysql -uroot -p (空密码),如图则安装成功。
初始化数据
1 - 转到源码目录下的obpm-demo\database子目录
2 - 执行restore_demodb.bat批处理文件,如图则成功
注意:如果自己安装的mysql,则需要修改端口为3307,且密码设置为空,默认服务器编码及客户端编码为utf8,linux环境下需要额外设置大小写不敏感。
准备Redis环境
1 - 从Redis官网或源码目录下的env子目录获取Redis安装文件:Redis-x64-3.2.100.zip
2 - 解压到任意目录,如:D:\env\Redis-x64-3.2.100
3 - 管理员身份运行批处理文件:installService.bat
测试:
打开windows的服务管理器,Redis服务为启动状态则成功(也可以用Redis客户端连接上去测试)。
准备Consul环境
1 - 从Consul官网或源码目录下的env子目录获取Consul安装文件:consul_1.4.3_windows_amd64.zip
2 - 解压到任意目录,如:D:\env\consul_1.4.3_windows_amd64
3 - 管理员身份运行批处理文件:installService.bat
测试:
打开浏览器,地址栏输入:http://localhost:8500/ 看到如图界面,即成功。
获取源码
天翎MyApps平台源码提供给内部开发员工,采购天翎MyApps企业版、集团版的客户。
通过源码压缩包方式
企业版用户,天翎商务客服会提供源码压缩包,解压到任意目录即可。解压后的目录结构如图:
从天翎SVN获得方式
任意建立一个目录,通过svn工具checkout,如图:
拉取源码完成后,目录结构和源码解压包一致。
使用开发工具
IntelliJ IDEA
1 - jetbrains官网获取IntelliJ IDEA并安装,可以是专业版或社区版
2 - 打开Project,选择源码目录
打开Project后,IDEA会花较长时间Index,完成后可以直接选择程序入口运行。
成功!
STS(Spring Tools Studio)
1 - 从Spring官网获得STS并安装
2 - 通过STS的File->Import功能,选择:Maven->Existing Maven Projects,如图:
引入完成后,将出现如图界面则成功。
注:可以一个一个子模块引入,也可以直接引入整个工程。
找到程序入口,运行
打包
使用Maven打包
转到源码目录下,运行:install.bat 或 install-clean.bat即可完成打包,其中,install-clean.bat会在打包时清理之前运行时的编译缓存文件。执行后,看到如图界面则成功。
发布运行
Docker-Compose方式发布
1 - 在执行玩Maven编译打包的过程后,切换到源码目录下obpm-package\build-docker-compose,并执行批处理build.bat
2 - 将build-docker-compose整个目录复制到已经安装好Docker及Docker-Compose的机器上
3 - 运行命令 docker-compose build
4 - 运行命令 docker-compose up
绿色包方式发布
1 - 在执行玩Maven编译打包的过程后,切换到源码目录下obpm-package\build-zip,并执行批处理build.bat启动MyApps系统
2 - 将生成的myapps5.0.zip 文件复制到要发布的windows机器上,解压后,通过运行目录下的startup.bat启动Myapps系统