免责声明:凤梨财经作为开放的信息发布平台,所提供的所有内容与凤梨财经观点和立场无关,且不构成任何投资理财建议。投资有风险,入市需谨慎。

在本地编译Fabric Code实操案例

2018-01-03 阅读量 273
摘要:在本地编译Fabric Code实操案例说明……

点击蓝字,轻松关注

本文来源:深蓝居   如有版权问题请与我们联系

作者:曾毅  网名:深蓝

原文链接:https://www.cnblogs.com/studyzy/p/8030613.html

本文约3000字+,阅读(观看)需要28分


一、环境准备


1、用VirtualBox并在其中安装好Ubuntu

这一步其实没啥好说的,下载好最新版的VirtualBox,下载Ubuntu Server,我用的是Ubuntu16.04.2 X64 Server。我使用的用户是studyzy,不建议直接在root下执行命令。在安装完Ubuntu后,需要保证apt source是国内的,不然如果是国外的话会很慢很慢的。具体做法是

sudo vi /etc/apt/sources.list


打开这个apt源列表,如果其中看到是https://us.xxxxxx之类的,那么就是外国的,如果看到是https://cn.xxxxx之类的,那么就不用换的。我的是美国的源,所以需要做一下批量的替换。在命令模式下,输入:

:%s/us./cn./g


就可以把所有的us.改为cn.了。然后输入:wq即可保存退出。

sudo apt-get update


更新一下源。

然后安装ssh,这样接下来就可以用putty或者SecureCRT之类的客户端远程连接Ubuntu了。

sudo apt-get install ssh


2. Go的安装

Ubuntu的apt-get虽然提供了Go的安装,但是版本比较旧,最好的方法还是参考官方网站 https://golang.org/dl/ ,下载最新版的Go。具体涉及到的命令包括:

wget https://redirector.gvt1.com/edgedl/go/go1.9.2.linux-amd64.tar.gzsudo tar -C /usr/local -xzf go1.9.2.linux-amd64.tar.gz


【注意:不要使用apt方式安装go,apt的go版本太低了!】

接下来编辑当前用户的环境变量:

vi ~/.profile


添加以下内容:

export PATH=$PATH:/usr/local/go/bin 
export GOROOT=/usr/local/go 
export GOPATH=$HOME/go 
export PATH=$PATH:$HOME/go/bin


编辑保存并退出vi后,记得把这些环境载入:

source ~/.profile


我们把go的目录GOPATH设置为当前用户的文件夹下,所以记得创建go文件夹

cd ~mkdir go


运行以下命令查看当前go的版本,如果能够显示go版本,那么说明我们的go安装成功.

go version


3. Docker安装

我们可以使用阿里提供的镜像,安装也非常方便,参考:https://yq.aliyun.com/articles/110806 ,其中Ubuntu的脚本是:

# step 1: 安装必要的一些系统工具sudo apt-get updatesudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
# step 2: 安装GPG证书
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -# Step 3: 写入软件源信息sudo add-apt-repository "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"# Step 4: 更新并安装 Docker-CEsudo apt-get -y updatesudo apt-get -y install docker-ce


安装完成后需要修改当前用户(我使用的用户叫studyzy)权限:

sudo usermod -aG docker studyzy


注销并重新登录,然后添加阿里云的Docker Hub镜像:

sudo mkdir -p /etc/dockersudo tee /etc/docker/daemon.json <<-'EOF'{  "registry-mirrors": ["https://obou6wyb.mirror.aliyuncs.com"]
}
EOFsudo systemctl daemon-reloadsudo systemctl restart docker


不同的版本添加方法是不一样的,官方的文档如下:


https://cr.console.aliyun.com/#/accelerator

当然觉得阿里云镜像不好用,喜欢用DaoClound的也可以用DaoClound的镜像。DaoCloud的镜像设置文档为:https://www.daocloud.io/mirror#accelerator-doc


4. Docker-Compose的安装

