工欲善其事，必先利其器：安装Fabric

目标

  1. 顺利下载Hyperledger Fabric
  2. 明确bootstrap.sh脚本做了哪些事

任务实现

年青人，关键时刻到了，这门神功必须要有大毅力且拥有常人所不具备的耐性的人才能练成，所以这一步就是为了考验你的毅力及耐性而设置的。

要想学好神功，必须先有相应的利器，而这把利器就只能由自己根据那些妖孽留下的线索来锻造。

1.3.1 下载Fabric-samples与二进制文件

为了方便后期管理，在当前登录用户的HOME目录下创建一个空目录并进入该目录

$ mkdir hyfa && cd hyfa

新建文件bootstrap.sh并添加内容

$ vim bootstrap.sh

将 https://github.com/hyperledger/fabric/blob/master/scripts/bootstrap.sh 中的内容拷贝保存退出。

该 bootstrap.sh 可执行脚本文件的作用：

  1. 如果在当前目录中没有 hyperledger/fabric-samples，则从 github.com 克隆 hyperledger/fabric-samples 存储库
  2. 使用 checkout 签出对应指定的版本标签
  3. 将指定版本的Hyperledger Fabric平台特定的二进制文件和配置文件安装到 fabric-samples 存储库的根目录中
  4. 下载指定版本的 Hyperledger Fabric docker 镜像文件
  5. 将下载的 docker 镜像文件标记为 "latest"

赋予bootstrap.sh可执行权限并运行

$ chmod +x bootstrap.sh

执行bootstrap.sh

$ sudo ./bootstrap.sh 1.2.0

确定网络稳定，否则会导致各种问题，例如下载到一半时网络超时，下载失败等等；由于Docker的各种镜像文件下载时间较长，所以请耐心等待。

下载完成后，查看相关输出内容；如果下载有失败的镜像, 可再次执行 $ sudo ./bootstrap.sh 1.2.0 命令重新下载。

重新执行脚本命令对于已下载的Docker镜像文件不会再次重新下载。

安装完成后终端自动输出：

===> List out hyperledger docker images
hyperledger/fabric-ca          1.2.0       66cc132bd09c    4 weeks ago     252 MB
hyperledger/fabric-ca          latest      66cc132bd09c    4 weeks ago     252 MB
hyperledger/fabric-tools       1.2.0       379602873003    4 weeks ago     1.51 GB
hyperledger/fabric-tools       latest      379602873003    4 weeks ago     1.51 GB
hyperledger/fabric-ccenv       1.2.0       6acf31e2d9a4    4 weeks ago     1.43 GB
hyperledger/fabric-ccenv       latest      6acf31e2d9a4    4 weeks ago     1.43 GB
hyperledger/fabric-orderer     1.2.0       4baf7789a8ec    4 weeks ago     152 MB
hyperledger/fabric-orderer     latest      4baf7789a8ec    4 weeks ago     152 MB
hyperledger/fabric-peer        1.2.0       82c262e65984    4 weeks ago     159 MB
hyperledger/fabric-peer        latest      82c262e65984    4 weeks ago     159 MB
hyperledger/fabric-zookeeper   0.4.10      2b51158f3898    5 weeks ago     1.44 GB
hyperledger/fabric-zookeeper   latest      2b51158f3898    5 weeks ago     1.44 GB
hyperledger/fabric-kafka       0.4.10      936aef6db0e6    5 weeks ago     1.45 GB
hyperledger/fabric-kafka       latest      936aef6db0e6    5 weeks ago     1.45 GB
hyperledger/fabric-couchdb     0.4.10      3092eca241fc    5 weeks ago     1.61 GB
hyperledger/fabric-couchdb     latest      3092eca241fc    5 weeks ago     1.61 GB

添加环境变量（可选执行命令）

$ export PATH=<path to download location>/bin:$PATH

<path to="" download="" location="" style="box-sizing: border-box;">表示 fabric-samples 文件目录所在路径</path>

例:  $ export PATH=$HOME/hyfa/fabric-samples/bin:$PATH

1.3.2 Fabric源码方式编译

上一小节中，我们以提供脚本的方式，可以下载并安装 samples 和二进制文件到操作系统中，大大简化的安装过程。

Hyperledger Fabric 还有另外的一种安装方式，就是以源代码的方式进行本地编译安装，此方式相较上一小节的方式，略微复杂，需要手动编译生成相应的工具，我们在此给大家逐一介绍

