【學習筆記】基于Ubuntu構建Hyperledger Fabric網絡

前言

本人參考連接搭建Fabric網絡，遇到了一些坑，故此有了本篇文章。

準備好機器環(huán)境

我的系統版本：Ubuntu 18.04.1 LTS

安裝GO語言環(huán)境

$ cd ~
$ mkdir go

對于新手來說，不推薦使用apt的方式安裝GO。

$ wget https://dl.google.com/go/go1.10.2.linux-amd64.tar.gz  
$ sudo tar -C usr/local -xzf go1.10.2.linux-amd64.tar.gz  
$ vim ~/.profile

添加如下內容：

export PATH=$PATH:/usr/local/go/bin
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$HOME/go/bin

用:wq保存后使用如下命令將立即刷新

$ source ~/.profile
$ go version
go version go1.10 linux/amd64

安裝Docker

這里使用的Docker的官方文檔來安裝docker

  • 如果系統中有舊版本的Docker,需要先使用如下命令卸載
  • 更新apt包索引
  • 安裝軟件包以允許apt通過HTTPS使用遠程庫
  • 添加Docker的官方GPG密鑰
  • 通過搜索指紋的最后8個字符，確認您現在擁有指紋識別碼9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
  • 置穩(wěn)定版本的遠程庫
  • 再次更新apt包索引
  • 使用apt安裝docker-ce 
