手把手教你编译Fabric源代码

Posted 2021-12-05 anapodoton

前言

之前一直在使用fabric编译好的镜像，这次想自己去手动编译下fabric的源码，去生成peer,orderer这些二进制文件以及cryptogen这些工具和docker镜像。

如果网络没有问题的话，在fabric目录下，使用makefile,直接make all即可。

但是做的时候，才知道由于国内网络的原因，很多库都不能使用，造成编译失败。在网络上也没找到很好的贴子，官方的文档，也没有详细的描述，可能是因为简单吧，网络好的时候，直接就可以成功的。

现把我踩坑的记录整理如下：

1. 环境变量

本文是基于ubutu 18.04,Fabric v1.3.0。

环境变量的设置，不用详细的描述，需要下载curl，git，node.js,docker,docker-compose等工具，不会的童鞋可以自己百度。

我想说下go环境的变量的配置，其实百度上的教程挺多的，但是都是抄来抄去的，按照这样做并不好，我先来贴出来我的，再来进行详细的解释（来源于官网）。

export GOPATH=/opt/gopath
export PATH=$PATH:/opt/go/bin

第二行设置的是go的安装目录，我的目录是/opt/go,我们需要把go的bin目录设置倒环境变量PATH中。在第一行我设置的是GOPATH，GOPATH是go的工作目录。在go1.8之后，如果不设置这个值的话，默认目录是~/go。还需要注意的一点是go的工作目录不能和安装目录不能一样。(插一句题外话，工作目录用来存放Go的源码，Go的可运行文件以及相应的编译之后的包文件，即src,bin,pkg。)

注意：GOPATH不需要设置到PATH中，设置好GO的安装目录后，会自动寻找GOPATH。

GOPATH官方

2 第三方包的下载

此外，Fabric使用Go开发，使用到了一些第三方工具，我们需要提前下载好。

mkdir –p $GOPATH/src/golang.org/x
cd $GOPATH/src/golang.org/x
git clone https://github.com/golang/tools.git

即使下载好上面的tools工具，还是不够，我们还是需要下载第三方的go管理工具，gopm

go get -u github.com/gpmgo/gopm

接下来，我们就可以使用gopm工具安装需要使用到的go包。

建议：在下载下面这些包的时候，我们首先可以使用go get来下载安装，这样是比较方便的。gopm则需要两步，首先是gopm get ...,然后是go install...。

是这样的，举个例子：

gopm get -g -d golang.org/x/tools/cmd/goimports

go install golang.org/x/tools/cmd/goimports

接下来，我们需要安装所需要的工具，注意，如果某个包下载失败，可以使用gopm的方法。

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

让人十分恶心的是github.com/golang/lint/golint这个包，使用go get和gopm get都无法下载。

我们可以先在GitHub上下载源代码，然后在执行go install进行安装。

此外，我们还需要下载libltdl-dev这个库：

sudo apt-get install libltdl-dev 

3. Fabric的编译

3.1 Fabric代码的下载：

mkdir -p ~/gopath/src/github.com/hyperledger 
cd ~/gopath/src/github.com/hyperledger 
git clone https://github.com/hyperledger/fabric.git
cd fabric
git checkout v1.3.0

这些做完之后，我们需要把上面生成的二进制文件，拷贝到 /opt/gopath/src/github.com/hyperledger/fabric/.build/bin

和/opt/gopath/src/github.com/hyperledger/fabric/build/docker/gotools/bin目录下。

3.2 编译二进制文件

3.2.1 编译相关包

我们使用下面的命令，make release来生成相关的包。

我们生成了cryptogen,configtxlator,cryptogen,orderer和peer等相关二进制文件。可以把他们拷贝倒build/docker/gotools/bin目录下，用于后面的使用。

3.2.2 编译基础镜像

接下来我们需要构建fabric-ccenv和fabric-javaenv镜像，这两个镜像的构建也是十分恶心的。

需要首先下载fabric-baseimage镜像，一般这个镜像是没任何问题的，问题的关键在于chaintool，这个很容易就挂掉了。挂掉的时候，我们可以手动去下载。

不过，这个地方给了我们网址，我们可以手动去下载。

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

下载后放到.build/bin下即可。注意选择适合自己的版本。

接着我们使用make peer命令即可下载进行构建，会先自动下载fabric-ccenv和fabric-javaenv。

3.2.3 docker镜像的生成

如果前面没有失败的话，会生成各种二进制文件，我们需要把这些二进制文件打包到docker镜像中。

为了方便，我们可以直接使用命令make docker即可构建所需的docker镜像，我们也可以使用

make orderer-docker,make peer-docker,make tools-docker来分别进行构建。

我们来看下，最后成功构建的镜像：

最后我们来看下docker镜像之间的各种以来关系：

4. 总结

经过上面的实操，发现真的去构建还是比较麻烦的，官方没有详细的文档也描述，网上的博客大都零零星星。需要自己不断的踩坑。

另外，当需要安装软件的时候，我们最好去官方的文档，这样不会出错，因为网上的博客的问题在于其版本可能不对，存在某个依赖包版本错误的问题，为以后的开发埋下隐患。