部署说明

1. 前提条件

序号 软件
1 FISCO-BCOS 2.7+
2 WeBASE-Front 1.4.0+
3 MySQL5.6或以上版本 1.4.0+
4 Java8或以上版本

2. 注意事项

3. 拉取代码

执行命令:

git clone https://github.com/WeBankFinTech/WeBASE-Stat.git

进入目录:

cd WeBASE-Stat

4. 编译代码

方式一:如果服务器已安装Gradle,且版本为Gradle-4.10或以上。

gradle build -x test

方式二:如果服务器未安装Gradle,或者版本不是Gradle-4.10或以上,使用gradlew编译

chmod +x ./gradlew && ./gradlew build -x test

构建完成后,会在根目录WeBASE-Stat下生成已编译的代码目录dist。

5. 数据库初始化

5.1 新建数据库

#登录MySQL: 例如:mysql -u root -p123456
mysql -u ${your_db_account} -p${your_db_password}  
#新建数据库:默认数据库名为webasestat
CREATE DATABASE IF NOT EXISTS {your_db_name} DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

6. 服务配置及启停

6.1 服务配置修改

(1)回到dist目录,dist目录提供了一份配置模板conf_template:

根据配置模板生成一份实际配置conf。初次部署可直接拷贝。
例如:cp conf_template conf -r

(2)修改服务配置,完整配置项说明请查看 配置说明

修改服务端口:sed -i "s/5008/${your_server_port}/g" conf/application.yml
修改数据库IP:sed -i "s/127.0.0.1/${your_db_ip}/g" conf/application.yml
修改数据库端口:sed -i "s/3306/${your_db_port}/g" conf/application.yml
修改数据库名称:sed -i "s/webasestat/${your_db_name}/g" conf/application.yml
修改数据库用户:sed -i "s/defaultAccount/${your_db_account}/g" conf/application.yml
修改数据库密码:sed -i "s/defaultPassword/${your_db_password}/g" conf/application.yml

6.2 服务启停

在dist目录下执行:

启动:bash start.sh
停止:bash stop.sh
检查:bash status.sh

备注:服务进程起来后,需通过日志确认是否正常启动,出现以下内容表示正常;如果服务出现异常,确认修改配置后,重启。如果提示服务进程在运行,则先执行stop.sh,再执行start.sh。

...
	Application() - main run success...

7. 访问

可以通过swagger查看调用接口:

http://{deployIP}:{deployPort}/WeBASE-Stat/swagger-ui.html
示例:http://localhost:5008/WeBASE-Stat/swagger-ui.html

备注:

  • 部署服务器IP和服务端口需对应修改,网络策略需开通

8. 查看日志

在dist目录查看:

全量日志:tail -f log/WeBASE-Stat.log
错误日志:tail -f log/WeBASE-Stat-error.log