快速搭建Fabric测试网络(Docker in Ubantu
这周查阅了大量文档资料,终于在今天把整个网络全部走通,包括通过源代码部署和通过shell脚本一键部署,趟了大量的坑,依然不敢说是全部了解。但也有很多值得注意和以后需要求证的地方,这里写下来备忘。
本文所述的内容是在2019年1月8号开始的,于2019年1月10号结束。在Win10家庭版上装的Ubantu 18.04版本的虚拟机,文档主要参考的是Fabric Release-1.4版本。另外,我喜欢Go,所以接下来关于链码的演示,没有nodejs、python和java什么事,想看这些,可以移步未来我写的文章。Orz...
准备工作(Prerequisites)
在开始之前,检查一下你的准备开发或者测试Fabric的平台是否有安装如下软件。哦,对了,由于我极度不喜欢使用安装包,因为下载的安装包总是会随着时间的流逝而过时,所以我喜欢直接用命令来安装,想下载安装包的,可以去各自的官网上找找。
cURL
下载代码以及docker镜像用的。如果你还没装这个,或者在本文中使用curl命令出现了错误,可以考虑下载最新的版本。
$ # 检查你的curl版本 - Check your curl version
$ curl --version
curl 7.58.0 (x86_64-pc-linux-gnu) libcurl/7.58.0 OpenSSL/1.1.0g zlib/1.2.11 libidn2/2.0.4 libpsl/0.19.1 (+libidn2/2.0.4) nghttp2/1.30.0 librtmp/2.3
Release-Date: 2018-01-24
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtmp rtsp smb smbs smtp smtps telnet tftp
Features: AsynchDNS IDN IPv6 Largefile GSS-API Kerberos SPNEGO NTLM NTLM_WB SSL libz TLS-SRP HTTP2 UnixSockets HTTPS-proxy PSL
$ # 如果没有就执行下载 - Download if it doesn't exist
$ sudo apt-get update
$ sudo apt install curl
Reading package lists... Done
Building dependency tree
Reading state information... Done
curl is already the newest version (7.58.0-2ubuntu3.5).
0 upgraded, 0 newly installed, 0 to remove and 26 not upgraded.
Docker and Docker Compose
orderer/peer节点启动,链码安装/实例化/执行/升级等用的。
$ # 检查你的docker版本 - Check your docker version
$ docker --version
Docker version 18.09.0, build 4d60db4
$ docker-compose --version
docker-compose version 1.17.1, build unknown
$ # 如果没有就执行下载 - Download if it doesn't exist
$ sudo apt-get update
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
$ sudo apt-key fingerprint 0EBFCD88
$ sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
$ sudo apt-get update
$ sudo apt-get install docker-ce
$ # 国内用户因为网络、未翻墙或者其他灵异事件可能hello-world执行不了会失败. 不过这不重要。 - It will be failed in China because the God is watching you. But it doesn't matter. :)
$ sudo docker container run hello-world
$ sudo apt install docker-compose
Go
主要是来写链码(chaincode)的。1.4版本的fabric要求go版本在1.11.x以上。
$ # 检查你的go版本 - Check your go version
$ go version
go version go1.11.4 linux/amd64
$ # 如果没有就执行下载 - Download if it doesn't exist
$ sudo add-apt-repository ppa:longsleep/golang-backports
$ sudo apt-get update
$ sudo apt-get install golang-go
$ # 配置环境变量,这个很重要,目前来讲,GOPATH是fabric必须有的。
$ vim ~/.bashrc
$ # 如果没有装vim可能会报错,直接按提示安装就好了 sudo apt install vim
$ # 打开文件后,按 i 进入编辑模式,在文件末尾粘贴(Shift+Insert)上如下内容:
export PATH=$PATH:$(go env GOPATH)/bin
export GOPATH=$(go env GOPATH)
export GOROOT=$(go env GOROOT)
export GOARCH=amd64
export GOOS=linux
$ # 粘贴完后,按Esc推出编辑模式,输入命令:wq! 保存退出后执行source命令让其立即生效
$ source ~/.bashrc
$ 测试是否设置成功 - Check if it is successful
$ echo $GOPATH
/home/wff/go
构建你的第一个网络(Building Your First Network)
构建你的第一个网络(byfn)方案提供了一个Hyperledger Fabric示例网络,该网络由两个组织组成,每个组织维护两个peer节点,以及一个基于“solo”模式的orderer节点。
安装镜像
鉴于在国内可能不想翻墙甚至不会翻墙的同志大有人在,我也就直接上不用翻墙的命令了。
$ cd ~
$ mkdir hyperledger-fabric
$ cd hyperledger-fabric
$ curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh | bash -s 1.4.0 1.4.0 0.4.14
$ # 这一步耐心很重要,最好是在晚上睡觉的时候,等第二天醒来就下载好了,这就美滋滋,否则,等几个小时还算你网速是好的吧。
$ # 查看是否下载成功
$ configtxlator version
configtxlator:
Version: 1.4.0
Commit SHA: development build
Go version: go1.11.4
OS/Arch: linux/amd64
$ # 如果报错找不到这个命令 - configtxlator: command not found,那么可能你需要手动设置全局命令
$ cd ~/hyperledger-fabric/fabric-samples/bin
$ sudo cp * /usr/local/bin
生成网络构件
生成构件的过程中,会生成包括orderer节点组织和peer节点组织的证书,以及创始块,配置交易块等信息,同时检查docker镜像版本。
$ cd ~/hyperledger-fabric/fabric-samples/first-network/
$ ./byfn.sh generate
$ # 如果打印出来的日志包含如下内容,则说明工具版本和docker镜像版本不匹配,需要重新下载镜像
=================== WARNING ===================
Local fabric binaries and docker images are
out of sync. This may cause problems.
===============================================
$ # 工具版本
$ configtxlator version | sed -ne 's/ Version: //p'
1.4.0
$ # docker镜像版本
$ docker run --rm hyperledger/fabric-tools:latest peer version | sed -ne 's/ Version: //p' | head -1
1.4.0
$ # 如果不匹配,则删除错误版本的镜像,重新设置版本安装镜像
$ # 删除全部镜像
$ docker images|awk '{printf "%s:%s\n",$1,$2}'|xargs docker rmi
$ # 重新设置版本,比如1.3.0
$ curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh | bash -s 1.3.0 1.3.0 0.4.14
构建网络
如果上一步的generate没有出现任何问题,那么接下来就可以开始构建简易的fabric网络了。
$ # 这里的命令不加-l参数,所以默认是go语言
$ ./byfn.sh up
$ # 如果看到如下内容,说明网络已经构建成功并开始启动了。接下来它会完成一个e2e测试告诉你大致的流程
Starting with channel 'mychannel' and CLI timeout of '10'
Continue? [Y/n]
proceeding ...
Creating network "net_byfn" with the default driver
Creating peer0.org1.example.com
Creating peer1.org1.example.com
Creating peer0.org2.example.com
Creating orderer.example.com
Creating peer1.org2.example.com
Creating cli
____ _____ _ ____ _____
/ ___| |_ _| / \ | _ \ |_ _|
\___ \ | | / _ \ | |_) | | |
___) | | | / ___ \ | _ < | |
|____/ |_| /_/ \_\ |_| \_\ |_|
Channel name : mychannel
Creating channel...
$ # 成功执行后,会出现如下内容:
Query Result: 90
2017-05-16 17:08:15.158 UTC [main] main -> INFO 008 Exiting.....
===================== Query successful on peer1.org2 on channel 'mychannel' =====================
===================== All GOOD, BYFN execution completed =====================
_____ _ _ ____
| ____| | \ | | | _ \
| _| | \| | | | | |
| |___ | |\ | | |_| |
|_____| |_| \_| |____/
你可以滚动这些日志查看交易的流程,如果你并没有得到上面的结果,可以看看官网的错误说明找找原因。
关闭网络
这个会关闭并删除掉所有docker中与之相关的容器,没啥好说的。
$ ./byfn.sh down
另外,还有个重启命令,可以试试。
$ ./byfn.sh restart
错误记录
这里会放一些我在启动过程中遇到的,或者别人遇到的错误问题,和一些解决方案,不过目前我有点忘了,下次遇见的时候再记录下来。一般来讲,按照教程走,基本没多大问题。
后记
这篇教程对于fabric建立一个简单认知是没有问题的,但如果想深入研究,你会发现你几无所得。所以,接下来,我会深入写一篇关于手动构建fabric网络,包括自己生成组织,证书,启动排序、对等节点,以及手撸链码的日志。等有空再说吧,现在正在给fabric加密类型增加国密算法,可能懒得写了就。