hyperledger fabric 1.4 單機安裝教程

Fabric v1.4.0單機安裝部署

1、前期準備

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

2、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)