最近在学习Hyperledger Fabric,它是由 Linux 基金会发起建立的开源区块链分布式帐本。javascript
Hyperledger Fabric是一个开源区块链实现,开发环境创建在 VirtualBox 虚拟机上,部署环境能够自建网络,也能够直接部署在 BlueMix 上,部署方式可传统可 Docker 化,共识达成算法插件化,支持用 Go 和 JavaScript 开发智能合约,尤以企业级的安全机制和 membership 机制为特点。
java
今天来聊聊怎么搭建一个基于Ubuntu Server的Hyperledger Fabric吧。node
01 基本环境配置
建议用虚拟机装一个Ubuntu Server版本便可,不要装图形界面,那个太卡了。Ubuntu Server版本安装的时候注意,选择英文版本的,中文简体安装会出错。git

安装好后记得换源成阿里云的,这里换的时候因为虚拟机上不支持复制黏贴,只能手动输入一下啦:github
deb http://mirrors.aliyun.com/ubuntu/ xenial main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ xenial main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse
换源后把下面的软件装上:golang
-
ssh -
git -
go -
node.js -
docker -
docker-compose
注意大部分只须要sudo apt-install便可安装,go、docker这种百度一下就知道怎么装了,就不展开讲了。nodejs记得给升级到最新版本。web
02 fabric环境搭建
如今网上关于fabric的教程大部分是基于1.4版本的,今天来演示下搭建2.1版本的Fabric环境进行学习。算法
2.1 下载fabric源码
进入GO的目录建立hyperledger文件夹:docker
mkdir -p $GOPATH/src/github.com/hyperledger
cd $GOPATH/src/github.com/hyperledger/
而后下载fabric的源码,注意这里用码云Gitee的连接,GitHub的太慢了得下到明年去:typescript
git clone https://gitee.com/mirrors/fabric.git

不知道为啥我这gitee也好慢啊。。。
将 fabric 切换至 2.1 版本:
cd fabric/
git branch -a
git checkout release-2.1


记得加个sudo,没有管理员权限啥都干不了。
2.2 下载fabric-samples源码、fabric镜像
cd scripts/
sudo ./bootstrap.sh

而后就进入了漫长的等待了。fabric-samples是从GitHub上下载的,可能会比较慢。下载完成后会列出全部下载的docker镜像。

2.3 网络测试
上面的工做完成后,当前目录多了一个fabric-samples文件夹,咱们进去该目录下的test-network目录测试下搭建的环境是否成功:
cd fabric-samples/
cd test-network/
而后启动咱们的测试网络:
sudo ./network.sh up
记得加sudo保平安哦。开始了一堆代码以后出现:

说明建立成功了。
03 Fabcar测试
fabcar是一个小demo,咱们这里运行它测试下看看。咱们回到fabric-samples目录下,而后进入/fabcar目录中,先把网络给清理一下,而后启动:
sudo ./networkDown.sh
sudo ./startFabric.sh

可能存在的问题
问题1
固然了你可能会遇到问题,好比找不到go命令等,这是由于sudo命令会重置当前的环境变量,致使设置go找不到。
Error: failed to normalize chaincode path: failed to determine module root: exec: "go": executable file not found in $PATH
!!!!!!!!!!!!!!! Chaincode packaging on peer0.org1 has failed !!!!!!!!!!!!!!!!
根据网上解决sudo环境变量问题的方法,在本身的shell配置文件中以下设置
vim ~/.bashrc 添加以下
alias sudo='sudo env PATH=$PATH LD_LIBRARY_PATH=$LD_LIBRARY_PATH'

而后刷新下让配置生效:
source ~/.bashrc
问题2
安装golang fabric api依赖包的时候,长时间无响应,最后报以下错误:
go: github.com/hyperledger/fabric-contract-api-go@v1.0.0: Get https://proxy.golang.org/github.com/hyperledger/fabric-contract-api-go/@v/v1.0.0.mod: dial tcp 172.217.27.145:443: i/o timeout ~/fabric-samples/test-network Finished vendoring Go dependencies ++ peer lifecycle chaincode package fabcar.tar.gz --path ../chaincode/fabcar/go/ --lang golang --label fabcar_1 ++ res=1 ++ set +x Error: failed to normalize chaincode path: 'go list' failed with: go: github.com/hyperledger/fabric-contract-api-go@v1.0.0: Get https://proxy.golang.org/github.com/hyperledger/fabric-contract-api-go/@v/v1.0.0.mod: dial tcp 172.217.27.145:443: i/o timeout: exit status 1 !!!!!!!!!!!!!!! Chaincode packaging on peer0.org1 has failed !!!!!!!!!!!!!!!!
ERROR !!! Deploying chaincode failed
解决办法:
golang1.13.x 能够直接执行:
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
finally,终于成功了:

04 SDK交互
在上一步执行成功后,会输出各个语言环境下的SDK交互实例,好比JavaScript是这样的:
JavaScript:
Start by changing into the "javascript" directory:
cd javascript
Next, install all required packages:
npm install
Then run the following applications to enroll the admin user, and register a new user
called appUser which will be used by the other applications to interact with the deployed
FabCar contract:
node enrollAdmin
node registerUser
You can run the invoke application as follows. By default, the invoke application will
create a new car, but you can update the application to submit other transactions:
node invoke
You can run the query application as follows. By default, the query application will
return all cars, but you can update the application to evaluate other transactions:
node query
能够选择javascript,typescript,javago语言与网络交互,这里用javascript试试。进入fabcar中的javascript目录中,这里得切换到root用户,我也不知道sudo为何还存在权限问题,执行:
cd javascript/
su
npm install

安装相关的依赖。完成后咱们按照合约流程依次启动:
注册管理员帐号:
sudo node enrollAdmin.js

注册用户:
sudo node registerUser.js

咱们接下来,执行一笔交易
sudo node invoke.js

查询交易后的状态:
sudo node query.js

完成啦!!!至此,Fabric的环境已经搭建完成。你们能够在上面愉快的学习了。
参考资料
最新超详细的 Hyperledger Fabric2.2 环境搭建部署
https://blog.csdn.net/shengsikandan/article/details/107656060
fabric2.1.0 打包chaincode 报错
https://blog.csdn.net/qq_32247229/article/details/108860823
go 提示failed to normalize chaincode path
https://www.jason-z.com/post/165
ubuntu16.04下搭建fabric 1.4.3环境
https://blog.csdn.net/Sun_Hui_/article/details/100928155
推荐阅读:
干货 | 学习算法,你须要掌握这些编程基础(包含JAVA和C++)


本文分享自微信公众号 - 程序猿声(ProgramDream)。
若有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一块儿分享。