Hyperledger Fabric1.4.6 环境部署

一 准备工作

命令手册

1.1 Ubuntu

版本：18.04

1.2 go

版本 : 1.14.2

• go 环境变量配置

vim /etc/profile
export GOROOT=/opt/go
export GOPATH=/opt/gocode
export PATH=PATH
export GOBIN=$GOPATH/bin

• 刷新环境变量

source /etc/profile

• 解压 SDK

tar -C /opt/go -xzvf go1.14.2.linux-amd64.tar.gz

1.3 docker

1.3.1 安装Docker-CE

• 卸载旧版本docker

sudo apt-get remove docker docker-engine docker.io

• 添加HTTPS协议，允许apt从HTTPS安装软件包

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common

• 安装GPG证书

curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

• 写入软件源信息

sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

• 更新并安装Docker-CE

sudo apt-get -y update

sudo apt-get -y install docker-ce

• 将当前用户添加到Docker用户组

创建docker用户组

sudo groupadd docker

• 将当前用户添加到docker用户组

sudo usermod -aG docker $USER

• 将docker镜像更改为国内镜像

编辑daemon.json文件，如果没有该文件自行创建

sudo vim /etc/docker/daemon.json

文件中添加以下内容

{
"registry-mirrors":["https://obou6wyb.mirror.aliyuncs.com","https://registry.docker-cn.com","http://hub-mirror.c.163.com"]
}

• 最后重启服务

sudo systemctl daemon-reload

sudo systemctl restart docker

• 查看docker版本，看是否安装成功

docker version

• 执行docker info，如果结果中含有如下内容则说明镜像配置成功

...
 Registry Mirrors:
  https://obou6wyb.mirror.aliyuncs.com/
  https://registry.docker-cn.com/
  http://hub-mirror.c.163.com/
 Live Restore Enabled: false
 ...

1.3.2 安装Docker-Compose

• 方法一：

sudo curl -L https://github.com/docker/compose/releases/download/1.24.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

或

sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.24.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

用方法一下载完后要设置权限

sudo chmod +x /usr/local/bin/docker-compose

• 方法二：

sudo apt-get install python-pip
sudo pip install docker-compose

• 下载完成后查看是否安装成功

docker-compose version

1.3.2 拉取fabric镜像

docker pull hyperledger/fabric-peer:1.4.6
docker pull hyperledger/fabric-tools:1.4.6
docker pull hyperledger/fabric-orderer:1.4.6
docker pull hyperledger/fabric-javaenv:1.4.6
docker pull hyperledger/fabric-ca:1.4.6
docker pull hyperledger/fabric-ccenv:1.4.6
docker pull hyperledger/fabric-zookeeper:0.4.18
docker pull hyperledger/fabric-kafka:0.4.18
docker pull hyperledger/fabric-couchdb:0.4.18
docker pull hyperledger/fabric-baseimage:0.4.18
docker pull hyperledger/fabric-baseos:0.4.18
docker pull hyperledger/fabric-membersrvc:latest 

或者

docker pull hyperledger/fabric-peer:1.4.6 && docker pull hyperledger/fabric-tools:1.4.6 && docker pull hyperledger/fabric-orderer:1.4.6 && docker pull hyperledger/fabric-javaenv:1.4.6 && docker pull hyperledger/fabric-ca:1.4.6 && docker pull hyperledger/fabric-ccenv:1.4.6 && docker pull hyperledger/fabric-zookeeper:0.4.18 && docker pull hyperledger/fabric-kafka:0.4.18 && docker pull hyperledger/fabric-couchdb:0.4.18 && docker pull hyperledger/fabric-baseimage:0.4.18 && docker pull hyperledger/fabric-baseos:0.4.18 && docker pull hyperledger/fabric-membersrvc:latest

• 拉取完镜像镜像后，可以查看docker镜像库

docker images

---

• (可忽略)

为了方便配置Docker Compose，将所有镜像的tag都改为latest,执行如下格式的命令：

docker tag IMAGEID(镜像ID) REPOSITORY:TAG(仓库:标签)

例如:

docker tag 68914607b3a5 docker.io/hyperledger/fabric-tools:latest

将标签全部更改完后，再次查看镜像库

