hyperledger fabric 1.4 单机安装教程

Fabric v1.4.0单机安装部署

一、前期准备

fabric的安装依赖于docker环境,所以前提需要安装好docker,同时对一些软件的版本也做了要求如下所示,:

  • curl需要最新版本,
  • docker 版本17.06以上
  • docker-compose1.14.0以上版本
  • go 版本1.11以上版本

本文档安装的操作系统为ubuntu,如果是centos,基础环境的准备请自行切换到centos,如需视频学习,可以参考视频教程.

  1. cURL最新版安装

    # 下载最新版的cURL并将其解压
    wgethttps://curl.haxx.se/download/curl-7.65.3.tar.xz
    sudo tar xzvf curl-7.63.0.tar.gz -C /home
       # 编译并安装cURL
    cd /home/curl-7.65.3
    ./configure
    make
    sudo make install

    通过运行curl --version查看是否安装成功。

  2. Docker和Docker Compose安装

    • Docker

首先卸载可能存在的旧版本

sudo apt-get remove docker docker-engine docker.io containerd runc
   sudo apt-get update 
sudo apt-get install  apt-transport-https  ca-certificates gnupg-agent software- properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu
   $(lsb_release -cs) stable"
    sudo apt-get update
    sudo apt-get install docker-ce docker-ce-cli containerd.io
docker version查看是否成功
 ```
  • Docker Compose

    # 下载Docker Compose二进制文件
    sudo curl -L "https://github.com/docker/compose/releases/download/1.23.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    
    sudo chmod +x /usr/local/bin/docker-compose
  1. Go安装

    # 下载go1.11.linux-amd64.tar.gz并将其解压到指定目录(此处为/usr/local)
    wget https://studygolang.com/dl/golang/go1.11.linux-amd64.tar.gz
    tar xzvf go1.11.linux-amd64.tar.gz -C /usr/local
    
    goenvset.sh文件内容如下所示:
    
    cat >> /etc/profile << EOF
    export GOROOT=/usr/local/go
    export GOARCH=amd64
    export GOOS=linux
    export GOPATH=/home/ubuntu/gopath
    export GOBIN=\$GOPATH/bin
    export PATH=\$GOPATH/bin:\$GOROOT/bin:\$PATH
    EOF
    
    # 执行已有的goenvset.sh向/etc/profile中写入相应的环境变量
    sudo chmod 705 goenvset.sh      # 更改goenvset.sh的权限使其可执行
    sudo ./goenvset.sh                # 执行goenvset.sh脚本
    
    # 使环境变量生效
    source /etc/profile

二、Fabric安装

  1. 将fabric-samples下载到$GOPATH/src/github.com/hyperledger目录中

    mkdir -p $GOPATH/src/github.com/hyperledger
    cd $GOPATH/src/github.com/hyperledger
    # 克隆fabric-samples项目并切换到v1.4tag
    git clone https://github.com/hyperledger/fabric-samples.git
    cd fabric-samples
    git checkout -b sample v1.4.0
  2. 安装Fabric Binaries和Fabric相关的Docker镜像

    cd $GOPATH/src/github.com/hyperledger/fabric-samples/scripts
    # 安装Fabric、Fabric-ca以及第三方Docker镜像(./bootstrap.sh <fabric> <fabric-ca> <thirdparty>)
    ./bootstrap.sh 1.4.0 1.4.0 0.4.14

    值得注意的是,如果由于网络问题,如果哪些包没有下载成功的话,此时需要进行手动安装。安装步骤如下:
    如以下二进制文件未下载完成则,人工执行命令

    wget https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/linux-amd64-1.4.0/hyperledger-fabric-linux-amd64-1.4.0.tar.gz
    wget https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric-ca/hyperledger-fabric-ca/linux-amd64-1.4.0/hyperledger-fabric-ca-linux-amd64-1.4.0.tar.gz
    
    tar xzvf hyperledger-fabric-linux-amd64-1.4.0.tar.gz -C $GOPATH/src/github.com/hyperledger/fabric-samples/
    tar xzvf hyperledger-fabric-ca-linux-amd64-1.4.0.tar.gz -C $GOPATH/src/github.com/hyperledger/fabric-samples/
    
    #向/etc/profile中写入环境变量
    sudo echo 'export PATH=$GOPATH/src/github.com/hyperledger/fabric-samples/bin:$PATH' >> /etc/profile
    
    #使环境变量生效
    source /etc/profile

如docker相关镜像未下载完成则执行如下命令下载相关镜像。

# 下载Fabric相关镜像(fabric-peer、fabric-orderer、fabric-ccenv、fabric-tools),此处以fabric-peer镜像为例,其他镜像同理
docker pull hyperledger/fabric-peer:1.4.0
docker tag hyperledger/fabric-peer:1.4.0 hyperledger/fabric-peer:latest

# 下载Fabric第三方镜像(fabric-couchdb、fabric-kafka、fabric-zookeeper),此处以fabric-couchdb为例,其他镜像同理
docker pull hyperledger/fabric-couchdb:0.4.14
docker tag hyperledger/fabric-couchdb:0.4.14 hyperledger/fabric-couchdb:latest

# 下载Fabric CA镜像
docker pull hyperledger/fabric-ca:1.4.0
docker tag hyperledger/fabric-ca:1.4.0 hyperledger/fabric-ca:latest
  1. 通过运行Build your first network样例来进行测试、

    cd $GOPATH/src/github.com/hyperledger/fabric-samples/first-network
    # 编译通过Golang开发的chaincode并启动相关的容器
    ./byfn.sh up
    
    ./byfn.sh up -l node
    
    ./byfn.sh up -o kafka
    
    #停止first-network网络中所有的容器,删除crypto材料和4个artifacts(genesis.block、mychannel.block、Org1MSPanchor.tx、Org2MSPanchor.tx)以及chaincode镜像
    ./byfn.sh down

参考资料

  1. Hyperledger Fabric release-1.4 官方手册
  2. docker官方教程(Get Docker CE for Ubuntu)