Hyperledger Fabric入门1：快速上手

2018-11-19  本文已影响0人  rzexin

Hyperledger Fabric入门1：快速上手

jasonruan 2018.11.17

0. 前言

本文是自己学习超级账本Fabric的第一篇文章，主要是体验了下基本功能——快速搭建起网络环境，并利用自带sample，体会了一下链码的部署与调用，为后续逐步深入其内部原理和链码开发做一个铺垫。

1. 名词解释

自己初学超级账本Fabric，其众多的术语确实弄得有些蒙圈，以下摘记部分术语。

术语 含义
Anchor Peer（锚节点） 通道中能被所有对等节点探测，并能与之进行通信的一种对等节点。
通道中的每个成员都有一个或多个锚节点，允许属于不同身份的节点来发现通道中存在的其他节点。
Block（区块） 区块是一组有序的交易集合，在通道中经过哈希加密后与前序区块连接。
Chaincode（链码） 区块链上的应用代码，扩展自“智能合约”概念。
Channel（通道） Fabric 网络上的私有隔离。通道中的链码和交易只有加入该通道的节点可见。
Consensus （共识） 共识是贯穿整个交易流程， 对包含块的一组交易的正确性的全面验证。
Endorser（背书节点） 负责检验某个交易是否合法，是否愿意为之担保、签名。
Fabric-CA（证书节点） 默认的证书管理组件，它向网络成员及其用户颁发基于PKI的证书。
CA为每个成员颁发一个根证书，为没有授权用户颁发一个注册证书，为每个注册证书颁发大量交易证书。
Genesis Block（创世区块） 是区块链上的第一个区块，是初始化区块链网络或通道的配置区块
Ledger（账本） 账本是由通道中每个peer维护的数据库。
MSP（Member Service Provider，成员服务提供者） 抽象的实现成员服务（身份验证，证书管理等）的组件，实现对不同类型的成员服务的可拔插支持。
Orderer Peer（排序节点） 负责排序看到的交易，提供全局确认的顺序。
Ordering Service（排序服务） 将交易排序放入block的节点的集合。排序服务独立与peer流程之外，并以先到先服务的方式为网络上所有的通道做交易排序。
State Database（状态数据库） 当前状态数据存储在状态数据库中，以便从chaincode进行有效读取和查询。这些数据库包括levelDB和couchDB。
Transaction（交易） 执行账本上的某个函数调用或者部署 chaincode。调用的具体函数在 chaincode 中实现。
Validating Peer（验证节点） 维护账本的核心节点，参与一致性维护、对交易的验证和执行。
World State（世界状态） 即最新的全局账本状态。Fabric 用它来存储历史交易发生后产生的最新的状态，可以用键值或文档数据库实现。

2. 环境搭建

2.1 前置依赖

省略具体安装步骤

2.2 fabric下载

下载地址：https://github.com/hyperledger/fabric

$ git clone https://github.com/hyperledger/fabric.git
Cloning into 'fabric'...
remote: Enumerating objects: 183, done.
remote: Counting objects: 100% (183/183), done.
remote: Compressing objects: 100% (164/164), done.
remote: Total 81151 (delta 64), reused 135 (delta 18), pack-reused 80968
Receiving objects: 100% (81151/81151), 77.50 MiB | 440.00 KiB/s, done.
Resolving deltas: 100% (51831/51831), done.

2.3 fabric安装

步骤：

3. 构建网络

下面基于fabric-samples提供的BYFN(build your first network)，来快速的构建我们第一个超级账本fabric网络，以此来熟悉整个运行过程。

3.1 生成配置

3.1.1 执行命令

进入到：fabric/scripts/fabric-samples/first-network/，执行命令：

$ sudo ./byfn.sh -m generate -c jschannel

3.1.2 命令说明

3.1.3 步骤说明

（1）生成证书

使用cryptogen工具为组织org1和org2生成MSP证书，MSP证书是超级账本网络实体的身份标识，实体在通信和交易时，使用证书进行签名和验证。成功执行后，证书文件将会放到crypto-config目录中。

##########################################################
##### Generate certificates using cryptogen tool #########
##########################################################
+ cryptogen generate --config=./crypto-config.yaml
org1.example.com
org2.example.com
（2）创建创世块

为排序服务生成创世区块，成功执行后，会在channel-artifacts目录下生成创世区块文件：genesis.block

##########################################################
#########  Generating Orderer Genesis block ##############
##########################################################
+ configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block
（3）创建通道

生成通道配置文件channel.tx，成功执行后，会在channel-artifacts目录下生成通道配置channel.tx

#################################################################
### Generating channel configuration transaction 'channel.tx' ###
#################################################################
+ configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID jschannel
（4）生成锚节点配置

生成Org1MSP和Org2MSP的锚节点配置，成功执行后，生成的锚点配置文件Org1MSPanchors.tx和Org2MSPanchors.tx同样位于目录channel-artifacts中。