Docker-compose是支持通过模板脚本批量创建Docker容器的一个组件。然后是安装docker-compose,我们从官方网站(https://github.com/docker/compose/releases)下载,运行脚本:

sudo curl -L https://github.com/docker/compose/releases/download/1.17.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose


5.Pip的安装

Pip是基于Python的一个工具,需要安装Python-pip,运行脚本:

sudo apt-get install python-pip
这个脚本会安装Pip所依赖的Python和各种库,所以安装pip完毕后我们也有了Python的环境。运行以下命令可以检查pip和Python的版本:
pip –V
apt安装的版本可能不够新,我们使用以下命令可以更新pip版本:
pip install --upgrade pip


6. Go Tools安装

Fabric使用GO开发,其中用到了一些官方或者第三方的工具,我们也需要下载。尤其是golang的网址被墙了,我们只有访问GitHub的镜像。
mkdir –p $GOPATH/src/golang.org/x
cd $GOPATH/src/golang.org/x
git clone https://github.com/golang/tools.git
等tools下载完毕,我们可以运行以下命令来安装Fabric可能用到的Go工具:
go get github.com/kardianos/govendor
go get github.com/golang/lint/golint
go get golang.org/x/tools/cmd/goimports
go get github.com/onsi/ginkgo/ginkgo
go get github.com/axw/gocov/...
go get github.com/client9/misspell/cmd/misspell
go get github.com/AlekSi/gocov-xml
go get github.com/golang/protobuf/protoc-gen-go


7. 第三方库安装

Fabric依赖的第三方库里面,有些库又依赖了其他库,而这些库是需要我们先手动准备好的。比如libltdl-dev,这是PKCS11用到的一个库,我们需要安装:

sudo apt-get install libltdl-dev 


8. Fabric源码下载

我们可以使用Git命令下载源码,首先需要建立对应的目录,然后进入该目录,Git下载源码:
mkdir -p ~/go/src/github.com/hyperledger 
cd ~/go/src/github.com/hyperledger 
git clone https://github.com/hyperledger/fabric.git

等Fabric下载完毕后,我们就切换到Fabric源码的文件夹:

cd ~/go/src/github.com/hyperledger/fabric


二、编译Fabric


编译Fabric的代码主要是通过make命令来完成,因为官方已经写好了完整的Makefile,所以我们要编译各个Fabric的组件还是比较简单的。


下面我们就分步骤来编译Fabric。


1.Orderer节点的编译

Orderer节点容器里面运行的是orderer服务,我们要生成Orderer镜像,就需要先编译出Orderer程序。执行:

make orderer


这是我在CLI下执行的结果:

studyzy@ubuntu1:~/go/src/github.com/hyperledger/fabric$ make orderer 
build/bin/orderer 
CGO_CFLAGS=" " GOBIN=/home/studyzy/go/src/github.com/hyperledger/fabric/build/bin go install -tags "" -ldflags "-X github.com/hyperledger/fabric/common/metadata.Version=1.0.6-snapshot-a8728bc -X github.com/hyperledger/fabric/common/metadata.BaseVersion=0.3.2 -X github.com/hyperledger/fabric/common/metadata.BaseDockerLabel=org.hyperledger.fabric -X github.com/hyperledger/fabric/common/metadata.DockerNamespace=hyperledger -X github.com/hyperledger/fabric/common/metadata.BaseDockerNamespace=hyperledger" github.com/hyperledger/fabric/orderer 
Binary available as build/bin/orderer


从日志可以看出,Orderer编译完成后,会把二进制文件放在build/bin/orderer。


2.Peer节点的编译

Peer节点的编译会比Orderer复杂很多,因为墙的原因,我们需要做一些额外的操作。另外链码是运行在Peer所在的机器上,所以需要给ChainCode准备运行基础环境,也就是ccenv和javaenv两个镜像。在make peer之前我们必须先保证本地没有对应的镜像文件,如果有,那么就用docker rmi命令删除之前下载或者编译好的镜像。

还记得前面下载的Go Tools吗,这里需要copy到Fabric目录里面来:

mkdir -p build/docker/gotools/bincp ~/go/bin/* build/docker/gotools/bin


以上操作纯粹是为了绕开墙,如果你本身不存在墙的问题,那么完全可以不用如此多此一举。


接下来直接运行以下命令即可编译生成Peer节点的Docker镜像:

make peer


运行该命令后,系统首先会下载hyperledger/fabric-baseimage:x86_64-0.3.2这个镜像到本地,这是所有Fabric镜像的基础镜像文件。


下载后会从官网下载chaintool的jar包,下载地址:


https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/chaintool-1.0.0/hyperledger-fabric-chaintool-1.0.0.jar

这个地址没有被墙,一般来说是能够正常下载下来的。


下载chaintool完毕后,接下来就开始创建fabric-ccenv镜像。所有创建Docker镜像都是基于Dockerfile,我们可以在Fabric目录下的images文件夹看到所有Fabric镜像Build的步骤配置。


在创建fabric-ccenv镜像后,接下来是创建java版ChainCode的基础镜像,也就是fabric-javaenv,最后才是build peer程序,运行成功后看到的日志大概是这样的:

……Successfully built b8f69c7b3c4c 
Successfully tagged hyperledger/fabric-javaenv:latest 
docker tag hyperledger/fabric-javaenv hyperledger/fabric-javaenv:x86_64-1.0.6-snapshot-a8728bc 
build/bin/peer 
CGO_CFLAGS=" " GOBIN=/home/studyzy/go/src/github.com/hyperledger/fabric/build/bin go install -tags "" -ldflags "-X github.com/hyperledger/fabric/common/metadata.Version=1.0.6-snapshot-a8728bc -X github.com/hyperledger/fabric/common/metadata.BaseVersion=0.3.2 -X github.com/hyperledger/fabric/common/metadata.BaseDockerLabel=org.hyperledger.fabric -X github.com/hyperledger/fabric/common/metadata.DockerNamespace=hyperledger -X github.com/hyperledger/fabric/common/metadata.BaseDockerNamespace=hyperledger" github.com/hyperledger/fabric/peer 
Binary available as build/bin/peer


3.Fabric 工具编译

Fabric除了Orderer和Peer外,还为我们提供了几个很方便的工具,在搭建Fabric网络时我们就用到过。那就是:

  • configtxgen

  • cryptogen

  • configtxlator

这三个工具的编译也很简单,直接运行以下命令即可:

make configtxgen 
make cryptogen 
make configtxlator 


4.Docker镜像的生成

前面三步只是生成了Fabric的二进制文件,我们并不能直接使用,而是需要分别将这些二进制文件打包到Docker镜像中。所以我们接下来需要Build Docker Image。

要生成Orderer镜像,那么需要运行命令:

make orderer-docker


由于没有网络文件的依赖,所以这时应该很快就能完成。然后我们继续生成Peer镜像:

make peer-docker


再然后是客户端,也就是fabric-tools,对应的命令是:

make tools-docker


以上3个最重要的镜像生成完成,我们可以用

docker images


查看当前的镜像列表:


5.其他Docker镜像的编译

除了上面我们看到的这些镜像外,实际上我们可能还会用到CouchDB做状态数据库,用Kafka做共识,用Zookeeper做Kafka的高可用支持,这些工具都有对应的Docker镜像,我们仍然可以使用make命令来生成他们。


运行以下命令,系统会给我们生成一整套的Fabric镜像:

make docker


这里一般来说没什么坑,主要是从网上下载一些包下来,会花一些时间。完成后,我们仍然运行

docker images


可以看到我们生成的所有Fabric镜像:


三、总结


如果没有墙的存在,那么我们编译和生成Fabric镜像将非常简单,直接一个make all命令即可。可惜因为墙的存在,所以有些地方需要特殊处理。下一篇博客我会讲到如何运行Fabric中的测试代码。只要我们能够自己编译Fabric,能够跑Fabric的Test,那么我们就可以很方便的对Fabric代码进行修改,并验证我们的修改,更进一步我们就可以将自己的代码提交到社区,为Fabric的壮大添砖加瓦。


热文推荐




区块链兄弟——技术专业问答先行者,区块链爱好者聚集地

请点击“阅读原文”参与留言获取热门区块链技术书籍

声明:本文观点仅代表作者本人,不代表凤梨财经赞同或证实其观点描述。如若侵权,请联系我们删除文章。
您可能感兴趣