海安零距离 海安论坛 海安新闻 海安

 找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
查看: 2023|回复: 0

区块链学习——HyperLedger-Fabric v1.0 启动过程分析

[复制链接]

6234

主题

6234

帖子

1万

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
18716
发表于 2019-12-27 14:02 | 显示全部楼层 |阅读模式
本章我们从fabric v1.0的e2e_cli示例开始分析整个启动过程以及在过程中的一些设置文件
起首呢,照旧确保你的根本情况已经搭建完成,v1.0源码和镜像也都下载完毕
fabric启动过程中的相干脚本文件剖析

network_setup.sh脚本文件

在源码目录下的network_setup.sh文件是官方提供的快速摆设测试的一个主动化脚本,接下来我们看一下在启动这个文件时都做了什么:

在上图中我们只是截取了启动函数,在这个函数中可以清楚的看出在启动中调用了generateArtifacts.sh和docker-compose-cli.yaml两个文件,这两个文件的作用分别是:
  1. generateArtifacts.sh:天生所需的证书(crypto-config文件夹)和通道相干的设置文件(channel-artifacts文件夹)docker-compose-cli.yaml:形貌的是这个示例网络的拓扑布局
复制代码
generateArtifacts.sh脚本文件

我们继承分析在network_setup.sh中调用generateArtifacts.sh文件具体又做了什么呢
在generateArtifacts.sh中一共有3个函数:replacePrivateKey()、generateCerts()和generateChannelArtifacts()
generateCerts():

在上图中可以看到这个函数利用工具cryptogen和crypto-config.yaml文件来天生所需的证书文件和公私钥。
我们可以看一下crypto-config.yaml文件:
Name和Domain是指该org的名字和域名,Template.Count是指该org中的节点数量,Users.Count是指该org中包罗的user数量.
  1. OrdererOrgs:  - Name: Orderer    Domain: example.com    Specs:      - Hostname: orderer# ---------------------------------------------------------------------------PeerOrgs:  - Name: Org1    Domain: org1.example.com    Template:      Count: 2    Users:      Count: 1  # ---------------------------------------------------------------------------  - Name: Org2    Domain: org2.example.com    Template:      Count: 2    Users:      Count: 1
复制代码
generateChannelArtifacts():

在上图中可以看到这个函数利用工具configtxgen和configtx.yaml文件来天生创世区块以及通道相干的设置文件。而configtx.yaml文件里紧张是一些org的设置项信息,如ID、Host、Port等,除此之外还指明了orderer的共识方式为solo等一些的基础的设置项信息。
docker-compose-cli.yaml脚本文件

docker-compose-cli.yaml文件形貌了这个示例网络的拓扑布局,如下,包罗:

  • orderer:1个
  • org1:peer0(锚节点),peer1
  • org2:peer0(锚节点),peer1
  • cli:对上面的容器节点举行管理
  • 为什么cli可以大概对上面的容器举行管理呢?
    由于cli是颠末网络中其他节点举行授权认可的,而认可的凭证就是公私钥