docker images

二 Fabric命令行工具的编译安装

编译安装

2.1 创建目录并下载代码

• 创建hyperledger目录

mkdir -p $GOPATH/src/github.com/hyperledger

cd $GOPATH/src/github.com/hyperledger

• 下载 fabric 源码

git clone https://github.com/hyperledger/fabric

• 下载失败，errno 54的解决方案

sudo git config --global http.postBuffer 5242880000

sudo git config --global https.postBuffer 5242880000

• 或者，从码云上下载

git clone https://gitee.com/mirrors/hyperledger-fabric.git   

2.2 编译Fabric的模块

• 进入到Fabirc源码所在的文件夹

cd $GOPATH/src/github.com/hyperledger/fabric

• 切换分支v1.4.6

git checkout  v1.4.6

编译方式一

make release

• 上述命令执行完成之后，会自动将将编译好的二进制文件存放在以下路径中：

$GOPATH/src/github.com/hyperledger/fabric/==release/linux-amd64/bin==

• 查看版本是否符合

cd $GOPATH/src/github.com/hyperledger/fabric/release/linux-amd64/bin

./peer version

编译方式二

make orderer
make peer
make configtxlator
make certificategen 
make configtxgen

查看 ==.build/bin== 目录

ll .build/bin/

---

• Fabric的模块

模块名称	功能
peer	主节点模块，负责存储区块链数据，运行维护链码
orderer	交易打包、排序模块
certificategen	组织和证书生成模块
configtxgen	区块和交易生成模块
configtxlator	区块和交易解析模块

2.4 Fabric模块的安装

就是将上述模块添加到环境变量里去

• 第一步 Ubuntu和Centos将Fabric模块编译后的文件复制到系统文件夹中