下载源码

首先，使用 mkdir 命令创建相应的目录，然后使用 git clone 命令将 Hyperledger Fabric 源代码克隆至该目录中：

$ mkdir -p $GOPATH/src/github.com/hyperledger/
$ cd $GOPATH/src/github.com/hyperledger/
$ git clone https://github.com/hyperledger/fabric.git

提示：也可以使用 go get 命令下载源码，需要手动创建相应的目录：

$ go get github.com/hyperledger/fabric

注：下载时间可能需要几分钟，也可能需要十几分钟，取决于当前的网络环境，请耐心等待。

然后使用 git checkout 命令切换至指定的分支：

$ cd $GOPATH/src/github.com/hyperledger/fabric/
$ git checkout -b v1.2.0

源码下载完成之后，并不能直接使用，我们需要对其进行编译，生成所需要的各种节点及相应的工具。我们直接使用源码中提供的 Makefile 来进行编译，首先对 Makefile 文件进行编辑，指定相应的版本：

$ vim Makefile

将文件中 BASE_VERSION、PREV_VERSION、CHAINTOOL_RELEASE、BASEIMAGE_RELEASE 的值进行修改，修改之后的内容为：

BASE_VERSION = 1.2.1
PREV_VERSION = 1.2.0
CHAINTOOL_RELEASE=1.1.1
BASEIMAGE_RELEASE=0.4.10

编译Orderer

$ cd $GOPATH/src/github.com/hyperledger/fabric/
$ make orderer

命令执行后终端输出如下：

make_orderer

编译Peer

$ make peer
make_peer

查看 .build/bin 目录

$ ll .build/bin/
buildbindir

编译生成相关工具

Hyperledger Fabric 除了 Orderer 和 Peer 之外，还为我们提供了在搭建网络环境时所需要的一系列辅助工具：

  • configtxgen：生成初始区块及通道交易配置文件的工具
  • cryptogen：生成组织结构及相应的的身份文件的工具
  • configtxlator：将指定的文件在二进制格式与JSON格式之间进行转换

编译生成这些工具同样使用 make 即可：

$ make configtxgen 
$ make cryptogen 
$ make configtxlator
make_tools

编译生成 docker 镜像

将当前用户添加到 docker 组

$ sudo usermod -aG docker kevin

添加成功后注销或重启系统。

安装依赖的 libltdl-dev 库：

$ sudo apt-get install libltdl-dev

获取镜像方式一：

编译生成docker镜像需要使用到Go的工具，所以我们需要通过 git clone 命令从 github.com 克隆至当前系统中：

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

执行命令后将指定的环境变量设置到用户的环境文件中(.bashrc)中

$ vim ~/.bashrc

export PATH=$PATH:$GOPATH/bin

执行 source 命令：

$ source ~/.bashrc

Fabric代码由Golang 构建，所以需要安装Go相关的工具，以方便开发和调试：

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

$ cd $GOPATH
$ go get github.com/kardianos/govendor
$ go get github.com/onsi/ginkgo/ginkgo
$ go get github.com/golang/protobuf/protoc-gen-go
$ go get -u github.com/axw/gocov/...
$ go get -u github.com/AlekSi/gocov-xml
$ go get -u github.com/client9/misspell/cmd/misspell
$ go get -u golang.org/x/tools/cmd/goimports
$ go get -u github.com/golang/lint/golint

将之前安装的 Go工具复制到Fabric目录：