#command: /bin/bash -c './scripts/script.sh ${CHANNEL_NAME}; sleep $TIMEOUT'
文件中上面这一行是笔者故意解释掉的,使docker-compose-cli.yaml文件启动时不会主动去执行script.sh脚本,而这个脚本就是主动创建、加入通道以及链码相干利用的主动化脚本,而在下面,我们将自己动手来一步步完成这些步调,从而加深对fabric启动过程的理解。
  1. version: '2'services:  orderer.example.com:    extends:      file:   base/docker-compose-base.yaml      service: orderer.example.com    container_name: orderer.example.com  peer0.org1.example.com:    container_name: peer0.org1.example.com    extends:      file:  base/docker-compose-base.yaml      service: peer0.org1.example.com  peer1.org1.example.com:    container_name: peer1.org1.example.com    extends:      file:  base/docker-compose-base.yaml      service: peer1.org1.example.com  peer0.org2.example.com:    container_name: peer0.org2.example.com    extends:      file:  base/docker-compose-base.yaml      service: peer0.org2.example.com  peer1.org2.example.com:    container_name: peer1.org2.example.com    extends:      file:  base/docker-compose-base.yaml      service: peer1.org2.example.com  cli:    container_name: cli    image: hyperledger/fabric-tools    tty: true    environment:      - GOPATH=/opt/gopath      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock      - CORE_LOGGING_LEVEL=DEBUG      - CORE_PEER_ID=cli      - CORE_PEER_ADDRESS=peer0.org1.example.com:7051      - CORE_PEER_LOCALMSPID=Org1MSP      - CORE_PEER_TLS_ENABLED=true      - CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.crt      - CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.key      - CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt      - CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp    working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer    #command: /bin/bash -c './scripts/script.sh ${CHANNEL_NAME}; sleep $TIMEOUT'    volumes:        - /var/run/:/host/var/run/        - ../chaincode/go/:/opt/gopath/src/github.com/hyperledger/fabric/examples/chaincode/go        - ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/        - ./scripts:/opt/gopath/src/github.com/hyperledger/fabric/peer/scripts/        - ./channel-artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts    depends_on:      - orderer.example.com      - peer0.org1.example.com      - peer1.org1.example.com      - peer0.org2.example.com      - peer1.org2.example.com
复制代码
启动e2e示例

接下来我们将实际动手启动一下官方提供的示例:
天生证书以及密钥

起首我们进入下载的fabric源码目录/root/go/src/github.com/hyperledger/fabric,执行make cryptogen下令,天生cryptogen可执行步伐,如有报错,则在文章最后一部分有笔者自己碰到的错误,可自行查看;

接下来进入cd examples/e2e_cli/目录执行../../build/bin/cryptogen generate --config=./crypto-config.yaml,则会在本目录下天生crypto-config文件夹,存放天生公私钥和证书。

天生创世区块以及通道相干的设置文件

返回到fabric目录,执行make configtxgen下令,天生configtxgen可执行步伐

接下来照旧进入cd examples/e2e_cli/目录
天生创世区块:
  1. ../../build/bin/configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block
复制代码
天生通道相干的设置文件:
  1. ../../build/bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychannel
复制代码
天生org1和org2锚节点所需的设置文件:
  1. ../../build/bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID mychannel -asOrg Org1MSP../../build/bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID mychannel -asOrg Org2MSP
复制代码
执行完上述下令后,再执行tree channel-artifacts/(需安装tree下令yum install tree),可以望见如下图天生的文件的目录布局:

启动

启动所需的齐备都准备完毕,接下来我们启动fabric网络
  1. docker-compose -f docker-compose-cli.yaml up
复制代码
另起一个终端,执行docker ps,可以看到如下图,启动了1个orderer,4个peer(分属2个org),1个cli

创建通道

进入cli容器:docker exec -it cli bash
为了方便接下来我们的利用,先设置一些情况变量:
  1. export ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pemexport CHANNEL_NAME=mychannel
复制代码
创建通道:
  1. peer channel create -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/channel.tx --tls true --cafile $ORDERER_CA
复制代码
执行完该下令后体系会打印出下图,而且会在cli中天生1个mychannel.block文件,在后续中,其他的节点想要加入我们创建的这个通道,就必须利用这个文件。

将节点加入通道


  • 在docker-compose-cli.yaml文件中实在指明了启动时就默认毗连的是org1.peer0节点,以是直接将其加入通道即可
  1. peer channel join -b $CHANNEL_NAME.block
复制代码
执行效果如下:


  • 在这里我们只是将org1.peer0节点加入了mychannel这个通道,同样我们再将org1.peer1节点也加入通道,不外这里就须要修改情况变量,使其指向我们须要加入通道的节点后,再将节点加入通道。
  1. export CORE_PEER_LOCALMSPID="Org1MSP"export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin\@org1.example.com/mspexport CORE_PEER_ADDRESS=peer1.org1.example.com:7051peer channel join -b $CHANNEL_NAME.block
复制代码
执行效果如下:


  • 将org2.peer0节点加入通道:
  1. export CORE_PEER_LOCALMSPID="Org2MSP"export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin\@org2.example.com/mspexport CORE_PEER_ADDRESS=peer0.org2.example.com:7051peer channel join -b $CHANNEL_NAME.block
