附录

部署工具源码

拉取部署工具远吗，需要使用 Git 工具。

  1. # 初始化本地目录
  2. git init Truora-Service && cd Truora-Service;
  4. # 设置检出子目录 docker/deploy
  5. git config core.sparsecheckout true ;
  6. echo "docker/deploy" >> .git/info/sparse-checkout ;
  8. # 设置仓库地址，拉取部署工具
  9. git remote add origin "https://github.com/WeBankBlockchain/Truora-Service.git";
  10. git fetch --depth 1 && git checkout main
  12. # 进入部署脚本目录
  13. cd docker/deploy

查看日志

WeBASE-Front

WeBASE-Front 的日志位于相对目录 webase/log/ 中。

查看 WeBASE-Front 日志：

  1. # 服务启动日志
  2. cat webase/log/WeBASE-Front.log
  4. # 服务错误日志
  5. cat webase/log/WeBASE-Front-error.log

MySQL

使用命令查看 MySQL 日志：

  1. docker logs truora-mysql

FISCO-BCOS

FISCO-BCOS 的日志位于相对目录 fiscobcos/nodes/127.0.0.1/node0/log 中，注意替换 node0 目录。

查看 FISCO-BCOS 节点日志：

  1. # 服务启动日志
  2. #
  3. # 注意替换 node0 目录
  4. cat fiscobcos/nodes/127.0.0.1/node0/log/log_xxxxxxxxx.xx.log

Truora-Service

Truora-Service 的日志位于相对目录 truora/deploy/log/server/ 中。

查看 Truora-Service 日志：

  1. # 服务启动日志
  2. cat truora/deploy/log/server/Oracle-Service.log
  4. # 服务错误日志
  5. cat truora/deploy/log/server/Oracle-Service-error.log

Truora-Web( Nginx )

Truora-Web 部署在一个 Nginx 的 Docker 容器中。

查看 Nginx 的日志：

  1. docker logs truora-web

Truora-Web 的访问日志位于相对目录 truora/deploy/log/nginx/oracle-access.log 中。 Truora-Web 的错误日志位于相对目录 truora/deploy/log/nginx/oracle-error.log 中。

脚本参数

一键部署 脚本 deploy_all.sh 和 独立部署 脚本 deploy_single.sh 本质上都是通过调用 util/deploy_util.sh 脚本来完成部署。

区别

  • deploy_all.sh 脚本执行时，自带 -m，-w，-f 参数。
  1. # 查看部署脚本参数
  2. bash util/deploy_util.sh -h
  4. # 参数明细
  5. Usage:
  6.     deploy_util.sh [-k] [-m] [-w] [-f] [-M 3306] [-W 5002] [-B 5020] [-S 5021] [-d] [-g] [-i fiscoorg] [-t] [-p] [-D] [-h]
  7.     -k        Pull images from Docker hub.
  9.     -m        Deploy a MySQL instance with Docker.
  10.     -w        Deploy a WeBASE-Front service.
  11.     -f        Deploy a 4 nodes FISCO-BCOS service.
  13.     -M        Listen port of MySQL, default 3306.
  14.     -W        Listen port of WeBASE-Front, default 5002.
  15.     -B        Listen port of Truora-Web, default 5020.
  16.     -S        Listen port of Truora-Service, default 5021.
  18.     -d        Install dependencies during deployment.
  19.     -g        Use guomi.
  21.     -i        Organization of docker images, default fiscoorg.
  22.     -t        Use [dev] tag for images of Truora-Service and Truora-Web. Only for test.
  23.     -p        Pull [dev] latest for images of Truora-Service and Truora-Web. Only works when option [-t] is on.
  24.     -D        Set log level of Truora to [ DEBUG ], default [ INFO ].
  26.     -h        Show help info.
参数说明参数是否需要值备注
-k从 Docker Hub 拉取镜像不不使用该参数时，默认从 CDN 拉取
-m部署 MySQL不不使用该参数时，不部署 MySQL。
需要在部署时输入 MySQL 信息
-w部署 WeBASE-Front不不使用该参数时，不部署 WeBASE-Front
-f部署 FISCO-BCOS不不使用该参数时，不部署 FISCO-BCOS
-M设置 MySQL 端口需要不使用该参数时，默认：3306
-W设置 WeBASE-Front 端口需要不使用该参数时，默认：5002
-B设置 Truora-Web 端口需要不使用该参数时，默认：5020
-S设置 Truora-Service 端口需要不使用该参数时，默认：5021
-d安装系统依赖不不使用该参数时，则不安装
-g启用国密不不使用该参数时，使用 ECDSA
-i指定 Docker 镜像的组织名称需要仅开发 Truora 服务时使用
默认 fiscoorg
-ttruora-web 和 truora-service
镜像使用 dev 版本，
仅测试使用		不不使用该参数时，
Truora-Web 和 Truora-Service
默认使用 Release 版本（v1.x.x）
-p拉取 truora-web 和 truora-service
镜像 dev 版本的最新版，
仅开启 -t 参数后有效		不不使用该参数时，默认不拉取
-D设置 Truora-Service 服务
日志级别为 DEBUG		不不使用该参数时，默认 INFO
-h显示帮助文档不无

