快速安裝體驗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