Hyperledger Fabric(四)------BYFN详细剖析

最新推荐文章于 2022-12-24 20:18:17 发布
最新推荐文章于 2022-12-24 20:18:17 发布
阅读量3.4k 收藏 11
点赞数 4
分类专栏： 区块链 文章标签： BYFN Building Your First Network Using Private Data in Fabric Adding an Org to a Channel
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yijiull/article/details/81177434
版权

文章目录

UPDATE：2020-09-04

这篇博客很久之前写的了，当时对Fabric并不是非常了解，推荐大家去看新的专栏超级账本源码解析 【https://blog.csdn.net/yijiull/article/details/107394388】，近期会经常更新～

这个官方样例Building Your First Network我运行了可能有5遍了，今天才真正明白是怎么回事，这里记录一下。

运行这个样例之前务必要先弄明白Docker。

另外后面有两个扩展部分Adding an Org to a Channel和Using Private Data in Fabric，官方文档是分开讲的，由于都是用这个网络，我这里就放到一起了，认真实践之后会有很大收获。

UPDATE:20180805
一直对msp和证书相关的东西很迷，昨天仔细去看了下，又有了新的收获，发现之前理解的还是不够，在此更新一下这篇博客。

脚本执行

首先先用现成的脚本执行一次，确保环境安装正确。

./byfn.sh up

如果最后输出如下，说明运行成功。

===================== All GOOD, BYFN execution completed =====================


 _____   _   _   ____
| ____| | \ | | |  _ \
|  _|   |  \| | | | | |
| |___  | |\  | | |_| |
|_____| |_| \_| |____/

然后一定不要忘记清理运行环境。

./byfn.sh down

分步手动执行

搭建基础网络

组织架构准备

  1. 编写组织架构文件crypto-config.yaml，其中配置了排序服务节点和组织节点。

    简要说明一下

    - Name: Org2
    Domain: org2.example.com
    EnableNodeOUs: true
    Template:
      Count: 2  //表明一个Org有几个peer
    Users:
      Count: 1  //表明一个Org有几个User

  2. 使用cryptogen工具根据架构文件生成相关的证书，放到crypto-config目录下。

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

    这里我们有必要看一下这个目录(这里只列出了子目录ordererOrganizations下的)：
    mspDirTree
    这里从上到下一共有三个msp文件夹：

    • 第一个msp是该成员的local msp，在config.yaml中要用来生成channel msp，把这里包含的根证书加到orderer genesis.block中，这样以后该Org的成员与order交互时数字签名可以被认证
    • 第二个和第三个是local msp，里面包含了自己的证书和私钥

    再说一下ca文件夹，这就是这个Org的CA，里面有证书和私钥。
    而tlsca文件夹，是tls通信要用的CA，里面也是证书和私钥。
    每一个order或者peer或者user都有自己的msp，如果要tls通信还要有tls，我们在docker配置文件docker-compose-cli.yaml中可以看到里面配置peer和order的时候环境变量里的msp和tls都是这两个文件夹。admin是这个组织的管理者。

生成配置文件

用到configtxgen工具，生成的配置文件都在channel-artifacts目录下，这里一共会有四个。

要告诉工具去哪里找configtx.yaml文件。

export FABRIC_CFG_PATH=$PWD

  1. 生成orderer genesis block

    ../bin/configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block

用来启动order服务

  1. 生成通道配置文件

    先指定通道名称：export CHANNEL_NAME=mychannel

    ../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME

通道建立时该文件会被广播到order

  1. 为Org定义anchor peer

    ../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP

    ../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

指定了Org的anchor peer

启动网络

这里需要用到Docker-Compose模板文件docker-compose-cli.yaml，里面定义了需要用到的容器，去看代码发现里面其实是扩展了base目录下的另外两个模板文件，感觉就像是继承一样。

启动网络：docker-compose -f docker-compose-cli.yaml up -d

同时用先前生成的genesis.block引导启动了order服务

其中容器CLI的定义如下（截取部分）：

cli:
    container_name: cli
    image: hyperledger/fabric-tools:$IMAGE_TAG
    tty: true
    stdin_open: true
    environment:  
      - GOPATH=/opt/gopath
      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
      #- CORE_LOGGING_LEVEL=DEBUG
      - CORE_LOGGING_LEVEL=INFO
      - 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

上面的环境变量部分指定是在peer0.org1.example.com节点操作chaincode

还要说明一下，我们是通过CLI容器对其它容器进行配置。

进入CLI容器的命令：docker exec -it cli bash

