Fabric篇——Mac下Hyperledger Fabric(超级账本)环境搭建

0.04字数 832阅读 5756

今天尝试了Mac系统下跑Hyperledger Fabric,过程中踩了一些坑,特地整理出步骤方便大家学习,下面就开始吧。

1. 前提条件

1.1 安装Go并配置环境变量

Mac可以直接通过Homebrew安装go环境:brew install go
或者前往官网下载安装包

安装完毕后在命令行输入go version检查是否安装成功:

➜ go version
go version go1.10.1 darwin/amd64

然后开始配置环境变量:

  1. 先新建一个Go的工作空间文件夹,文件夹路径建议放在$HOME下:

    ➜ cd $HOME
    ➜ mkdir go
    
  2. 进入$HOME目录下:

    ➜ cd $HOME
    

    编辑.bash_profile文件,如果没有请新建。在文件末尾加上:

    #GOPATH
    export GOPATH=$HOME/go
    
    #GOBIN
    export GOBIN=$GOPATH/bin
    export PATH=$PATH:$GOBIN
    

    编辑之后保存,然后执行source命令,使之生效:

    source .bash_profile
    
  3. 通过go env检查:

    ➜ go env
    OARCH="amd64"
    GOBIN="/Users/jianjiangwang/go/bin"
    GOCACHE="/Users/jianjiangwang/Library/Caches/go-build"
    GOEXE=""
    GOHOSTARCH="amd64"
    GOHOSTOS="darwin"
    GOOS="darwin"
    GOPATH="/Users/jianjiangwang/go"
    GORACE=""
    GOROOT="/usr/local/go"
    GOTMPDIR=""
    GOTOOLDIR="/usr/local/go/pkg/tool/darwin_amd64"
    

1.2 安装Docker并更换镜像源

在官网下载Docker CE for Mac完成后安装。

安装后可以在命令行中检查dockerdocker-compose的版本:

➜ docker --version
Docker version 17.12.0-ce, build c97c6d6
➜ docker-compose --version
docker-compose version 1.18.0, build 8dd22a9

开启Docker CE for Mac, 在运行Hyperledger Fabric时,请确保Docker处于开启状态:

Docker拉镜像时会从海外的节点拉取,因为墙的原因,从海外节点拉取简直就是龟速,所以建议将Docker的镜像源更换至aliyun提供的节点

更换镜像源步骤:

  1. 可以直接使用我的专属加速器https://aic2v8yz.mirror.aliyuncs.com,或者去阿里云镜像服务自己申请专属加速器

  2. 点击Docker客户端图标 >> Preference >> Daemon , 然后在Registry mirrors中加入加速器链接https://aic2v8yz.mirror.aliyuncs.com:

2. 下载Hyperledger Fabric项目源代码

进入Go的工作空间, 为fabric创建项目路径:

➜ cd $GOPATH
➜ mkdir -p src/github.com/hyperledger
➜ cd src/github.com/hyperledger
➜ pwd
/Users/jianjiangwang/go/src/github.com/hyperledger

从git上拉取Hyperledger Fabric:

➜ git clone git@github.com:hyperledger/fabric.git
➜ ls
fabric

进入项目文件夹,查看tag:

➜ cd fabric
➜ git tag
baseimage-v0.0.11
v0.6.0-preview
v0.6.1-preview
v1.0.0
v1.0.0-alpha
v1.0.0-alpha2
v1.0.0-beta
v1.0.0-rc1
v1.0.1
v1.0.2
v1.0.3
v1.0.4
v1.0.5
v1.0.6
v1.1.0
v1.1.0-alpha
v1.1.0-preview
v1.1.0-rc1

上面的tag表示相应的fabric项目的版本, fabric项目现在还处于早期发展阶段, 修改频繁且不一定能向下兼容, 所以在继续之前请先确定一个版本,避免后面踩坑。 笔者在这里使用v1.0.0

➜ git checkout v1.0.0
➜ git branch
* (HEAD detached at v1.0.0)
release-1.1

3. 启动项目

进入fabric文件夹下的examples/e2e_cli, 下面我们要测试e2e_cli这个demo:

➜ cd examples/e2e_cli
➜ pwd
/Users/jianjiangwang/go/src/github.com/hyperledger/fabric/examples/e2e_cli

执行download-dockerimage.sh,程序将会通过docker拉取项目所需镜像, 为了统一版本,请指定拉取镜像的版本号:

➜ chmod +x download-dockerimages.sh
➜ ./download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0

等待镜像拉取完成:

===> List out hyperledger docker images
hyperledger/fabric-tools              latest              0403fd1c72c7        8 months ago        1.32GB
hyperledger/fabric-tools              x86_64-1.0.0        0403fd1c72c7        8 months ago        1.32GB
hyperledger/fabric-couchdb            latest              2fbdbf3ab945        8 months ago        1.48GB
hyperledger/fabric-couchdb            x86_64-1.0.0        2fbdbf3ab945        8 months ago        1.48GB
hyperledger/fabric-kafka              latest              dbd3f94de4b5        8 months ago        1.3GB
hyperledger/fabric-kafka              x86_64-1.0.0        dbd3f94de4b5        8 months ago        1.3GB
hyperledger/fabric-zookeeper          latest              e545dbf1c6af        8 months ago        1.31GB
hyperledger/fabric-zookeeper          x86_64-1.0.0        e545dbf1c6af        8 months ago        1.31GB
hyperledger/fabric-orderer            latest              e317ca5638ba        8 months ago        179MB
hyperledger/fabric-orderer            x86_64-1.0.0        e317ca5638ba        8 months ago        179MB
hyperledger/fabric-peer               latest              6830dcd7b9b5        8 months ago        182MB
hyperledger/fabric-peer               x86_64-1.0.0        6830dcd7b9b5        8 months ago        182MB
hyperledger/fabric-javaenv            latest              8948126f0935        8 months ago        1.42GB
hyperledger/fabric-javaenv            x86_64-1.0.0        8948126f0935        8 months ago        1.42GB
hyperledger/fabric-ccenv              latest              7182c260a5ca        8 months ago        1.29GB
hyperledger/fabric-ccenv              x86_64-1.0.0        7182c260a5ca        8 months ago        1.29GB
hyperledger/fabric-ca                 latest              a15c59ecda5b        8 months ago        238MB
hyperledger/fabric-ca                 x86_64-1.0.0        a15c59ecda5b        8 months ago        238MB
hyperledger/fabric-baseos             x86_64-0.3.1        4b0cab202084        10 months ago       157MB

现在执行完整脚本:

➜ ./network_setup.sh up <channel-ID>

如果没有设置channel-ID参数,channel名默认是mychannel。脚本执行成功后输出:

===================== Query on PEER3 on channel 'mychannel' is successful =====================

===================== All GOOD, End-2-End execution completed =====================


 _____   _   _   ____            _____   ____    _____
| ____| | \ | | |  _ \          | ____| |___ \  | ____|
|  _|   |  \| | | | | |  _____  |  _|     __) | |  _|
| |___  | |\  | | |_| | |_____| | |___   / __/  | |___
|_____| |_| \_| |____/          |_____| |_____| |_____|

此时,网络启动运行并测试成功。

如果启动失败请查看错误提示信息。很多情况下都是因为项目的git tag版本号与拉取的docker镜像版本不同导致的

停止网络:

# 在e2e_cli目录下
➜ ./network_setup.sh down
➜ docker rm -f $(docker ps -aq)

删除镜像:
执行docker images命令查看Chaincode镜像,类似输出如下:

REPOSITORY                            TAG                 IMAGE ID            CREATED             SIZE
dev-peer1.org2.example.com-mycc-1.0   latest              3d58e4dac733        4 hours ago         173MB
dev-peer0.org1.example.com-mycc-1.0   latest              91bd46f62e1e        4 hours ago         173MB
dev-peer0.org2.example.com-mycc-1.0   latest              56d327659590        4 hours ago         173MB
hyperledger/fabric-tools              latest              0403fd1c72c7        8 months ago        1.32GB
hyperledger/fabric-tools              x86_64-1.0.0        0403fd1c72c7        8 months ago        1.32GB
hyperledger/fabric-couchdb            latest              2fbdbf3ab945        8 months ago        1.48GB
hyperledger/fabric-couchdb            x86_64-1.0.0        2fbdbf3ab945        8 months ago        1.48GB
hyperledger/fabric-kafka              latest              dbd3f94de4b5        8 months ago        1.3GB
hyperledger/fabric-kafka              x86_64-1.0.0        dbd3f94de4b5        8 months ago        1.3GB
hyperledger/fabric-zookeeper          latest              e545dbf1c6af        8 months ago        1.31GB
hyperledger/fabric-zookeeper          x86_64-1.0.0        e545dbf1c6af        8 months ago        1.31GB
hyperledger/fabric-orderer            latest              e317ca5638ba        8 months ago        179MB
hyperledger/fabric-orderer            x86_64-1.0.0        e317ca5638ba        8 months ago        179MB
hyperledger/fabric-peer               latest              6830dcd7b9b5        8 months ago        182MB
hyperledger/fabric-peer               x86_64-1.0.0        6830dcd7b9b5        8 months ago        182MB
hyperledger/fabric-javaenv            latest              8948126f0935        8 months ago        1.42GB
hyperledger/fabric-javaenv            x86_64-1.0.0        8948126f0935        8 months ago        1.42GB
hyperledger/fabric-ccenv              latest              7182c260a5ca        8 months ago        1.29GB
hyperledger/fabric-ccenv              x86_64-1.0.0        7182c260a5ca        8 months ago        1.29GB
hyperledger/fabric-ca                 latest              a15c59ecda5b        8 months ago        238MB
hyperledger/fabric-ca                 x86_64-1.0.0        a15c59ecda5b        8 months ago        238MB
hyperledger/fabric-baseos             x86_64-0.3.1        4b0cab202084        10 months ago       157MB

然后删除上面三个e2e-cli创建的镜像:

docker rmi -f 3d58e4dac733 91bd46f62e1e 56d327659590

推荐阅读更多精彩内容