#################################################################
#######    Generating anchor peer update for Org1MSP   ##########
#################################################################
+ configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID jschannel -asOrg Org1MSP

#################################################################
#######    Generating anchor peer update for Org2MSP   ##########
#################################################################
+ configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID jschannel -asOrg Org2MSP

3.1.4 配置输出

综上，命令执行完后，将会在当前目录生成两个文件夹，内容分别如下：

$ tree channel-artifacts/
channel-artifacts/
├── channel.tx                          # 通道配置创世区块
├── genesis.block                       # 排序服务创世区块
├── Org1MSPanchors.tx                   # Org1锚节点配置
└── Org2MSPanchors.tx                   # Org2锚节点配置

$ tree crypto-config
crypto-config
├── ordererOrganizations
│   └── example.com
│       ├── ca
│       │   ├── 2b749470c3d6cae6d63caa7b69ee9ebbc310ca68526521e444012f186e97bd92_sk
│       │   └── ca.example.com-cert.pem
│       ├── msp
│       │   ├── admincerts
│       │   │   └── Admin@example.com-cert.pem
│       │   ├── cacerts
│       │   │   └── ca.example.com-cert.pem
│       │   └── tlscacerts
│       │       └── tlsca.example.com-cert.pem
│       ├── orderers
│       │   └── orderer.example.com
│       │       ├── msp
│       │       └── tls
│       │           ├── ca.crt
│       │           ├── server.crt
│       │           └── server.key
│       ├── tlsca
│       │   ├── c79b35c1154c5377923a77dfa6036707652715671e2b1450e6313b64a65f238e_sk
│       │   └── tlsca.example.com-cert.pem
│       └── users
│           └── Admin@example.com
│               ├── msp
└── peerOrganizations
    ├── org1.example.com
    │   ├── ca
    │   ├── msp
    │   ├── peers
    │   ├── tlsca
    │   └── users
    └── org2.example.com

3.2 启动网络

3.2.1 执行命令

$ sudo ./byfn.sh -m up -c jschannel

3.2.2 命令说明

3.2.3 命令输出

看到下面信息，表明超级账本Fabric网络已经启动完毕。

  Creating network "net_byfn" with the default driver
  Creating volume "net_orderer.example.com" with default driver
  Creating volume "net_peer0.org1.example.com" with default driver
  Creating volume "net_peer1.org1.example.com" with default driver
  Creating volume "net_peer0.org2.example.com" with default driver
  Creating volume "net_peer1.org2.example.com" with default driver
  Creating peer1.org2.example.com ... done
  Creating orderer.example.com    ... done
  Creating peer1.org1.example.com ... done
  Creating peer0.org2.example.com ... done
  Creating peer0.org1.example.com ... done
  Creating cli                    ... done

3.2.4 查看容器

使用docker ps命令查看容器启动情况

$ sudo docker ps                                                      
CONTAINER ID IMAGE                             COMMAND            PORTS                                              NAMES
c32c37c5742f hyperledger/fabric-tools:latest   "/bin/bash"                                                           cli                         
dadda8aff9ae hyperledger/fabric-peer:latest    "peer node start"  0.0.0.0:8051->7051/tcp, 0.0.0.0:8053->7053/tcp     peer1.org1.example.com
f35e303b931d hyperledger/fabric-peer:latest    "peer node start"  0.0.0.0:7051->7051/tcp, 0.0.0.0:7053->7053/tcp     peer0.org1.example.com
5bf8fdf0f804 hyperledger/fabric-peer:latest    "peer node start"  0.0.0.0:9051->7051/tcp, 0.0.0.0:9053->7053/tcp     peer0.org2.example.com
48c9b04f48db hyperledger/fabric-peer:latest    "peer node start"  0.0.0.0:10051->7051/tcp, 0.0.0.0:10053->7053/tcp   peer1.org2.example.com
023b2fed2737 hyperledger/fabric-orderer:latest "orderer"          0.0.0.0:7050->7050/tcp                             orderer.example.com

3.3 链码调用

3.3.1 执行命令

在启动网络使用的$ sudo ./byfn.sh -m up -c jschannel中，启动的cli容器会调用scripts/script.sh脚本，该脚本会进行通道创建、Peer节点加入通道、安装和实例化链码等，并进行链码的调用和查询。下面我们对命令进行进一步的说明。

3.3.2 命令说明

scripts/script.sh中执行的具体命令如下，每个命令都对应一个shell脚本函数

## Create channel                                     
createChannel
 
## Join all the peers to the channel
joinChannel
 
## Set the anchor peers for each org in the channel
updateAnchorPeers 0 1 
updateAnchorPeers 0 2 
 
## Install chaincode on peer0.org1 and peer0.org2
installChaincode 0 1 
installChaincode 0 2 
 
# Instantiate chaincode on peer0.org2
instantiateChaincode 0 2 
 
# Query chaincode on peer0.org1
chaincodeQuery 0 1 100 
 