$ sudo apt-get remove docker docker-engine docker.io
$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
$ curl -fsSL [https://download.docker.com/linux/ubuntu/gpg](https://download.docker.com/linux/ubuntu/gpg) | sudo apt-key add -
$ sudo apt-key fingerprint 0EBFCD88
pub   rsa4096 2017-02-22 [SCEA]
      9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid           [ unknown] Docker Release (CE deb) <docker@docker.com>
sub   rsa4096 2017-02-22 [S]
$ 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版本，測試環(huán)境配置是否成功
$ docker version
Client:
 Version:           18.06.1-ce
 API version:       1.38
 Go version:        go1.10.3
 Git commit:        e68fc7a
 Built:             Tue Aug 21 17:24:56 2018
 OS/Arch:           linux/amd64
 Experimental:      false

Server:
 Engine:
  Version:          18.06.1-ce
  API version:      1.38 (minimum version 1.12)
  Go version:       go1.10.3
  Git commit:       e68fc7a
  Built:            Tue Aug 21 17:23:21 2018
  OS/Arch:          linux/amd64
  Experimental:     false
  • 安裝完成之后，需要將當前用戶添加到docker用戶組，然后為該用戶添加sudo權限，
  • 若沒有創(chuàng)建docker用戶組，可以使用如下命令創(chuàng)建一個GID為999，組名為docker的用戶組
  • 將當前用戶(ubuntu)添加到docker用戶組并分配sudo權限
$ sudo groupadd –g 999 docker
$ sudo usermod -aG docker ubuntu

安裝Docker-Compose

  • Docker-Compose是支持通過模板腳本批量創(chuàng)建的一個組件
  • 在安裝 Docker-Compose之前，需要安裝python-pip
  • 下載 Docker-Compose，這里使用的是國內的DaoClound加速器進行下載
  • 將Docker-Compose文件夾移動到/usr/local/bin目錄下
  • 為Docker-Compose附上可執(zhí)行權限
$ sudo apt-get python-pip
$ curl -L https://get.daocloud.io/docker/compose/releases/download/1.12.0/docker-compose-`uname -s`-`uname -m` > ~/docker-compose
$ sudo mv ~/docker-compose /usr/local/bin/docker-compose
$ chmod +x /usr/local/bin/docker-compose

下載Fabric源碼

  • 先在GOPATH下創(chuàng)建對應的目錄
  • 切換到對應目錄
  • 使用Git命令將fabric的源碼從github上克隆下來
  • 由于Fabric一直在更新，而我們并不需要使用最新的源碼，所有將版本切換到v1.0.0 
$ mkdir -p ~/go/src/github.com/hyperledger
$ cd ~/go/src/github.com/hyperledger
$ git clone [https://github.com/hyperledger/fabric.git](https://github.com/hyperledger/fabric.git)
$ cd ~/go/src/github.com/hyperledger/fabric
$ git checkout -b v1.0.0

下載Fabric Docker鏡像

由于剛才設置了Docker Hub鏡像的地址，并且官方文件中也提供了批量下載的腳本，所有我們只需運行下面命令即可

$ cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
$ source download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0

由于剛才設置的是國內的鏡像站，在本地網速還不錯的情況下下載數度還是很快的。當下載完成后，使用如下命令檢查鏡像列表

$ docker images
REPOSITORY                              TAG                IMAGE ID            CREATED            SIZE
dev-peer0.org1.example.com-marbles-v4  latest              089d43e100c9        5 hours ago        173MB
dev-peer0.org1.example.com-fabcar-1.0  latest              6047921ee993        7 hours ago        173MB
hyperledger/fabric-tools                latest              0403fd1c72c7        10 months ago      1.32GB
hyperledger/fabric-tools                x86_64-1.0.0        0403fd1c72c7        10 months ago      1.32GB
hyperledger/fabric-couchdb              latest              2fbdbf3ab945        10 months ago      1.48GB
hyperledger/fabric-couchdb              x86_64-1.0.0        2fbdbf3ab945        10 months ago      1.48GB
hyperledger/fabric-kafka                latest              dbd3f94de4b5        10 months ago      1.3GB
hyperledger/fabric-kafka                x86_64-1.0.0        dbd3f94de4b5        10 months ago      1.3GB
hyperledger/fabric-zookeeper            latest              e545dbf1c6af        10 months ago      1.31GB
hyperledger/fabric-zookeeper            x86_64-1.0.0        e545dbf1c6af        10 months ago      1.31GB
hyperledger/fabric-orderer              latest              e317ca5638ba        10 months ago      179MB
hyperledger/fabric-orderer              x86_64-1.0.0        e317ca5638ba        10 months ago      179MB
hyperledger/fabric-peer                latest              6830dcd7b9b5        10 months ago      182MB
hyperledger/fabric-peer                x86_64-1.0.0        6830dcd7b9b5        10 months ago      182MB
hyperledger/fabric-javaenv              latest              8948126f0935        10 months ago      1.42GB
hyperledger/fabric-javaenv              x86_64-1.0.0        8948126f0935        10 months ago      1.42GB
hyperledger/fabric-ccenv                latest              7182c260a5ca        10 months ago      1.29GB
hyperledger/fabric-ccenv                x86_64-1.0.0        7182c260a5ca        10 months ago      1.29GB
hyperledger/fabric-ca                  latest              a15c59ecda5b        10 months ago      238MB
hyperledger/fabric-ca                  x86_64-1.0.0        a15c59ecda5b        10 months ago      238MB
hyperledger/fabric-baseos              x86_64-0.3.1        4b0cab202084        12 months ago      157MB

出現以上結果說明鏡像已經下載成功

啟動Fabric網絡并運行e2e_cli項目

  • 進入e2e_cli目錄，并執(zhí)行啟動命令
$ cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
$ ./network_setup.sh up

這個過程做了如下操作：

  • 編譯生成Fabric公私鑰，證書的程序，程序在目錄：fabric/release/linux-amd64/bin下
  • 基于configtx.yaml生成創(chuàng)世區(qū)塊和通道相關信息，并保存到channel-artifacts文件夾中
  • 基于crypto-config.yaml生成公私鑰和證書信息，并保存在crypto-config文件夾中
  • 基于docker-compose-cli.yaml啟動1 Orderer + 4 Peer + 1 CLI的Fabric容器
  • 在CLI啟動的時候，會運行srcipt/script.sh文件，這個腳本文件包含了創(chuàng)建Channel,加入Channel，安裝Example02,運行Example02等功能

最后運行完成，我們會看到如下截圖，說明網絡啟動成功了
mark

HYPERLEDGER FABRIC網絡搭建之network e2ecli_default not found
原因是：e2e_cli目錄是固定的，啟動后會創(chuàng)建一個docker network以此為名字，這里是e2e_cli。如果修改該目錄，要修改/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/base目錄下的peer-base.yaml將網絡名改成如下名稱即可- CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=e2e_cli_default

手動測試一下Fabric網絡

我們以安裝好的Example02進行測試,在官方例子中，channel的名字是mychannel,鏈碼的名字是mycc,我們首先重新打開一個命令行，然后進入CLI，

  • 輸入以下命令即可
  • 運行命令查詢a賬戶的余額，可以看到a賬戶的余額現在是90
  • 運行命令查詢b賬戶的余額，可以看到b賬戶的余額現在是210
  • 現在將b賬戶的余額轉100給a賬戶
  • 再次查詢a賬戶的余額，可以看到a賬戶的余額現在是190,比之前多了100
  • 再次查詢b賬戶的余額，可以看到b賬戶的余額現在是110,比之前少了100

root@60dc5766fa4d:/opt/gopath/src/github.com/hyperledger/fabric/peer# 簡寫為 root***peer#

$ docker exec -it cli bash
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","b"]}'
root***peer# peer chaincode invoke -o orderer.example.com:7050  --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem  -C mychannel -n mycc -c '{"Args":["invoke","b","a","100"]}'
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","b"]}'

查詢結果如下圖所示
mark

查詢結果如下圖所示
mark

執(zhí)行結果如下圖所示
mark

查詢結果如下圖所示
mark

查詢結果如下圖所示
mark

關閉區(qū)塊鏈網絡

  • 退出CLI容器
  • 關閉Fabric網絡
root@60dc5766fa4d:/opt/gopath/src/github.com/hyperledger/fabric/peer#  exit
$ cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli
$ ./network_setup.sh down

最后出現如下圖說明關閉區(qū)塊鏈網絡成功
mark
最后編輯于 ：
?著作權歸作者所有,轉載或內容合作請聯系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成，瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發(fā)布，文章內容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容