最佳实践-WeEvent

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

快速安装

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

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

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，以及各种依赖。

Bash安装

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

• 获取安装包

  从github下载安装包weevent-1.0.0.tar.gz，并且解压到/tmp/ 。

  $ 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下载速度慢，可以尝试国内下载链接。
  解压后目录结构如下：

  $ 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
  

• 修改配置

  默认配置文件./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