# Invoke chaincode on peer0.org1 and peer0.org2
chaincodeInvoke 0 1 0 2 
 
## Install chaincode on peer1.org2
installChaincode 1 2 
 
# Query on chaincode on peer1.org2, check if the result is 90
chaincodeQuery 1 2 90

3.3.3 步骤说明

（1）创建通道

进入cli容器，执行创建通道命令。成功执行后，将在cli容器的当前路径下生成通道配置jschannel.block，加入通道操作时需要使用。

Channel name : jschannel
Creating channel...
+ peer channel create -o orderer.example.com:7050 -c jschannel -f ./channel-artifacts/channel.tx --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
===================== Channel 'mychannel' created =====================
（2）4个peer节点依次加入通道

通过在cli容器中设置不同的环境变量，设置连接的Peer节点和MSP等，依次将4个Peer节点加入通道

+ peer channel join -b jschannel.block
Having all peers join the channel...
===================== peer0.org1 joined channel 'jschannel' ===================== 
+ peer channel join -b jschannel.block
===================== peer1.org1 joined channel 'jschannel' ===================== 
+ peer channel join -b jschannel.block
===================== peer0.org2 joined channel 'jschannel' ===================== 
+ peer channel join -b jschannel.block
===================== peer1.org2 joined channel 'jschannel' =====================
（3）更新组织的锚节点
Updating anchor peers for org1...
+ peer channel update -o orderer.example.com:7050 -c jschannel -f ./channel-artifacts/Org1MSPanchors.tx --tls true --cafile 
========= Anchor peers updated for org 'Org1MSP' on channel 'jschannel' ========= 

Updating anchor peers for org2...
+ peer channel update -o orderer.example.com:7050 -c jschannel -f ./channel-artifacts/Org2MSPanchors.tx --tls true --cafile 
========== Anchor peers updated for org 'Org2MSP' on channel 'jschannel' ==========
（4）在Peer节点（peer0.org1和peer0.org2）上安装链码

应用程序通过链码执行智能合约的功能，需要先在Peer节点上安装链码，然后在通道上实例化链码

Installing chaincode on peer0.org1...
+ peer chaincode install -n mycc -v 1.0 -l golang -p github.com/chaincode/chaincode_example02/go/
===================== Chaincode is installed on peer0.org1 ===================== 

Install chaincode on peer0.org2...
+ peer chaincode install -n mycc -v 1.0 -l golang -p github.com/chaincode/chaincode_example02/go/
===================== Chaincode is installed on peer0.org2 =====================
（5）在Peer节点（peer0.org2）上实例化链码

实例化链码只需要执行一次，这条命令比较复杂，-c：指定初始化参数；-P：指定了背书策略，链码的每个交易需要由Org1MSP和Org2MSP两个组织都进行背书签名，才能通过背书策略，继续进入后续交易流程。成功执行后，会启动链码容器mycc。

Instantiating chaincode on peer0.org2...
+ peer chaincode instantiate -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 jschannel -n mycc -l golang -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P 'AND ('\''Org1MSP.peer'\'','\''Org2MSP.peer'\'')'
========= Chaincode is instantiated on peer0.org2 on channel 'jschannel' =========
（6）在Peer节点（peer0.org1）上执行链码查询a的值
Querying chaincode on peer0.org1...
========== Querying on peer0.org1 on channel 'jschannel'... ========== 
+ peer chaincode query -C jschannel -n mycc -c '{"Args":["query","a"]}'

100
========== Query successful on peer0.org1 on channel 'jschannel' ==========
（7）在Peer节点（peer0.org1）调用链码，从a转10到b
Sending invoke transaction on peer0.org1 peer0.org2...
+ 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 jschannel -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"]}'

==== Invoke transaction successful on peer0.org1 peer0.org2 on channel 'jschannel' ====
（8）在Peer节点（peer1.org2）安装链码
Installing chaincode on peer1.org2...
+ peer chaincode install -n mycc -v 1.0 -l golang -p github.com/chaincode/chaincode_example02/go/
===================== Chaincode is installed on peer1.org2 =====================
（9）在Peer节点（peer1.org2）执行链码查询a的值
Querying chaincode on peer1.org2...
========== Querying on peer1.org2 on channel 'jschannel'... ========== 
+ peer chaincode query -C jschannel -n mycc -c '{"Args":["query","a"]}'

90
========= Query successful on peer1.org2 on channel 'jschannel' ========= 
========= All GOOD, BYFN execution completed ===========

3.4 关闭网络

3.4.1 执行命令

测试完成后，使用如下命令，关闭网络

$ sudo ./byfn.sh -m down

4. 总结

本文通过分解的方式，逐步介绍了搭建超级账本Fabric网络的基本过程以及链码部署和调用的方法，在理解和掌握了最基本的步骤后，也为后续自己深入学习超级账本的原理和开发更为复杂的链码应用打下基础。

上一篇下一篇

猜你喜欢

热点阅读