快速安装体验WeEvent

时间 2019-11-06

标签快速安装体验 weevent 繁體版

原文原文链接

WeEvent是一套分布式事件驱动架构，实现了可信、可靠、高效的跨机构、跨平台事件通知机制。html

快速安装

快速安装是为了方便用户搭建开发和测试环境，在单台机器上快速部署WeEvent服务。提供Docker镜像、Bash脚本两种安装方式。node

如下安装过程以Centos 7.2为例。mysql

Docker镜像安装

$ docker pull weevent/weevent:1.0.0; docker run -d -p 8080:8080 weevent/weevent:1.0.0 /root/run.sh

WeEvent的镜像里包括了FISCO-BCOS网络，WeEvent服务的子模块Broker和Governance，以及各类依赖。nginx

Bash安装

须要的一些基础工具yum install wget tree tar dos2unix lsof gcc openssl-devel pcre-devel 。git

获取安装包github

从github下载安装包weevent-1.0.0.tar.gz，而且解压到/tmp/ 。sql
```
$ cd /tmp/
$ wget https://github.com/WeBankFinTech/WeEvent/releases/download/v1.0.0/weevent-1.0.0.tar.gz
$ tar -zxf weevent-1.0.0.tar.gz
```
若是github下载速度慢，能够尝试国内下载连接。docker

解压后目录结构以下：shell

$ cd weevent-1.0.0/ 
$ tree -L 2
.
├── bin
│   ├── check-service.sh
│   ├── start-all.sh
│   ├── stop-all.sh
│   └── uninstall-all.sh
├── config.properties
├── install-all.sh
├── modules
│   ├── broker
│   ├── governance
│   └── nginx
└── third-packages
    └── nginx-1.14.2.tar.gz

修改配置bash

默认配置文件./config.properties以下：
```
# Required module
# support 2.0 and 1.3
fisco-bcos.version=2.0
# FISCO-BCOS node channel, eg: 127.0.0.1:20200;127.0.0.2:20200
fisco-bcos.channel=127.0.0.1:20200
# The path of FISCO-BCOS 2.0 that contain certificate file ca.crt/node.crt/node.key,
# OR FISCO-BCOS 1.3 that contain ca.crt/client.keystore
fisco-bcos.node_path=~/FISCO-BCOS/127.0.0.1/node0/conf

# Required module
nginx.port=8080

# Required module
broker.port=8090

# Optional module
governance.enable=false
governance.governance.port=8099
governance.mysql.ip=127.0.0.1
governance.mysql.port=3306
governance.mysql.user=xxx
governance.mysql.password=yyy
```
配置说明 :
- 区块链FISCO-BCOS
  - fisco-bcos.version
    FISCO-BCOS 2.0和1.3版本都支持，推荐使用2.0及以上版本。
  - fisco-bcos.channel
    区块链节点的channel访问入口。配置多个节点时用;分割，如127.0.0.1:8821;127.0.0.2:8821。
  - fisco-bcos.node_path
    区块链节点的访问证书、私钥存放目录。FISCO-BCOS 2.0的证书文件为ca.crt、node.crt、node.key，1.3版本的证书文件为ca.crt、client.keystore。
    若是WeEvent服务和区块链节点不在同一台机器上，须要把证书文件拷贝到WeEvent机器的当前目录，修改fisco-bcos.node_path=./。
- Nginx监听端口nginx.port
- Broker监听端口broker.port
- Governance模块配置
  - governance.enable是否安装Governance模块，默认为false不安装
  - 监听端口governance.port
  - Mysql配置governance.mysql.*

一键安装

以安装到目录/usr/local/weevent/为例。

$ ./install-all.sh -p /usr/local/weevent/

正常安装后，输出有以下关键字:

8081 port is okay
8080 port is okay
param ok
install module broker 
install broker success 
install module nginx 
install nginx success

若是安装失败，能够在安装日志./install.log中查看更多细节。

目标安装路径/usr/local/weevent/的结构以下

$ cd /usr/local/weevent/
$ tree -L 2
.
|-- broker                        
|   |-- apps
|   |-- broker.sh
|   |-- check-service.sh
|   |-- conf
|   |-- deploy-topic-control.sh
|   |-- lib  
|   `-- logs
|-- check-service.sh                
|-- nginx                            
|   |-- conf
|   |-- html
|   |-- logs
|   |-- nginx.sh
|   |-- nginx_temp
|   `-- sbin   
|-- start-all.sh                    
|-- stop-all.sh                    
`-- uninstall-all.sh

启停服务
- 启动服务
  
  在服务安装目录下/usr/local/weevent，经过start-all.sh命令启动全部服务，正常启动以下：
```
$ ./start-all.sh
start broker success (PID=3642)
add the crontab job success
start nginx success (PID=3643)
add the crontab job success
```
- 中止全部服务的命令./stop-all.sh。

检查是否安装成功

$ ./check-service.sh
check broker service 
broker service is ok