助你更了解CDN
当前位置:网站首页 > CDN搭建 > 正文

FISCO BCOS环境搭建指南:国内镜像与CDN加速

作者:CDN发布时间:2020-05-12分类:CDN搭建浏览:189评论:0


导读:...



在FISCO BCOS使用过程中,大家可能也遇到过因为网络问题,无法下载所需代码、二进制、工具脚本的情况。为了解决这个问题,提升平台使用体验,针对国内使用环境,FISCO BCOS提供镜像和CDN加速功能。



本文总结归纳了国内镜像与CDN加速的常见使用场景以及对应操作,方便大家了解运用。
 


FISCO BCOS源码与二进制程序



  源码下载


FISCO BCOS当前所有源码位于GitHub上。新版本发布后,版本代码会被合入master分支。
GitHub仓库:
https://github.com/FISCO-BCOS/FISCO-BCOS 
为了方便国内用户,我们在gitee上提供了镜像仓库。每次新版本发布后,镜像仓库会同步GitHub仓库的更新,如果从GitHub下载失败,请尝试使用gitee镜像仓库。
Gitee镜像仓库:
https://gitee.com/FISCO-BCOS/FISCO-BCOS 
  二进制程序下载


当前FISCO BCOS提供的二进制程序如下:






开发者可在GitHub上找到FISCO BCOS不同版本对应的二进制程序和部署工具,使用开发部署工具(build_chain)时,工具会先尝试从GitHub下载所需二进制程序,如果下载失败则从CDN下载。


build_chain脚本延展阅读:
 
开发者使用运维部署工具(generator)时,工具默认从GitHub下载所需二进制程序,可以通过--cdn参数指定下载。例如,

./generator --download_fisco ./meta --cdn



FISCO BCOS文档



文档是学习使用FISCO BCOS的第一步,访问文档必不可少。FISCO BCOS设计与使用文档全部开源,通过readthedocs管理,开发者可直接登陆或通过国内镜像访问。


FISCO BCOS文档:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/
文档国内镜像:
http://docs.fisco-bcos.org
 
readthedocs文档支持PDF格式下载,方便开发者使用。新版本发布时,上个版本的文档会被打上Tag,新版本的文档会加入主干分支。




FISCO BCOS配套工具



  控制台


FISCO BCOS控制台是一个交互式命令行工具,使用Java开发,控制台是开发者探索区块链世界的助推器,带来顺滑的开发部署体验。


控制台代码:
https://github.com/FISCO-BCOS/console
国内镜像:
https://gitee.com/FISCO-BCOS/console
 
控制台提供编译好的下载包,用户下载、配置后即可使用,下载控制台前,开发者需要获取download_console.sh脚本。此脚本会帮助开发者从GitHub下载最新版本console.tar.gz。下面的指令是从国内镜像获取download_console.sh脚本并执行。


curl -LO https://gitee.com/FISCO-BCOS/console/raw/master/tools/download_console.sh && bash download_console.sh
控制台延展阅读:
 
国密jar包CDN下载


通过替换solcJ包,控制台可以支持Solidity 0.4/0.5国密和非国密版本。详情可参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/console.html#jar
 
不同版本的CDN下载地址参考如下。
 
0.4版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.4.25.jar
0.5版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.5.2.jar
国密0.4版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.4.25-gm.jar
国密0.5版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.5.2-gm.jar
  TASSL


开发者使用TASSL,必须生成国密版本的证书。部署工具会自动从GitHub下载,解压后放置于~/.fisco/tassl,如果下载失败,请尝试从以下途径下载解压,并放置于~/.fisco/tassl。
https://gitee.com/FISCO-BCOS/LargeFiles/blob/master/tools/tassl.tar.gz
 
  账户生成脚本


开发者可在国密模式下使用sm2曲线和对应签名算法,在非国密场景使用secp256k1曲线和ecdsa签名算法。FISCO BCOS提供了生成脚本,脚本生成私钥并以账户地址命名,支持PEM和PKCS12两种格式。详情请参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/account.html


get_account.sh脚本依赖于openssl指令,用于生成secp256k1私钥,如果从GitHub下载失败,可以尝试以下镜像地址。
https://gitee.com/FISCO-BCOS/console/raw/master/tools/get_account.sh


get_gm_account.sh脚本用于生成sm2私钥,依赖于TASSL。如果从GitHub下载失败,可以尝试镜像地址。
https://gitee.com/FISCO-BCOS/console/raw/master/tools/get_gm_account.sh




操作实例



  使用国内镜像建链


本节以搭建2.4.0国密版本为例,在国内网络环境下,使用镜像建链,非国密版本的操作类似。详情请参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/installation.html


下载开发部署工具


curl -LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.4.0/build_chain.sh
如果下载失败请尝试
curl -LO https://gitee.com/FISCO-BCOS/FISCO-BCOS/raw/master/tools/build_chain.sh

下载二进制程序


开发部署工具(build_chain)会自动下载二进制程序,下载失败自动切换CDN下载,不需要用户关注。用户也可以手动下载二进制程序或编译源码,通过开发部署工具的-e选项指定,此时工具不会再去下载。-e选项参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/build_chain.html#e-optional


搭建2.4.0国密FISCO BCOS链


搭建国密版本时,开发部署工具还依赖tassl,工具会自动下载,如果失败请用户参考TASSL手动下载方法,下载解压后放置于~/.fisco/tassl。执行下面的指令,输出All completed即表示执行成功。


bash build_chain.sh -l "127.0.0.1:4" -p 30300,20200,8545 -g -v 2.4.0
  使用国内源码镜像编译


本节以CentOS 7 为例,从gitee镜像下载源码并编译,其他操作系统编译流程类似。详情请参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/get_executable.html#id2


安装依赖


sudo yum install -y epel-releasesudo yum install -y openssl-devel openssl cmake3 gcc-c++ git

下载源码


git clone https://gitee.com/FISCO-BCOS/FISCO-BCOS.git

下载依赖包


在编译时FISCO BCOS会自动下载依赖包,每个依赖包有多个源。如果在编译阶段下载依赖包失败,请根据提示从下面的国内镜像手动下载,放置于FISCO-BCOS/deps/src目录下,再次使用make编译。

详情请参考
https://gitee.com/FISCO-BCOS/LargeFiles/tree/master/libs


编译源码


cd FISCO-BCOS && mkdir build && cd buildcmake3 ..make -j2



总  结




本文总结了国内镜像与CDN加速的常见使用场景以及对应操作,帮助用户更方便的学习使用FISCO BCOS。


由于公众号文章更新受限,如果加速方式发生变动或有新增,我们会在文档中更新,请留意关注。
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/cdn.html









FISCO BCOS的代码完全开源且免费
下载地址↓↓↓
https://github.com/FISCO-BCOS/FISCO-BCOS



欢迎 发表评论:

  • 请填写验证码