部署说明¶
1. 前提条件¶
| 依赖软件 | 支持版本 |
|---|---|
| Java | JDK8或以上版本 |
| FISCO-BCOS | V2.0.x版本 |
备注： Java推荐使用OracleJDK，可参考JDK配置指引（CentOS的yum仓库的OpenJDK缺少JCE(Java Cryptography Extension)，导致Web3SDK无法正常连接区块链节点）
国密支持¶
WeBASE-Front v1.2.2+已支持 国密版FISCO-BCOS
开启国密国密SSL：
- 在v1.5.0后，sdk将自动根据链的加密类型切换国密或非国密，自动根据链的SSL类型切换国密SSL
国密编译：
- 编译国密版智能合约在v1.3.1版本后，通过引入solcJ:0.4.25-rc1.jar，自动切换支持国密版智能合约的编译/部署/调用；（可自行替换jar包版本为solcJ-0.5.2来使用0.5进行后台接口的合约编译）
- 该部分仅影响后台的
/contract合约编译接口，不影响前端合约IDE的合约编译
solidity v0.6.10支持¶
WeBASE-Front v1.4.2已支持solidity v0.5.1和v0.6.10
2. 拉取代码¶
执行命令：
git clone https://github.com/WeBankFinTech/WeBASE-Front.git
# 若因网络问题导致长时间下载失败，可尝试以下命令
git clone https://gitee.com/WeBank/WeBASE-Front.git
进入目录：
cd WeBASE-Front
3. 编译代码¶
使用以下方式编译构建，如果出现问题可以查看 常见问题解答 ：
方式一：如果服务器已安装Gradle，且版本为Gradle-4.10或以上
gradle build -x test
方式二：如果服务器未安装Gradle，或者版本不是Gradle-4.10或以上，使用gradlew编译
chmod +x ./gradlew && ./gradlew build -x test
构建完成后，会在根目录WeBASE-Front下生成已编译的代码目录dist。
4. 修改配置¶
（1）进入dist目录
cd dist
dist目录提供了一份配置模板conf_template：
根据配置模板生成一份实际配置conf。初次部署可直接拷贝。
例如：cp conf_template conf -r
（2）进入conf目录：
cd conf
注意： 将节点所在目录nodes/${ip}/sdk下的所有文件拷贝到当前conf目录，供SDK与节点建立连接时使用（SDK会自动判断是否为国密，且是否使用国密SSL）
- 链的
sdk目录包含了ca.crt, sdk.crt, sdk.key和gm文件夹，gm文件夹包含了国密SSL所需的证书 - 拷贝命令可使用
cp -r nodes/${ip}/sdk/* ./conf/ - 注，只有在建链时手动指定了
-G(大写)时节点才会使用国密SSL
（3）修改配置（根据实际情况修改）：
如果在企业部署中使用WeBASE-Front，必须配置下文中的keyServer
vi application.yml
spring:
datasource:
url: jdbc:h2:file:./h2/webasefront;DB_CLOSE_ON_EXIT=FALSE // 默认H2库为webasefront，建议修改数据库存放路径
...
server:
port: 5003 // 服务端口
context-path: /WeBASE-Front
sdk:
...
ip: 127.0.0.1 // 连接节点的监听ip
channelPort: 20200 // 连接节点的链上链下端口
certPath: conf // sdk证书的目录，默认为conf
constant:
keyServer: 127.0.0.1:5004 // 密钥服务的IP和端口(WeBASE-Node-Manager服务或者WeBASE-Sign服务，不同服务支持的接口不同)，如果作为独立控制台使用可以不配置
transMaxWait: 30 // 交易最大等待时间
monitorDisk: / // 要监控的磁盘目录，配置节点所在目录（如：/data）
monitorEnabled: true // 是否监控数据，默认true
aesKey: EfdsW23D23d3df43 // aes加密key(16位) 如启用，各互联的子系统的加密key需保持一致
nodePath: /fisco/nodes/127.0.0.1/node0 //配置连接节点的绝对路径
...
5. 服务启停¶
返回到dist目录执行：
启动: bash start.sh
停止: bash stop.sh
检查: bash status.sh
备注：服务进程起来后，需通过日志确认是否正常启动，出现以下内容表示正常；如果服务出现异常，确认修改配置后，重启提示服务进程在运行，则先执行stop.sh，再执行start.sh。
启动成功将出现如下日志：
...
Application() - main run success...
6. 访问控制台¶
http://{deployIP}:{frontPort}/WeBASE-Front
示例：http://localhost:5002/WeBASE-Front
- 部署服务器IP和服务端口需对应修改，网络策略需开通
- 基于可视化控制台，可以开发智能合约，部署合约和发送交易，并查看交易和区块详情。还可以管理私钥，对节点健康度进行监控和统计