动手能力较强的读者,建议通过本地编译安装来部署超级账本Fabric网络,以便对相关组件有更深入的理解。
超级账本Fabric基于Go语言实现,本地编译推荐配置Golang 1.7或更高版本的环境。下面将讲解如何编译生成fabric-peer、fabric-orderer和fabric-ca等组件的二进制文件,以及如何安装一些配置和开发相关的工具。
9.2.1 操作系统
常见的Linux发行版(包括Ubuntu、Redhat、CentOS等)和MacOS等都可以原生支持Fabric编译和运行。
操作系统推荐Linux内核3.10+版本,支持64位环境。另外,作为Fabric节点,物理内存建议至少为2GB, 如果有较多的链码则需要更多容器;预留足够硬盘空间(一般建议20GB或更多)以存储区块文件。在生产环境中对性能和稳定性要求高的场景下,甚至要预留更 多的物理资源。
下面将默认以Ubuntu 16.04操作系统为例进行操作。
提示 运行Fabric节点需要的资源并不苛刻,作为实验,Fabric节点甚至可以在树莓派(Raspberry Pi)上正常运行。
9.2.2 环境配置
1.安装Go语言环境
Go语言环境可以自行访问golang.org网站下载二进制压缩包安装。注意不推荐通过包管理器安装,版本往往比较旧。
如下载Go 1.8版本,可以采用如下命令:
$ curl -O https://storage.googleapis.com/golang/go1.8.linux-amd64.tar.gz
下载完成后,解压目录,并移动到合适的位置(推荐为/usr/local下):
$ tar -xvf go1.8.linux-amd64.tar.gz
$ sudo mv go /usr/local
安装完成后记得配置GOPATH环境变量:
export GOPATH=YOUR_LOCAL_GO_PATH/Go
export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin
此时,可以通过go version命令验证安装是否成功:
$ go version
go version go1.8 linux/amd64
2.安装依赖包
编译Fabric相关代码,需要一些依赖包,可以通过如下命令安装:
$ sudo apt-get update \
&& apt-get install -y libsnappy-dev zlib1g-dev libbz2-dev libltdl-
dev libtool
3.安装Docker
Fabric网络目前依赖Docker服务作为链码容器的支持,因此即使是本地环境运行Fabric网络,也需要在Peer节点上安装Docker环境。推荐使用1.12或者更新的版本。
Linux操作系统下可以通过如下命令来快速安装Docker最新版本:
$ curl -fsSL https://get.docker.com/ | sh
MacOS下可以通过访问http://docs.docker.com/docker-for-mac/install 下载Docker for Mac安装包进行安装。
9.2.3 获取代码
目前,Fabric代码的官方仓库在社区的Gerrit上,并实时同步到GitHub仓库中,读者可以从任一仓库中获取代码。
首先,将Fabric代码按照Go语言推荐方式进行存放,创建目录结构并切换到该目录,如下命令所示:
$ mkdir -p $GOPATH/src/github.com/hyperledger
$ cd $GOPATH/src/github.com/hyperledger
通过如下命令可以获取fabric-peer和fabric-orderer组件编译所需要的代码,两者目前在同一仓库中:
$ git clone http://gerrit.hyperledger.org/r/fabric
默认情况下,会下拉获取带有完整历史的仓库,这个过程取决于网络速度,可能需要较长时间。读者也可以通过--single-branch-b master--depth 1命令选项来指定只获取master分支最新的提交代码,如下命令所示:
$ git clone --single-branch -b master --depth 1 http://gerrit.hyperledger.org/
r/fabric
fabric-ca组件则在另外一个仓库中,同样,可以通过如下命令获取:
$ git clone http://gerrit.hyperledger.org/r/fabric-ca
9.2.4 编译安装fabric-peer组件
通过如下命令手动编译并安装fabric-peer到$GOPATH/bin下。目前fabric处于1.0.0大版本阶段,因此指定相关版本号为1.0.0:
$ cd $GOPATH/src/github.com/hyperledger/fabric
$ ARCH=x86_64
$ BASEIMAGE_RELEASE=0.3.1
$ PROJECT_VERSION=1.0.0
$ LD_FLAGS="-X github.com/hyperledger/fabric/common/metadata.Version=${PROJECT_
VERSION} \
-X github.com/hyperledger/fabric/common/metadata.BaseVersion=${BASEIMAGE_
RELEASE} \
-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"
$ CGO_CFLAGS=" " go install -ldflags "$LD_FLAGS -linkmode external -extldflags
'-static -lpthread'" \
github.com/hyperledger/fabric/peer
当然,用户也可以使用源码中的Makefile来进行编译。这种方式下,需要自动从DockerHub上获取包括基础镜像在内的依赖文件,花费时间可能稍长。相关命令如下所示:
$ cd $GOPATH/src/github.com/hyperledger/fabric
$ make peer
9.2.5 编译安装fabric-orderer组件
通过如下命令手动编译并安装fabric-orderer到$GOPATH/bin下:
$ cd $GOPATH/src/github.com/hyperledger/fabric
$ ARCH=x86_64
$ BASEIMAGE_RELEASE=0.3.1
$ PROJECT_VERSION=1.0.0
$ LD_FLAGS="-X github.com/hyperledger/fabric/common/metadata.Version=${PROJECT_
VERSION} \
-X github.com/hyperledger/fabric/common/metadata.BaseVersion=${BASEIMAGE_
RELEASE} \
-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"
$ CGO_CFLAGS=" " go install -ldflags "$LD_FLAGS -linkmode external -extldflags
'-static -lpthread'" \
github.com/hyperledger/fabric/orderer
同样,使用源码中的Makefile来进行编译的命令如下:
$ cd $GOPATH/src/github.com/hyperledger/fabric
$ make orderer
9.2.6 编译安装fabric-ca组件
可以通过如下命令编译并安装fabric-ca相关组件到$GOPATH/bin下:
$ go install -ldflags " -linkmode external -extldflags '-static
-lpthread'" github.com/hyperledger/fabric-ca/cmd/..
9.2.7 编译安装辅助工具
Fabric中提供了一系列辅助工具,包括cryptogen(生成组织结构和身份文件)、configtxgen(生成配置区块和配置交易)、configtxlator(解读配置信息)等,可以通过如下命令快速编译和安装:
# 编译安装 cryptogen
$ PROJECT_VERSION=1.0.0
$ CGO_CFLAGS=" " \
go install -tags "" \
-ldflags "-X github.com/hyperledger/fabric/common/tools/cryptogen/
metadata.Version=${PROJECT_VERSION}" \
github.com/hyperledger/fabric/common/tools/cryptoge
# 编译安装 configtxgen
$ PROJECT_VERSION=1.0.0
$ CGO_CFLAGS=" " \
go install -tags "nopkcs11" \
-ldflags "-X github.com/hyperledger/fabric/common/configtx/tool/configtxgen/
metadata.Version=${PROJECT_VERSION}" \
github.com/hyperledger/fabric/common/configtx/tool/configtxge
# 编译安装 configtxlator
$ PROJECT_VERSION=1.0.0
$ CGO_CFLAGS=" " \
go install -tags "" \
-ldflags "-X github.com/hyperledger/fabric/common/tools/configtxlator/
metadata.Version=${PROJECT_VERSION}" \
github.com/hyperledger/fabric/common/tools/configtxlato
9.2.8 获取chaintool
chaintool可以协助用户对链码进行打包和部署,方便链码的开发测试,用户可以通过如下命令进行快速安装:
$ curl -L https://github.com/hyperledger/fabric-chaintool/releases/download/v0.
10.3/chaintool > /usr/local/bin/chaintool
$ chmod a+x /usr/local/bin/chaintool
9.2.9 安装Go语言相关工具
Fabric代码由Go语言构建,开发者可以选择安装如下的Go语言相关工具,以方便开发和调试:
$ go get github.com/golang/protobuf/protoc-gen-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-xm
9.2.10 示例配置
sampleconfig目录下包括了一些示例配置文件,可以作为参考基础进行编写。将它们复制到默认的配置目录(/etc/hyperledger/fabric)下:
$ cd $GOPATH/src/github.com/hyperledger/fabric/sampleconfig
$ cp configtx.yaml /etc/hyperledger/fabric
$ cp core.yaml /etc/hyperledger/fabric
$ cp orderer.yaml /etc/hyperledger/fabric
$ cp msp/config.yaml /etc/hyperledger/fabric
来源:我是码农,转载请保留出处和链接!
本文链接:http://www.54manong.com/?id=930