创建通道

声明通道名：export CHANNEL_NAME=mychannel

  1. 创建通道

    将channel.tx发送至order节点

    peer channel create -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/channel.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem
    > -o 指定排序节点，-c指定通道名字，-f指定通道配置文件，–tls允许tls通信，–cafile指定排序节点根证书目录（也就是上图中的第一个msp目录）以允许tls握手

    这一步会生成mychannel.block，里面包含了channel.tx中的通道配置信息，直接在当前命令行输入ls就可看到，后面加入peer节点是需要用到。

  2. 将peer加入通道

    加入peer0.org1.example.com节点

    peer channel join -b mychannel.block

    加入peer0.org2.example.com节点，这里要先声明环境变量

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp
CORE_PEER_ADDRESS=peer0.org2.example.com:7051
CORE_PEER_LOCALMSPID=“Org2MSP”
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.crt
```

加入通道：`peer channel join -b mychannel.block`

  1. 更新anchor peer

    将对应的文件发给order节点。
    本质上是更新通道配置信息，并没有修改genesis.block，而是添加到后面。

    更新Org1的anchor peerpeer0.org1.example.com

    CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp

CORE_PEER_ADDRESS=peer0.org1.example.com:7051
CORE_PEER_LOCALMSPID=“Org1MSP”
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
```
peer channel update -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org1MSPanchors.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

更新Org2的anchor peer`peer0.org2.example.com`

先设置环境变量
```
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp
CORE_PEER_ADDRESS=peer0.org2.example.com:7051
CORE_PEER_LOCALMSPID="Org2MSP"
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.crt
```
更新：`peer channel update -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org2MSPanchors.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem`

注意这里每次设置时都需要重新设置环境变量

部署智能合约

这里我们用的是chaincode/chaincode_example02/go/目录下现成的智能合约，当然也可以自己写。
可以在docker-compose-cli.yaml中peer0的volumes配置部分看到./../chaincode/:/opt/gopath/src/github.com/chaincode，这里就是把上面说的那个目录映射到peer0中的目录下。不过这里映射的目录有一点疑惑，下面install的时候的路径也很迷，既不是相对当前目录的路径，也不是绝对路径，而是相对/opt/gopath/src/的路径=_=

  1. 安装智能合约

    在peer0.org1.example.com上安装

    CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
CORE_PEER_ADDRESS=peer0.org1.example.com:7051
CORE_PEER_LOCALMSPID="Org1MSP"
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

    peer chaincode install -n mycc -v 1.0 -p github.com/chaincode/chaincode_example02/go/

    在peer0.org2.example.com上安装

    当然还是要设置环境变量

    CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp
CORE_PEER_ADDRESS=peer0.org2.example.com:7051
CORE_PEER_LOCALMSPID="Org2MSP"
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.crt

    安装：peer chaincode install -n mycc -v 1.0 -p github.com/chaincode/chaincode_example02/go/

    注意这里如果不在peer0.org2.example.com上安装智能合约，后面转账（invoke）时会报错

  2. 实例化智能合约

    peer chaincode instantiate -o orderer.example.com:7050 --tls --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 $CHANNEL_NAME -n mycc -v 1.0 -c '{"Args":["init","a", "100", "b","200"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"

    -o指定排序节点，–tls允许tls通信，–cafile指定排序节点根证书目录，-C指定通道名字，-n指定智能合约名字，-v指定智能合约版本，-c为调用智能合约传递参数

  3. 查询和转账

    查询：peer chaincode query -C $CHANNEL_NAME -n mycc -c '{"Args":["query","a"]}'

    转账：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 $CHANNEL_NAME -n mycc --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["invoke","a","b","10"]}'

    可以看到这里转账用到的证书是第一个msp下tlscacerts文件夹下的pem格式的证书，以及后面两个peer目录下tls文件夹下的ca.crt证书。应该就是tls通信需要。

    这里如果转账之后立即查询，可能会发现账本未更新，结果与预期不符，等一下再去查询结果又对了，应该是查询只需要在本地peer上进行比较快，而转账需要其它节点参与以及共识机制，要慢。
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-yJdazPQv-1599921255557)(http://p39js7gdh.bkt.clouddn.com/collision.png)]

  4. 查看交易日志

    打开一个新的终端：docker logs dev-peer0.org2.example.com-mycc-1.0

    看这里也可以发现只有和自己有关的交易日志才会记录下来，比如说peer0.org1的查询只在docker logs dev-peer0.org1.example.com-mycc-1.0中可以看到，而转账在两个中都可以看到。

可以用CouchDB替换默认的goleveldb数据库，支持丰富的查询。

Adding an Org to a Channel

如果上面的部分都已经理解透彻了，强烈建议看一下这部分内容，虽然比较麻烦，不过看完了相信会有很大收获。
官方文档
这里说一下大概步骤：

  1. 先生成Org3需要的证书
  2. 计算出需要更新的网络，这一步比较繁琐，需要pb文件和json文件来回转换
  3. 更新网络
  4. 将Org3相关的加入网络
  5. 安装智能合约
  6. 更新智能合约
  7. 就可以查询转账了

Using Private Data in Fabric

官方文档

collection vs. private channel:

  • 当交易的全部信息只能被某些Orgs看到时，用channel。
  • 当只有交易的部分信息能被某些Orgs看到而对其他Org保密时，或者交易信息需要对Order保密时，用collection。

智能合约的不同之处在于要对数据分别处理，而且实例化智能合约的时候要用--collections-config参数执行collection definiton的目录。

另外collection definiton中有个blockToLive参数，用来指定私有数据的存活时间，以Block为单位，过期会被销毁。

yijiull
关注
  • 4
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
hyperledger fabric测试脚本（byfn.sh）分解
clyss1234的博客
09-11 6541
1. 环境准备 ​ 安装 node.js golang语言 git docker docker-compose hyperledger-fabric fabirc镜像 2. 运行实例 2.1 脚本运行 git clone fabric-sample文件，进入文件夹下的first-network文件，运行buyfn.sh 2.2 命令分解 若已经将bin目录下的可执行文件添加到环境变量中，可省略"…/bin/" 1.生成证书 ../bin/cryptogen generat
Hyperledger Fabric教程（14）--byfn.sh所有命令
软件工程小施同学 的专栏
01-07 800
https://wenku.baidu.com/view/ea0b107333b765ce0508763231126edb6f1a7674.html
Hyperledger Fabric BYFN之基础配置篇
Zeal Vampire真诚的吸血鬼
09-07 892
参考https://hyperledger-fabric.readthedocs.io/en/release-1.2/build_network.html http://www.javatree.cn/news/027b347e856e49589083282b5d01dccb Build your first network是Hyperledger Fabric官方最详细的例子, 目录对应 ...
Hyperledger Fabric之BYFN多机部署
yijiull
01-11 555
文章目录安装HLF配置docker网络创建启动文件运行可能出现的错误 显然单机和多机部署的区别在于网络配置，也就是怎么进行docker容器之间的通信，所以多机部署的关键其实在于docker的网络通信。 安装HLF 五台server，系统是Ubuntu16.04，已经配置好了ssh证书登录，假设IP分别是 10.22.1.12 # orderer.example.com, cli 10.22.1...
hyperledger-fabric-linux-amd64-1.4.4.tar.gz
12-02
hyperledger-fabric-linux-amd64-1.4.4.tar.gz，用于解决在执行./bootstrap.sh时无法下载或者在./byfn.sh generate 时报错cryptogen tool not found，通过直接解压该文件到fabric-samples/中即可
fabric-samples.zip
05-15
Fabric-Samples是一个重要的资源集合，它为Hyperledger Fabric区块链框架提供了丰富的示例和教程，旨在帮助开发者更好地理解和使用这个分布式账本技术平台。这个压缩包“fabric-samples.zip”包含了Fabric-Samples的...
blockchain-notes:HyperLedger fabric 和 区块链 学习笔记
05-15
Hyperledger fabric 学习笔记 简介 本系列文章, 是我学习fabric过程中的笔记. 从一个例子开始 基于hyperledger官方提供的fabric-samples里的BYFN（Build Your First Net-work）介绍超级账本的构建过程，首先是利用...
Hyperledger Fabric 源码 例子 依赖工具
11-01
一、Hyperledger Fabric源码分析 Hyperledger Fabric的源码分为多个组件，包括： 1. **Chaincode**: 这是业务逻辑的实现，类似于智能合约，负责处理交易并更新账本状态。 2. **Orderer**: 负责接收交易，并按照特定...
byfn.sh 创建fabric网络官方实例
10-27
build you first net 文件
Hyperledger Fabric 2.1 BYFN 测试用例
TBBetter的博客
05-03 507
Building Your First Networkbyfn.sh script 命令两个工具Cryptogen & crypto-config.yamlConfigtxgen & configtx.yaml手动生成文件加密文件配置文件启动网络启动网络创建通道并加入更新锚节点安装并定义链码（Go）调用链码QueryInvokeQuery agian新节点 peer1.org2 上...
Hyperledger Fabric实战（6）—— byfn.sh 构建网络源码解析
keke_kid的专栏
07-15 2594
原创： 水龙吟爱编程 超级账本开发 今天通过上面的一系列操作，我们已经可以在本机环境中搭建fabric的开发环境，并可以编写基本的链码了．接下来，我们回过头来，从一个俯瞰的视角，来看看构建网络是怎么做的. byfn == Build Your First Network. 构建你的第一个网络.整体结构先来看byfn.sh 的源码, 直接拉到文件最后, 看最后的10几行代码:当我们键入 ./byfn...
【超级账本】first-network -byfn.sh源码分析
Fred's Note
09-26 1064
generate命令 byfn.sh generate -c mychannel" generateCerts 该方法用于生成相关的证书，（采用cryptogengo工具）包括各个节点的根证书、组织证书、交易证书、传输证书等。代码如下： cryptogen generate --config=./crypto-config.yaml replacePrivateKey 该方法用于将ge...
Fabric First-Network之byfn.sh
abc_a1b2c3的博客
07-18 403
0x00 byfn.sh之命令参数 byfn全称build your first network。从下面的帮助信息可以看出，在运行first-network的时候，默认用到的三个命令参数为generate、up和down。其中generate用于生成证书和创世区块，up用于启动网络，down用于停止网络。 Typically, one would first generate the requir...
运行官方byfn.sh跑通网络
患孤的博客
03-27 768
目录前言切换目录使用自动化脚本搭建网络生成证书和密匙启动网络 前言 大家好啊好久不见，我又来了，被一些事情耽误了很久，想必大家之前都已经配置好了网络环境了吧！，如果还有没有配置好了的可以来看我的文章。或者私信问我哈，我会尽我所能帮助你们的。前面一系列教程直通车： 文章 链接 1、搭建虚拟机 点击此处 2、创建root用户 点击此处 3、搭建网络环境 点击此处 那么到了现在我们就可以跑官方的测试了，来确保我们的环境没有搭错。 切换目录 首先确保自己的fabric-samples没有
Hyperledger Fabric教程（3）-- byfn.sh分析-生成通道所需交易和文件
软件工程小施同学 的专栏
01-07 429
configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channelartifacts/genesis.block configtxgen -profile TwoOrgsChannel outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychannel configtxgen -profile TwoOrgsChannel outputAnch...
Fabric1.4 手动实现 byfn 全流程
攻城老湿的博客
12-08 377
完成 Fabric 1.4 环境搭建后，可以调用 first-network 的 byfn.sh 程序来验证是否环境搭建成功。该shell脚本实际上就是搭建了4个peer节点，1个order，1个cli的组网，之后通过链码的安装，实例化和调用来验证环境是否搭建成功。但我们已经对其中的配置和流程较为模糊。为此，我们仿照byfn脚本的内容完成了手动的全流程实现，对配置和组网细节进行深入了解，便于之后...
使用fabric-sdk-go调用Fabric 1.4 BYFN中的链码
TrueTechLabs 官方博客
12-24 1610
使用fabric-sdk-go调用BYFN中的链码，简明好用
source /etc/profile mkdir -p /home/ubuntu/gopath/src/github.com/hyperledger cd /home/ubuntu/gopath/src/github.com/hyperledger cp /resource/docker-compose /usr/local/bin chmod +x /usr/local/bin/docker-compose cp /resource/fabric-samples.tar.gz /home/ubuntu/gopath/src/github.com/hyperledger cd /home/ubuntu/gopath/src/github.com/hyperledger tar -xf ./fabric-samples.tar.gz source /etc/profile cd /home/ubuntu/gopath/src/github.com/hyperledger/fabric-samples/scripts ./bootstrap.sh 1.4.0 1.4.0 0.4.14 cd /home/ubuntu/gopath/src/github.com/hyperledger/fabric-samples/first-network ./byfn.sh up -s couchdb docker-compose -f docker-compose-cli.yaml -f docker-compose-couch.yaml -f docker-compose-kafka.yaml start ../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx channel-artifacts/test.tx -channelID test
最新发布
06-07
8. 执行 `tar -xf ./fabric-samples.tar.gz` 命令，解压 Hyperledger Fabric 样例程序压缩包； 9. 执行 `source /etc/profile` 命令，重新加载 Go 语言环境变量； 10. 执行 `cd /home/ubuntu/gopath/src/github....

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值