提示

  • -d 参数安装的系统依赖包括：OpenSSL，curl，wget，Docker，Docker Compose
  • -i 参数指定 Docker 镜像的组织名称。例如指定为: testorg，Docker 的拉取镜像命令就变成：docker pull testorg/truora-service:${version}
  • -p 参数只有在启用 -t 参数后才有效

CDN 说明

由于 Docker 的镜像的大小一般偏大，访问国外时网络很不稳定，在下载大文件或者工具时，往往下载不下来。所以，针对部分工具，提供了 CDN 的下载地址。

重要

  • 部署工具包是 `zip` 文件
  • Docker 镜像是 `tar` 文件

部署工具包

部署工具包用来部署 Truora 服务，同时支持：一键部署 和 独立部署 两种场景。

  1. # 下载指定版本时替换 {VERSION} 版本号
  2. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/deploy/docker-deploy-{VERSION}.zip" -O docker-deploy.zip
  3. # 解压部署包
  4. unzip docker-deploy.zip

版本号，从 https://github.com/WeBankBlockchain/Truora-Service/releases 获取。

比如，下载 v1.0.0 版：

  1. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/deploy/docker-deploy-v1.0.0.zip" -O docker-deploy.zip
  2. # 解压部署包
  3. unzip docker-deploy.zip

Docker 镜像

Docker 镜像下载成功后，使用命令进行解压：

  1. # 解压镜像包
  2. docker load -i xxxx.tar
  4. # 查看镜像版本
  5. docker images -a

Truora

Truora 镜像包含两个服务的镜像：Truora-Service 和 Truora-Web。

  1. ## 下载指定版本时替换 {VERSION} 版本号
  3. ## 下载 Truora-Service
  4. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/truora/truora-service-{VERSION}.tar" -O truora-service.tar
  5. # 加载镜像
  6. docker load -i truora-service.tar
  8. # 下载 Truora-Web
  9. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/truora/truora-web-{VERSION}.tar" -O truora-web.tar
  10. # 加载镜像
  11. docker load -i truora-web.tar

版本号，从 https://github.com/WeBankBlockchain/Truora-Service/releases 获取。

比如，下载 v1.0.0 版：

  1. # 下载 Truora-Service
  2. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/truora/truora-service-v1.0.0.tar" -O truora-service.tar
  3. # 加载镜像
  4. docker load -i truora-service.tar
  7. # 下载 Truora-Web
  8. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/truora/truora-web-v1.0.0.tar" -O truora-web.tar
  9. # 加载镜像
  10. docker load -i truora-web.tar

FISCO-BCOS

FISCO-BCOS 镜像是指 FISCO-BCOS 底层节点镜像，当前仅包含 v2.6.0 版本

  1. # 下载 FISCO-BCOS v2.6.0 镜像
  2. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/FISCO-BCOS/fiscobcos-v2.6.0.tar" -O fiscobcos.tar
  3. # 加载镜像
  4. docker load -i fiscobcos.tar

WeBASE-Front

WeBASE-Front 镜像是指 WeBASE 中间件中的子服务 WeBASE-Front 的镜像，当前仅包含 v1.4.2 版本

  1. # 下载 WeBASE-Front v1.4.2 镜像
  2. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/WeBASE/webase-front-v1.4.2.tar" -O webase-front.tar
  3. # 加载镜像
  4. docker load -i webase-front.tar

MySQL

MySQL 镜像是 Docker Hub 仓库中的官方 MySQL 镜像，当前仅包含 5.7 版本

  1. # 下载 MySQL 5.7 镜像
  2. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/official/mysql-5.7.tar" -O mysql.tar
  3. # 加载镜像
  4. docker load -i mysql.tar

Docker-Compose

Docker-Compose 镜像是 Docker Hub 仓库中的官方 Docker Compose 镜像，当前仅包含 1.27.4 版本

  1. # 下载 Docker Compose 1.27.4 镜像
  2. wget "https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBankBlockchain/Truora/docker/official/docker-compose-1.27.4.tar" -O docker-compose.tar
  3. # 加载镜像
  4. docker load -i docker-compose.tar