$ cd $GOPATH/src/github.com/hyperledger/fabric/
$ mkdir -p .build/docker/gotools/bin
$ cp ~/go/bin/* .build/docker/gotools/bin

使用 make docker 编译生成相关的 docker 镜像：

$ cd $GOPATH/src/github.com/hyperledger/fabric/
$ make docker

获取镜像方式二：

可以直接从Dockerhub拉取镜像，使用 docker pull 命令拉取指定的 docker 镜像

$ export FABRIC_TAG=1.2.0
$ export CA_TAG=1.2.0
$ export THIRDPARTY_IMAGE_VERSION=0.4.10

$ docker pull hyperledger/fabric-peer:$FABRIC_TAG \
&& docker pull hyperledger/fabric-orderer:$FABRIC_TAG \
&& docker pull hyperledger/fabric-ca:$CA_TAG \
&& docker pull hyperledger/fabric-tools:$FABRIC_TAG \
&& docker pull hyperledger/fabric-ccenv:$FABRIC_TAG \
&& docker pull hyperledger/fabric-baseimage:$THIRDPARTY_IMAGE_VERSION \
&& docker pull hyperledger/fabric-baseos:$THIRDPARTY_IMAGE_VERSION \
&& docker pull hyperledger/fabric-couchdb:$THIRDPARTY_IMAGE_VERSION \
&& docker pull hyperledger/fabric-kafka:$THIRDPARTY_IMAGE_VERSION \
&& docker pull hyperledger/fabric-zookeeper:$THIRDPARTY_IMAGE_VERSION

将已下载的镜像标记为最新

$ docker tag hyperledger/fabric-peer:$FABRIC_TAG hyperledger/fabric-peer \
&& docker tag hyperledger/fabric-orderer:$FABRIC_TAG hyperledger/fabric-orderer \
&& docker tag hyperledger/fabric-ca:$CA_TAG hyperledger/fabric-ca \
&& docker tag hyperledger/fabric-tools:$FABRIC_TAG hyperledger/fabric-tools \
&& docker tag hyperledger/fabric-ccenv:$FABRIC_TAG hyperledger/fabric-ccenv \
&& docker tag hyperledger/fabric-baseimage:$THIRDPARTY_IMAGE_VERSION hyperledger/fabric-baseimage \
&& docker tag hyperledger/fabric-baseos:$THIRDPARTY_IMAGE_VERSION hyperledger/fabric-baseos \
&& docker tag hyperledger/fabric-couchdb:$THIRDPARTY_IMAGE_VERSION hyperledger/fabric-couchdb \
&& docker tag hyperledger/fabric-kafka:$THIRDPARTY_IMAGE_VERSION hyperledger/fabric-kafka \
&& docker tag hyperledger/fabric-zookeeper:$THIRDPARTY_IMAGE_VERSION hyperledger/fabric-zookeeper

之后使用 docker images 命令查看相关的镜像信息：

$ docker images
dockertag

Hyperledger Fabric 可以有两种方式进行编译安装，第一种方式（bootstrap.sh脚本方式）进行环境的安装，优点是简单、方便，能够快速上手；第二种方式以 Fabric 源码方式进行编译，适合动手能力较强的人员，优点是可以对 Hyperledger Fabric 相关组件有深入的理解，但缺点是容易出现各种错误且修正比较麻烦。

注：本书的 Hyperledger Fabric 环境为方便起见，所以采用第一种方式（bootstrap.sh脚本方式）进行的安装构建。

FAQ

  1. bootstrap.sh脚本中的内容是干什么用的？

    脚本执行后将下载并提取设置网络所需的所有特定于平台的二进制文件，并保存在本地仓库中，

    然后将Docker Hub中的Hyperledger Fabric docker镜像下载到本地Docker注册表中，并将其标记为”最新”。

  2. 下载Docker镜像文件速度特别慢，有什么好的解决方式？

    可在 https://www.daocloud.io/ 网站中注册一个账号, 注册成功后， 可以点击加速器图标（如下图所示）以获取Docker加速器。

    Docker加速器图标

    配置Docker加速器

    在命令提示符中输入如下图所示的daocloud.io分配的加速器脚本命令（将输入框中的脚本命令复制到命令提示符窗口中执行即可）， 执行完脚本之后， 不要忘记重启Docker服务

    Docker加速器脚本命令

    重启Docker服务

    执行完该命令后，必须重启Docker服务以生效

    $ sudo systemctl restart docker.service

  3. 下载完成后，添加的环境变量有什么意义？

    执行该命令后，意义为在系统中任何路径下使用Fabric相关的命令都可以让系统能够找到该命令并且顺利执行。后期我们会进入到Fabric目录中执行相应的命令，所以该环境变量也可以不添加。

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 202,009评论 5赞 474
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 84,808评论 2赞 378
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 148,891评论 0赞 335
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,283评论 1赞 272
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,285评论 5赞 363
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,409评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,809评论 3赞 393
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,487评论 0赞 256
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,680评论 1赞 295
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,499评论 2赞 318
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,548评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,268评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,815评论 3赞 304
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,872评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,102评论 1赞 258
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,683评论 2赞 348
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,253评论 2赞 341

推荐阅读更多精彩内容