五、区块链学习-Hyperledger Fabric 官方示例FirstNetwork搭建
这篇文章搭建fabric-samples示例网络环境。中间会遇到很多的问题。如果有可以补充的欢迎评论添加！
目前先基于release-1.0版本做实验，因为这个版本的资料比较多。
1、docker 镜像准备
为了搭建第一个网络环境 需要准备如下的docker镜像
REPOSITORY TAG IMAGE ID CREATED SIZE
hyperledger/fabric-tools x86_64-1.0.0 0403fd1c72c7 2 years ago 1.32GB
hyperledger/fabric-orderer x86_64-1.0.0 e317ca5638ba 2 years ago 179MB
hyperledger/fabric-peer x86_64-1.0.0 6830dcd7b9b5 2 years ago 182MB
hyperledger/fabric-ca x86_64-1.0.0 a15c59ecda5b 2 years ago 238MB
hyperledger/fabric-baseos x86_64-0.3.1 4b0cab202084 2 years ago 157MB
以hyperledger/fabric-peer镜像为例，使用docker pull命令来拉取镜像
docker pull hyperledger/fabric-ca:x86_64-1.0.0
其他的几个镜像也是这样拉取
因为现在是基于1.0版本的项目来启动的 所以用到的是一下几个镜像（注意版本 为 x86_64-1.0.0）但是当容器启动时 默认会使用 latest 版本镜像，如果没有就会下载镜像启动。由于版本不一致了 所以会报错
!!! Query result on PEER0 is INVALID !!!
================== ERROR !!! FAILED to execute End-2-End Scenario ==================
为了避免这个错误。用docker 的tag命令 将镜像重新命名一个latest 使用一下命令
docker tag hyperledger/fabric-tools:x86_64-1.0.0 hyperledger/fabric-tools:latest
docker tag hyperledger/fabric-orderer:x86_64-1.0.0 hyperledger/fabric-orderer:latest
docker tag hyperledger/fabric-peer:x86_64-1.0.0 hyperledger/fabric-peer:latest
docker tag hyperledger/fabric-ca:x86_64-1.0.0 hyperledger/fabric-ca:latest
再次查看docker images 就能看到tag 为 latest的镜像了 但是 imageId 与 之前 x86_64-1.0.0版本的一致
hyperledger/fabric-tools latest 0403fd1c72c7 2 years ago 1.32GB
hyperledger/fabric-tools x86_64-1.0.0 0403fd1c72c7 2 years ago 1.32GB
hyperledger/fabric-orderer latest e317ca5638ba 2 years ago 179MB
hyperledger/fabric-orderer x86_64-1.0.0 e317ca5638ba 2 years ago 179MB
hyperledger/fabric-peer latest 6830dcd7b9b5 2 years ago 182MB
hyperledger/fabric-peer x86_64-1.0.0 6830dcd7b9b5 2 years ago 182MB
hyperledger/fabric-ca latest a15c59ecda5b 2 years ago 238MB
hyperledger/fabric-ca x86_64-1.0.0 a15c59ecda5b 2 years ago 238MB
2、源码获取
2.1 获取Hyperledger Fabric源码
源码地址：Fabric源码（GitHup）
执行clone命令获取源码
git clone https://github.com/hyperledger/fabric.git
2.2 获取fabric-samples源码
源码地址：fabric-samples源码（GitHup）
执行Clone命令获取源码
git clone https://github.com/hyperledger/fabric-samples.git
2.3 切换代码版本到release-1.0
通过不中2.2获取到源码,因为要基于release-1.0版本来搭建，所以需要将源码切换到release-1.0的分支上
请先备份代码
切换fabric分支
cd ~/fabric
git checkout release-1.0
切换fabric-samples分支
cd ~/fabric-samples
git checkout release-1.0
3 、编译需要用到的两个插件
3.1 准备工作
因为go语言在安装组件时会用到其他的依赖包，依赖包的查找是 先找$GOROOT路径再找 $GOPATH 所以需要将下载好的源码移动路径到 $GOPATH路径下
所以现在的源码路径为
$GOPATH/src/github.com/hyperledger/fabric
$GOPATH/src/github.com/hyperledger/fabric-samples
3.2 编译configtxgen组件 用于创世区块以及通道配置
进入到configtxgen文件目录下
cd $GOPATH/src/github.com/hyperledger/fabric/common/configtx/tool/configtxgen
执行
go install
3.3 编译cryptogen组件 用于生成证书
进入到cryptogen目录下
cd $GOPATH/src/github.com/hyperledger/fabric/common/tools/cryptogen
执行
go install
3.4 可能会出现的错误
------------------------------------------------------------------------------------
go build github . com / hyperledger / fabric / vendor / github . com / miek / pkcsll : invalid flag in # cgo LDFLAGS : - I / usr / ocal / share / Libtool
解决方法：go install --tags=nopkcs11
------------------------------------------------------------------------------------
main.go:27:2: cannot find package "gopkg.in/alecthomas/kingpin.v2" in any of:
解决方法: go get gopkg.in/alecthomas/kingpin.v2
------------------------------------------------------------------------------------
main.go:25:2: cannot find package "gopkg.in/yaml.v2" in any of:
解决放方法: go get gopkg.in/yaml.v2
------------------------------------------------------------------------------------
go install: no install location for directory /Users/lh0811/Desktop/lh-starter/hyperledger/fabric/common/configtx/tool/configtxgen outside GOPATH For more details see: 'go help gopath'
解决方法：
vi ~/.bash_profile 添加
export GOROOT="/usr/local/Cellar/go/1.12.9/libexec"
export GOPATH="/Users/lh0811/go"
export GOBIN=$GOPATH/bin
export PATH=$PATH:$GOBIN
然后 source ~/.bash_profile
------------------------------------------------------------------------------------
3.5 验证两个工具是否编译成功
两个工具都会安装到 $GOPATH/bin目录下
cd $GOPATH/bin
ls
输出：
configtxgen cryptogen
4、first-network 目录结构
先看first-network项目的目录结构
drwxr-xr-x 13 lh0811 staff 416 2 10 19:59 .
drwxr-xr-x 15 lh0811 staff 480 2 10 19:59 ..
-rw-r--r-- 1 lh0811 staff 42 2 10 15:38 .env //项目环境配置
-rw-r--r-- 1 lh0811 staff 335 2 10 15:38 README.md
drwxr-xr-x 4 lh0811 staff 128 2 10 19:59 base //docker compose 的公共服务
-rwxr-xr-x 1 lh0811 staff 15108 2 10 19:59 byfn.sh //启动脚本
drwxr-xr-x 3 lh0811 staff 96 2 10 15:38 channel-artifacts
-rw-r--r-- 1 lh0811 staff 5013 2 10 19:59 configtx.yaml //之前configtxgen 工具 根据该配置 生成配置文件
-rw-r--r-- 1 lh0811 staff 3858 2 10 19:59 crypto-config.yaml //之前cryptogen 工具 更加该配置 生成配置文件
-rw-r--r-- 1 lh0811 staff 3015 2 10 19:59 docker-compose-cli.yaml // docker compose 启动网络配置脚本
-rw-r--r-- 1 lh0811 staff 4604 2 10 19:59 docker-compose-couch.yaml // docker compose 启动网络配置脚本
-rw-r--r-- 1 lh0811 staff 2883 2 10 15:38 docker-compose-e2e-template.yaml // docker compose 启动网络配置脚本
drwxr-xr-x 3 lh0811 staff 96 2 10 19:59 scripts // 提供测试 fabric的一下脚本
目录中的byfn.sh 为该项目的启动脚本
启动脚本 提供的功能
byfn.sh -h
byfn.sh -m up|down|restart|generate [-c <channel name>] [-t <timeout>] [-d <delay>] [-f <docker-compose-file>] [-s <dbtype>] [-i <imagetag>]
byfn.sh -h|--help (print this message)
-m <mode> - one of 'up', 'down', 'restart' or 'generate'
- 'up' - bring up the network with docker-compose up 启动docker-compose 网络
- 'down' - clear the network with docker-compose down 关闭docker-compose 网络
- 'restart' - restart the network 重启docker-compose 网络
- 'generate' - generate required certificates and genesis block 生成第一个创世区块
-c <channel name> - channel name to use (defaults to "mychannel") channel的名称 默认是mychannel
-t <timeout> - CLI timeout duration in microseconds (defaults to 10000) cli超时时间 默认10000ms
-d <delay> - delay duration in seconds (defaults to 3)
-f <docker-compose-file> - specify which docker-compose file use (defaults to docker-compose-cli.yaml)
-s <dbtype> - the database backend to use: goleveldb (default) or couchdb 数据库引擎选择 一般使用默认的goleveldb
-i <imagetag> - pass the image tag to launch the network using the tag: 1.0.1, 1.0.2, 1.0.3, 1.0.4 (defaults to latest) 指定启动images版本
Typically, one would first generate the required certificates and genesis block, then bring up the network. e.g.:
通常，首先生成所需的证书和genesis块，然后启动网络。
一般使用如下的方法来测试
byfn.sh -m generate -c mychannel // 先生成相关证书和配置文件使用之前编译的组件 -c 是指定channel名称，默认就是mychannel
byfn.sh -m up -c mychannel -s couchdb // 启动网络 一般使用默认的数据库引擎 所以一般不写-s
byfn.sh -m up -c mychannel -s couchdb -i 1.0.6 // -i 是指定镜像版本启动，尝试过 会失败 所以还是修改精选tag到laster
byfn.sh -m down -c mychannel // 关闭网络 这一步会删掉生成的docker 容器
如果不需要特殊的配置 用一下的三个命令就够了 也就是默认的配置
Taking all defaults:
byfn.sh -m generate
byfn.sh -m up
byfn.sh -m down
4、生成所需配置文件
按照byfn.sh -h提供的帮助文档。
进入first-network目录
cd $GOPATH/src/github.com/hyperledger/fabric-samples/first-network
执行生成证书和配置文件的命令
./byfn.sh -m generate
输出
#询问客户端超时时间
Generating certs and genesis block for with channel 'mychannel' and CLI timeout of '10' Continue (y/n)? y
键入y继续
输出相关证书生产过程
##########################################################
##### Generate certificates using cryptogen tool #########
##### 生成证书使用cryptogen工具 #########
##########################################################
org1.example.com #组织1
org2.example.com #组织2
/Users/lh0811/go/bin/configtxgen #使用之前编译好的工具 生成 创世区块 以及通道配置
##########################################################
######### Generating Orderer Genesis block ##############
######### 生成创世区块 ##############
##########################################################
2020-02-10 21:10:24.817 CST [common/configtx/tool] main -> INFO 001 Loading configuration
2020-02-10 21:10:24.846 CST [common/configtx/tool] doOutputBlock -> INFO 002 Generating genesis block
2020-02-10 21:10:24.849 CST [common/configtx/tool] doOutputBlock -> INFO 003 Writing genesis block
# 生成 创世区块
#################################################################
### Generating channel configuration transaction 'channel.tx' ###
### 生成 channel并写入到 'channel.tx' 文件###
#################################################################
2020-02-10 21:10:24.893 CST [common/configtx/tool] main -> INFO 001 Loading configuration
2020-02-10 21:10:24.898 CST [common/configtx/tool] doOutputChannelCreateTx -> INFO 002 Generating new channel configtx
2020-02-10 21:10:24.899 CST [common/configtx/tool] doOutputChannelCreateTx -> INFO 003 Writing new channel tx
# 生成channel 并写入channel配置
#################################################################
####### Generating anchor peer update for Org1MSP ##########
####### 生成Org1MSP的锚节点 ##########
#################################################################
2020-02-10 21:10:24.940 CST [common/configtx/tool] main -> INFO 001 Loading configuration
2020-02-10 21:10:24.944 CST [common/configtx/tool] doOutputAnchorPeersUpdate -> INFO 002 Generating anchor peer update
2020-02-10 21:10:24.944 CST [common/configtx/tool] doOutputAnchorPeersUpdate -> INFO 003 Writing anchor peer update
# 生成组织1 的锚节点
#################################################################
####### Generating anchor peer update for Org2MSP ##########
####### 生成Org2MSP的锚节点 ##########
#################################################################
2020-02-10 21:10:24.974 CST [common/configtx/tool] main -> INFO 001 Loading configuration
2020-02-10 21:10:24.977 CST [common/configtx/tool] doOutputAnchorPeersUpdate -> INFO 002 Generating anchor peer update
2020-02-10 21:10:24.977 CST [common/configtx/tool] doOutputAnchorPeersUpdate -> INFO 003 Writing anchor peer update
# 生成组织2 的锚节点
查看生成的文件
channel-artifacts 文件夹下保存了channel配置 创世区块信息 以及两个组织的锚节点信息
crypto-config 文件夹下生成了两个配置文件夹 保存了其生成的证书文件
crypto-config/ordererOrganizations:
crypto-config/peerOrganizations:
5、docker 启动First NetWork
按照byfn.sh -h提供的帮助文档。
进入first-network目录
cd $GOPATH/src/github.com/hyperledger/fabric-samples/first-network
执行生成启动网络命令
./byfn.sh -m up
#询问客户端超时时间
Generating certs and genesis block for with channel 'mychannel' and CLI timeout of '10' Continue (y/n)? y
键入y继续
输出相关日志
出现一下日志 则是节点启动完成
========= All GOOD, BYFN execution completed ===========
_____ _ _ ____
| ____| | \ | | | _ \
| _| | \| | | | | |
| |___ | |\ | | |_| |
|_____| |_| \_| |____/
查看docker容器
docker ps
会看到docker-compose 启动的容器列表
6、关闭网络
按照byfn.sh -h提供的帮助文档。
进入first-network目录
cd $GOPATH/src/github.com/hyperledger/fabric-samples/first-network
执行关闭网络命令
./byfn.sh -m down
再次查看docker 容器
docker ps -a
所有的容器都删除了