cp $GOPATH/src/github.com/hyperledger/fabric/release/linux-amd64/bin/* /usr/local/bin

• MacOS上面将Fabric模块编译后的文件复制到系统文件夹中的方法如下：

cp $GOPATH/src/github.com/hyperledger/fabric/release/darwin-amd64/bin/* /usr/local/bin

复制成功之后通过以下命令修改文件的执行权限，否则可能无法执行。

sudo chmod -R 775  /usr/local/bin/configtxgen
sudo chmod -R 775  /usr/local/bin/configtxlator
sudo chmod -R 775  /usr/local/bin/certificategen
sudo chmod -R 775  /usr/local/bin/peer
sudo chmod -R 775  /usr/local/bin/orderer

通过上面这些命令之后，可以在系统的任何路径下面运行这些模块了。下面通过一组命令来进检查安装过程是否成功。

• 第二步: 检查安装

采用 version 命令行选项

peer version
orderer version

三 快速启动一个Fabric应用

3.1 第一步：生成组织结构及加密证书

证书等配置文件为crypto-config.yaml

3.1.1 创建存放证书的文件夹

• 将生成的证书文件存放在/var/hyperledger/certificate文件夹下

mkdir -p /var/hyperledger/certificate

3.1.2 证书文件的生成命令

• cryptogen 提供了一个命令可以获取cryptogen模块所需要的配置文件的样式，该命令如下所示：

cryptogen showtemplate

• ==执行如下命令：==

cryptogen generate --config=crypto-config.yaml --output ./crypto-config

该命令执行完成之后我们会发现在文件夹中会新增加一个文件夹crypto-config，里面存放有本例的相关配置文件，可以通过tree命令查看生成证书文件的内容。

org1.binny.com
org2.binny.com

3.1.3 节点域名映射

通过上述步骤所有的证书文件都已经生成完毕，现在需要将测试域名映射到本机的IP地址上面，否则后面的操作可能会出现错误。

执行以下命令以便提取相关的域名，

cd /var/hyperledger/certificate
tree -L 5

使用上述命令就可观察发现，一个orderer 域名和 2 个 peer 域名

• 打开端映射文件，将域名代理为本机

vi /etc/hosts

192.168.23.79 peer0.org1.binny.com
192.168.23.79 peer0.org2.binny.com
192.168.23.79 peer1.org2.binny.com
192.168.23.79 peer1.org1.binny.com
192.168.23.79 orderer.binny.com

orderer.binny.com
peer0.org1.binny.com
peer0.org2.binny.com

输入以上内容之后保存/etc/hosts文件，然后用ping命令测试以下配置是否正确。

ping peer0.org1.binny.com

3.2 第二步 创建orderer 服务，启动创始块的生成

创建服务启动初始区块及应用通道交易配置文件需要指定 Orderer 服务的相关配置以及当前的联盟信息， 这些信息定义在一个名为 configtx.yaml 文件中。

3.2.1 Orderer服务启动初始区块的创建

• ==创建 Orderer 服务启动初始区块==

cd /var/hyperledger/certificate
export set FABRIC_CFG_PATH=/var/hyperledger/certificate

• ==生成创始块文件==

configtxgen -profile TestTwoOrgsOrdererGenesis -outputBlock ./orderer.genesis.block

注意：TestTwoOrgsOrdererGenesis：在配置文件中，orderer.genesis.block：名字随意,但是后续配置文件中要用到

上述命令执行完成之后会在文件夹$GOPATH/src/github.com/hyperledger/certificate中生成文件orderer.genesis.block。这是Fabric系统的创始块文件。

3.2.2 创建必须的应用通道交易配置文件

• 指定通道名称的环境变量,名字随意,==设置临时变量，channel 名字==

export set CHANNEL_NAME=binnychannel

因为我们后面的命令需要多次使用同一个通道名称，所以先指定一个通道名称将其设为环境变量，后期需要使用该通道名称时时只需要使用对应的环境变量名称即可.

---

• ==生成应用通道交易配置文件==

指定使用 configtx.yaml 配置文件中的 TestTwosOrgsChannel 模板, 来生成新建通道的配置交易文件,TestTwosOrgsChannel 模板指定了 Org1 和 Org2 都属于后面新建的应用通道

configtxgen -profile TestTwosOrgsChannel -outputCreateChannelTx ./binnychannel.tx -channelID $CHANNEL_NAME

• ==node-sdk 测试，创建新通道==

configtxgen -profile TestOneOrgsChannel -outputCreateChannelTx ./binnychannel01.tx -channelID binnychannel01

3.2.3 生成锚节点更新配置文件

同样基于 configtx.yaml 配置文件中的 TestTwosOrgsChannel 模板，为每个组织分别生成锚节点更新配置，且注意指定对应的组织名称。

• channelID 要和上面的一样

configtxgen -profile TestTwosOrgsChannel -outputAnchorPeersUpdate ./Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP

configtxgen -profile TestTwosOrgsChannel -outputAnchorPeersUpdate ./Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

上面命令执行完成之后会在相应的文件夹下面生成文件 Org1MSPanchors.tx 和 Org2MSPanchors.tx ，这些文件在后面会被使用到。

3.2.4 Orderer节点的启动

在配置文件orderer.yaml所在的目录执行如下命令启动orderer

orderer start

• 问题：Not bootstrapping because of 2 existing channels

删除目录下的orderer遗留文件

3.3 Peer节点的启动

Please make sure that FABRIC_CFG_PATH is set to a path which contains core.yaml

设置环境变量

export set FABRIC_CFG_PATH=/var/hyperledger/certificate

启动命令

• 在配置文件core.yaml所在的文件夹中执行以下命令启动order节点

peer node start >> log_peer.log 2>&1 &

---

ps axu | grep peer

3.4 创建通道

现在我们可以创建通道，创建通道的过程一共需要三个步骤。

3.4.1 设置环境变量

cd $GOPATH/src/github.com/hyperledger/certificate

export set CHANNEL_NAME=binnychannel
export set CORE_PEER_MSPCONFIGPATH=/var/hyperledger/certificate/crypto-config/peerOrganizations/org1.binny.com/users/[email protected]/msp
export set CORE_PEER_LOCALMSPID=Org1MSP

3.4.2 创建通道

peer channel create -t 50s -o orderer.binny.com:7050 -c $CHANNEL_NAME -f /var/hyperledger/certificate/binnychannel.tx

• -f:指定上次生成的那个文件路径

2020-05-12 01:32:47.537 UTC [channelCmd] InitCmdFactory -> INFO 001 Endorser and orderer connections initialized
2020-05-12 01:32:47.568 UTC [cli.common] readBlock -> INFO 002 Received block: 0

创建通道完成之后，会在执行命令的当前目录生成名为binnychannel.block的通道创始块文件

• 查看已开启的端口

netstat -tupln

---

• ==查看channel.tx和genesis.block内容==

configtxgen -inspectChannelCreateTx binnychannel.tx

configtxgen -inspectBlock genesis.block

---

选项	意义
-o	连接的orderer的地址，hostname:port
-c	channel的名称，默认为mychannel
-f	配置的交易信息（暂时还没搞清楚）
–tls	和orderer通信时是否启用tls
–cafile	使用tls时，所使用的orderer的证书

3.4.3 让已经运行的Peer模块加入通道

export set CORE_PEER_LOCALMSPID=Org1MSP
export set CORE_PEER_ADDRESS=peer0.org1.binny.com:7051
export set CORE_PEER_MSPCONFIGPATH=/var/hyperledger/certificate/crypto-config/peerOrganizations/org1.binny.com/users/[email protected]/msp

peer channel join -b /var/hyperledger/certificate/binnychannel.block

在上述创建通道的命令中-b后面的参数为==上一步==中生成的文件binnychannel.block，需要注意这个文件的路径。

peer channel list

3.4.4 更新锚节点

export set CORE_PEER_LOCALMSPID=Org1MSP
export set CORE_PEER_ADDRESS=peer0.org1.binny.com:7051
export set CORE_PEER_MSPCONFIGPATH=/var/hyperledger/certificate/crypto-config/peerOrganizations/org1.binny.com/users/[email protected]/msp

peer channel update -o orderer.binny.com:7050 -c binnychannel   -f  /var/hyperledger/certificate/Org1MSPanchors.tx

3.5 Chaincode的部署和调用

现在可以部署一个Chaincode（关于Chaincode的详细内容在本书的第七章会有详细的介绍）来测试Peer节点和Orderer节点的部署是否正确。这里采用Fabric源码自带的例子来作为测试Chaincode。测试用Chaincode的源代码路径如下所示：

$GOPATH/src/github.com/hyperledger/fabric-samples/chaincode/chaincode_example02

Chaincode相关的测试一共有四个步骤。

第一步：设置环境变量

export set CORE_PEER_LOCALMSPID=Org1MSP
export set CORE_PEER_ADDRESS=peer0.org1.binny.com:7051
export set CORE_PEER_MSPCONFIGPATH=/var/hyperledger/certificate/crypto-config/peerOrganizations/org1.binny.com/users/[email protected]/msp

第二步： 部署chaincode代码

• ==使用的chaincode的位置如下==：

$GOPATH/src/github.com/hyperledger/fabric/examples/chaincode/go/example02/cmd

---

• ==安装部署==

peer chaincode install -n binny_test_01 -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/example02/cmd

2020-05-12 07:21:24.559 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 001 Using default escc
2020-05-12 07:21:24.559 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 002 Using default vscc
2020-05-12 07:21:25.482 UTC [chaincodeCmd] install -> INFO 003 Installed remotely response: 

• == 可以通过下面命令查看 chaincode的安装信息==

peer chaincode list --installed  

---

第三步： 实例化chaincode代码

• 执行下面的步骤，需要系统中已安装 docker

export set CHANNEL_NAME=binnychannel

---

peer chaincode instantiate -o orderer.binny.com:7050 -C $CHANNEL_NAME -n binny_test_01 -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "OR('Org1MSP.member','Org2MSP.member')"

第四步：通过chaincode写入数据

• ==设置临时变量，channel 名字==

export set CHANNEL_NAME=binnychannel
export set CORE_PEER_LOCALMSPID=Org1MSP

export set CORE_PEER_ADDRESS=peer0.org1.binny.com:7051
export set CORE_PEER_MSPCONFIGPATH=/var/hyperledger/certificate/crypto-config/peerOrganizations/org1.binny.com/users/[email protected]/msp

---

peer chaincode invoke -o orderer.binny.com:7050 -C $CHANNEL_NAME -n binny_test_01 -c '{"Args":["invoke","a","b","1"]}'

第五步：通过chaincode查询数据

export set CORE_PEER_LOCALMSPID=Org1MSP
export set CORE_PEER_ADDRESS=peer0.org1.binny.com:7051
export set CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/certificate/certificate-config/peerOrganizations/org1.binny.com/users/[email protected]/msp

---

peer chaincode query -C $CHANNEL_NAME -n binny_test_01 -c '{"Args":["query","a"]}'

peer chaincode query -C $CHANNEL_NAME -n binny_test_01 -c '{"Args":["query","b"]}'

如果上述命令都能正确执行，那么一个简单的Fabric系统就已经部署完成了。

五 自定义 chaincode

将写好的 chaincode 同步到节点服务器上

5.1 调试模式（IDE中设置）

• 设置参数

-peer.address=192.168.35.131:7052

• 配置环境变量

CORE_PEER_ADDRESS=192.168.35.131:7051
CORE_CHAINCODE_ID_NAME=helloworld_1222:1.0//chaincode名字：版本号
CORE_CHAINCODE_LOGGING_LEVEL=debug
CORE_CHAINCODE_LOGGING_SHIM=debug

5.2 进入节点服务

5.2.1 设置环境变量

• 设置 MSP

export set CORE_PEER_LOCALMSPID=Org1MSP

• 设置证书路径

export set CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/certificate/crypto-config/peerOrganizations/org1.binny.com/users/[email protected]/msp

• 设置 core.yaml所在路径

export set FABRIC_CFG_PATH=$GOPATH/src/github.com/hyperledger/certificate

• 设置一个节点地址

export set CORE_PEER_ADDRESS=peer0.org1.binny.com:7051

• 设置日志级别

export set FABRIC_LOGGING_SPEC=DEBUG

• 设置日志级别

export set CORE_LOGGING_LEVEL=DEBUG

5.2.2 打包 chaincode

在以上环境变量的基础上执行下列代码，将指定的链码打包为CDS（Chaincode Deployment Spec）格式，并存入节点上指定的路径。

peer chaincode install -n helloworld_1222 -v 1.0 -p chaincode

• ==选项说明:==
• --connectionProfile Connection profile that provides the necessary connection information for the network. Note: currently only supported for providing peer connection information
• -c, --ctor Constructor message for the chaincode in JSON format (default "{}")
• -h, --help help for install
• -l, --lang Language of chaincode, either "golang" (default), "node", or "java"
• -n, --name Name of the chaincode
• -p, --path Path to chaincode, for "golang" use relative path from $GOPATH/src, for "node" or "java" use absolute path
• -v, --version Version of the chaincode specified in install/instantiate/upgrade commands

---

• 查看一下

peer chaincode list --installed

• 输出结果

Get installed chaincodes on peer:
Name: binny_test_01, Version: 1.0, Path: github.com/hyperledger/fabric/examples/chaincode/go/example02/cmd, Id: c405e9d12c9adc4a8773786de35bababed8d41ca8242d00ba402d932d934805e
Name: helloworld_1222, Version: 1.0, Path: fabric_cc_study/1.4.6/binny, Id: 6f9b8c6fff1951402b97ef685741aba144af89f0ab026ad0a31d0d1ce5e73f20

5.2.3 将指定的链码部署到网络上。

执行下面命令会调用 Init方法

peer chaincode instantiate -o orderer.binny.com:7050 -C binnychannel -n helloworld_1222 -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "OR ('Org1MSP.member','Org2MSP.member')"

• 执行以下命名，查看一下

peer chaincode list --instantiated -C binnychannel

5.2.4 调用指定给的链码，并初始化参数

• 调用 set 方法

peer chaincode invoke -o orderer.binny.com:7050  --waitForEvent -C binnychannel -n helloworld_1222  -c '{"Args":["set","name","徐耀，曹欢","fabric--2019-12-22"]}'

• 调用get方法

peer chaincode query -C binnychannel -n helloworld_1222 -c '{"Args":["get","name","参数 2","参数3"]}'

5.2.5 调用get方法

获取并显示链码函数调用的背书结果。该命令不会生成交易。

peer chaincode query -C binnychannel -n helloworld_1222 -c '{"Args":["get","get","key1222","chaincode v 1.5 = query11111"]}'