复制代码
执行效果如下:


  • 将org2.peer1节点加入通道:
  1. export CORE_PEER_LOCALMSPID="Org2MSP"export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin\@org2.example.com/mspexport CORE_PEER_ADDRESS=peer1.org2.example.com:7051peer channel join -b $CHANNEL_NAME.block
复制代码
执行效果如下:

更新锚节点

锚节点的作用是为了方便构造(org)之间的通讯,1个构造(org)可以拥有1个或多个锚节点负责与其他构造举行通讯,然后将效果同步到其他节点。
更新org1的锚节点org1.peer0,起首毗连到org1.peer0再执行更新
  1. export CORE_PEER_LOCALMSPID="Org1MSP"export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin\@org1.example.com/mspexport CORE_PEER_ADDRESS=peer0.org1.example.com:7051peer channel update -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org1MSPanchors.tx --tls true --cafile $ORDERER_CA
复制代码
更新org2的锚节点org2.peer0,起首毗连到org2.peer0再执行更新
  1. export CORE_PEER_LOCALMSPID="Org2MSP"export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin\@org2.example.com/mspexport CORE_PEER_ADDRESS=peer0.org2.example.com:7051peer channel update -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org2MSPanchors.tx --tls true --cafile $ORDERER_CA
复制代码
摆设测试链码

在上上一步中我们已经将org1和org2的一共4个peer都加入名为mychannel的这个通道,接下来我们开始安装链码,此时我们在上一步下令执行竣事后仍毗连的是org2.pee1节点,由于链码安装时并没有产生交易业务,因此是不会影响通道内的其他节点,可以说链码安装实在是一个本地化利用,以是,假如我们想在差异的节点中调用链码的话,就须要安装4次链码(由于我们目前只有4个节点)

  • 安装链码:
  1. peer chaincode install -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02
复制代码
执行效果如下:


  • 实例化链码(-o:指定orderer的地点)
    链码实例化实在可以看作是一笔特殊的交易业务,链码在某个节点实例化以后,其信息就会被广播到通道内的全部节点,假如另外1个节点又再一次对这个链码实例化的话就会辩说。
  1. peer chaincode instantiate -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA -C $CHANNEL_NAME -n mycc -v 1.0 -c '{"Args":["init", "a", "100", "b", "200"]}' -P "OR        ('Org1MSP.member', 'Org2MSP.member')"
复制代码

  • 调用链码
    上面一步我们的链码实例化已经完成,初始时a账户100元,b账户200元,我们先查询一下a的余额,验证一下
  1. peer chaincode query -C $CHANNEL_NAME -n mycc -c '{"Args":["query", "a"]}'
复制代码
执行效果如下:

接下来我们调用链码使a给b转账50元
  1. peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA -C $CHANNEL_NAME -n mycc -c '{"Args":["invoke", "a","b","50"]}'
复制代码
执行效果如下:

现在我们须要在另外1个节点org1.peer0上查询org2.peer1节点上发生的交易业务是否成功
须要先毗连到org1.peer0上,须要再一次安装链码,但不须要实例化
  1. export CORE_PEER_LOCALMSPID="Org1MSP"export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin\@org1.example.com/mspexport CORE_PEER_ADDRESS=peer0.org1.example.com:7051peer chaincode install -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02
复制代码
再一次安装完链码后我们调用链码查询a的余额
  1. peer chaincode query -C $CHANNEL_NAME -n mycc -c '{"Args":["query", "a"]}'
复制代码
执行效果如下:

最后我们查看正在运行中的容器,可以看到如下:

错误


  • 执行make cryptogen下令如有报错

    办理方案:yum install libtool-ltdl-devel

最后呢,分析一下,作者也是刚入坑的小白,这篇文章也就是分享一下个人的理解,方便以后查看。假如对你有资助的话,非常荣幸,假如有不对的地方,接待留言指正!
参考文章

博客园深蓝居

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|深圳论坛-深圳人的网上家园  

GMT+8, 2020-6-6 05:54 , Processed in 0.140792 second(s), 30 queries .

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.

快速回复 返回顶部 返回列表