上一篇文章《Fabric2.0学习进阶——镜像部署网络(二)》介绍了如何经过fabric-sample自带的脚本byfn.sh来启动first-network网络。为了弄清楚Fabric网络的启动过程,本节经过二进制可执行程序完成Fabric的自定义启动。php
本节规划Fabric平台由3个order节点,2个组织,4个peer节点组成,每一个组织两个peer节点。Fabric2.0的共识机制只支持raft协议,该协议实现的共识必须至少3个节点,节点数最好为奇数。java
本节全部操做均在/usr/local/src/hyperleger/fabric/scripts/fabric-samples/first-network目录执行。git
进行后续操做以前,先设置好相关的环境变量。github
export PATH=${PWD}/../bin:${PWD}:$PATH export FABRIC_CFG_PATH=${PWD}
Fabric平台是许可区块链平台,经过数字证书实现平台参与者对平台资源的访问操做权限,使网络具有更高的安全性。docker
证书生成须要使用cryptogen工具以及配置文件crypto-config.yaml。根据平台的节点规划,修改(记得备份)crypto-config.yaml以下:安全
上图中,Order组织定义了三个节点:orderer,orderer2,orderer3,peer组织包括Org1和Org2两个组织,每一个组织包括2个节点,包括Admin用户和1个普通用户。bash
配置文件修改完成以后,直接运行以下命令完成order节点、peer节点、管理员和用户的证书生成。网络
cryptogen generate --config=./crypto-config.yaml
成功执行以后,当前目录下将生成crypto-config目录,目录结构以下图所示:工具
创世区块的生成须要使用configtxgen工具以及配置文件configtx.yaml。根据平台的节点规划,修改(记得备份)内容以下:学习
将orderer4和orderer5相关的配置注释,由于本文规划的fabric网络只包含3个order节点。
配置文件修改完成以后,执行以下命令:
configtxgen -profile SampleMultiNodeEtcdRaft -channelID byfn-sys-channel -outputBlock ./channel-artifacts/genesis.block
成功执行以后,channel-artifacts目录下将生成创世区块文件genesis.block。
对于创世区块的生成,fabric1.x与fabric2.0有明显的区别,注意上述命令profile参数值。
通道交易配置文件的生成,fabric1.x与fabric2.0无明显区别,所使用命令和配置文件与生成创世区块使用的相同。
执行以下命令,完成通道交易配置文件的建立。
configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychannel
成功执行以后,channel-artifacts目录下将生成通道交易配置文件channel.tx。
锚节点配置文件的生成,fabric1.x与fabric2.0无明显区别,所使用命令和配置文件与生成创世区块使用的相同。
执行以下命令,完成Org1和Org2两个组织锚节点配置文件的建立。
# 生成Org1的锚节点配置文件 configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID mychannel -asOrg Org1MSP # 生成Org2的锚节点配置文件 configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID mychannel -asOrg Org2MSP
成功执行以后,channel-artifacts目录下将生成两个锚节点配置文件Org1MSPanchors.tx和Org2MSPanchors.tx。
Fabric网络服务以docker方式启动,涉及命令docker-compose和配置文件docker-compose-cli.yaml、docker-compose-etcdraft2.yaml、docker-compose-ca.yaml。
本文规划的fabric网络包括10个docker服务:4个peer节点服务,3个order节点服务,2个CA服务,1个cli服务。
修改配置文件docker-compose-etcdraft2.yaml,注释掉orderer4和orderer5的相关配置。
执行以下命令,将启动3个order节点服务,1个cli节点服务,4个peer节点服务和2个CA节点服务。
# 配置环境变量,CA节点必需 export BYFN_CA1_PRIVATE_KEY=$(cd crypto-config/peerOrganizations/org1.example.com/ca && ls \*_sk) export BYFN_CA2_PRIVATE_KEY=$(cd crypto-config/peerOrganizations/org2.example.com/ca && ls \*_sk) # 根据指定配置文件启动容器服务 docker-compose -f docker-compose-cli.yaml -f docker-compose-etcdraft2.yaml -f docker-compose-ca.yaml up -d
命令执行日志以下图所示:
查看运行的docker服务,以下图所示:
中止网络执行命令:
docker-compose -f docker-compose-cli.yaml -f docker-compose-etcdraft2.yaml -f docker-compose-ca.yaml down
Fabric平台全部节点服务均正常启动,3.1节-3.4节生成的配置文件都是为后续的交易操做而准备的,后续的操做均需进入cli容器执行相关命令。
通道是Fabric的特性,能够在一个区块链平台上实现业务隔离,从逻辑上实现多链操做。
建立通道须要先进入cli容器,执行以下命令:
#链接cli服务 docker exec -it cli bash #定义CA文件路径 ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem #建立通道信息 peer channel create -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/channel.tx --tls true --cafile $ORDERER_CA #将生成的文件移动到channel-artifacts文件夹中 mv mychannel.block channel-artifacts/
上一步咱们建立了一个名称为mychannel的通道,但该通道尚未任何peer节点加入,则没法进行交易操做,本节将2个组织的4个节点都加入到mychannel通道。
经过查看环境变量,当前cli容器使用的org1.peer0的配置。
按照当前的配置,咱们执行以下命令,先将org1.peer0节点加入mychannel通道。
peer channel join -b channel-artifacts/mychannel.block
执行成功结果以下图所示:
切换节点,将org1.peer1加入mychannel通道。
#切换节点org1.peer1 source scripts/utils.sh setGlobals 1 1 # 将当前节点加入通道 peer channel join -b channel-artifacts/mychannel.block
参照上述切换节点的方法,将org2组织的两个节点也加入通道。
#切换节点org2.peer0 source scripts/utils.sh setGlobals 0 2 # 将当前节点加入通道 peer channel join -b channel-artifacts/mychannel.block #切换节点org2.peer1 setGlobals 1 2 # 将当前节点加入通道 peer channel join -b channel-artifacts/mychannel.block
至此,2个组织的4个节点均已加入mychannel通道。
锚节点是组织内的一种特殊peer节点,经过锚节点能够实现不一样组织内节点间的通讯。一般每次组织都要设置一个锚节点,下面分别对org1和org2两个组织设置锚节点,本文假设将组织中的peer0节点设置为锚节点。
#切换到org1.peer0节点 setGlobals 0 1 #设置环境变量ORDERER_CA ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem #更新设置锚节点 peer channel update -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/Org2MSPanchors.tx --tls true --cafile $ORDERER_CA #切换到org2.peer0节点 setGlobals 0 2 #设置环境变量ORDERER_CA ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem #更新设置锚节点 peer channel update -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/Org2MSPanchors.tx --tls true --cafile $ORDERER_CA
更新命令执行成功结果以下图所示:
通过咱们的努力,咱们手动配置并启动了一个fabric网络,包含3个orderer节点,2个组织4个peer节点,2个ca节点,1个cli节点,1个通道mychannel,后续文章将基于该网络进行链码操做。
文章做者:xiaohui249
本文连接:http://javatech.wang/index.ph...版本全部 ©转载时必须以连接形式注明做者和原始出处