原文 作者 审核修正
原文 Linsheng Yu Kewei Sun

本文设定了一个简单的Fabric网络场景，包括2个organization，每个有2个peer，并使用“solo” ordering服务。网络实体所需的加密材料（x509证书）已预先生成并放到相应目录和配置文件里了，你无需修改这些配置。examples/e2e_cli文件夹里包含了docker-compose文件和要用来创建和测试网络的脚本文件。

本文还演示了使用配置生成工具configtxgen生成网络配置。

前提

完成以下安装Fabric源码和编译configtxgen工具：

  • 完成环境安装，并设置正确的$GOPATH环境变量。

  • 拉取Fabric源码

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

  • 编译configtxgen工具

    • 如果运行在Linux，在Fabric目录下执行以下命令：

      1.   cd $GOPATH/src/github.com/hyperledger/fabric
      2.   make configtxgen
      3.   # 如果出错：'ltdl.h' file not found
      4.   sudo apt install libtool libltdl-dev
      5.   # 然后再运行make
      6.   make configtxgen

    • 如果运行在OSX，先安装Xcode 8.0或以上版本，然后在Fabric目录下执行以下命令：

      1.   # 安装 Homebrew
      2.   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
      3.   # 添加 gnu-tar
      4.   brew install gnu-tar --with-default-names
      5.   # 添加 libtool
      6.   brew install libtool
      7.   # 编译 configtxgen
      8.   make configtxgen

      编译成功后输出：

      1.   build/bin/configtxgen
      2.   CGO_CFLAGS=" " GOBIN=/Users/johndoe/work/src/github.com/hyperledger/fabric/build/bin go install -ldflags "-X github.com/hyperledger/fabric/common/metadata.Version=1.0.0-snapshot-8d3275f -X github.com/hyperledger/fabric/common /metadata.BaseVersion=0.3.0 -X github.com/hyperledger/fabric/common/metadata.BaseDockerLabel=org.hyperledger.fabric"       github.com/hyperledger/fabric/common/configtx/tool/configtxgen
      3.   Binary available as build/bin/configtxgen``

      编译后执行文件放在Fabric目录下的的build/bin/configtxgen

执行完整脚本

为了加快部署过程，我们提供了一个脚本来执行所有任务。执行该脚本会生成配置结果、本地网络、Chaincode测试。

进入examples/e2e_cli目录，首先从Docker Hub拉取镜像：

  1. # 使脚本可执行
  2. chmod +x download-dockerimages.sh
  3. # 执行脚本
  4. ./download-dockerimages.sh

这个过程会需要几分钟，脚本执行后输出：

  1. ===> List out hyperledger docker images
  2. hyperledger/fabric-ca          latest               35311d8617b4        7 days ago          240 MB
  3. hyperledger/fabric-ca          x86_64-1.0.0-alpha   35311d8617b4        7 days ago          240 MB
  4. hyperledger/fabric-couchdb     latest               f3ce31e25872        7 days ago          1.51 GB
  5. hyperledger/fabric-couchdb     x86_64-1.0.0-alpha   f3ce31e25872        7 days ago          1.51 GB
  6. hyperledger/fabric-kafka       latest               589dad0b93fc        7 days ago          1.3 GB
  7. hyperledger/fabric-kafka       x86_64-1.0.0-alpha   589dad0b93fc        7 days ago          1.3 GB
  8. hyperledger/fabric-zookeeper   latest               9a51f5be29c1        7 days ago          1.31 GB
  9. hyperledger/fabric-zookeeper   x86_64-1.0.0-alpha   9a51f5be29c1        7 days ago          1.31 GB
  10. hyperledger/fabric-orderer     latest               5685fd77ab7c        7 days ago          182 MB
  11. hyperledger/fabric-orderer     x86_64-1.0.0-alpha   5685fd77ab7c        7 days ago          182 MB
  12. hyperledger/fabric-peer        latest               784c5d41ac1d        7 days ago          184 MB
  13. hyperledger/fabric-peer        x86_64-1.0.0-alpha   784c5d41ac1d        7 days ago          184 MB
  14. hyperledger/fabric-javaenv     latest               a08f85d8f0a9        7 days ago          1.42 GB
  15. hyperledger/fabric-javaenv     x86_64-1.0.0-alpha   a08f85d8f0a9        7 days ago          1.42 GB
  16. hyperledger/fabric-ccenv       latest               91792014b61f        7 days ago          1.29 GB
  17. hyperledger/fabric-ccenv       x86_64-1.0.0-alpha   91792014b61f        7 days ago          1.29 GB

现在运行完整脚本：

  1. ./network_setup.sh up <channel-ID>

如果没有设置channel-ID参数，channel名默认是mychannel。脚本执行成功后输出：

  1. ===================== Query on PEER3 on channel 'mychannel' is successful =====================
  3. ===================== All GOOD, End-2-End execution completed =====================

此时，网络启动运行并测试成功。

清理

停止网络：

  1. # 在e2e_cli目录下
  2. docker rm -f $(docker ps -aq)

然后执行docker images命令查看Chaincode镜像，类似输出如下：

  1. REPOSITORY                     TAG                  IMAGE ID            CREATED             SIZE
  2. dev-peer3-mycc-1.0             latest               13f6c8b042c6        5 minutes ago       176 MB
  3. dev-peer0-mycc-1.0             latest               e27456b2bd92        5 minutes ago       176 MB
  4. dev-peer2-mycc-1.0             latest               111098a7c98c        5 minutes ago       176 MB

删除这些镜像：

  1. docker rmi <IMAGE ID> <IMAGE ID> <IMAGE ID>

例如：

  1. docker rmi -f 13f e27 111

最后删除配置结果，在crypto/orderer目录删除orderer.block和channel.tx。

configtxgen

configtxgen工具生成两个内容： Orderer的bootstrap block和Fabric的channel configuration transaction。

orderer block是ordering服务的创世区块；channel transaction文件在create channel时会被广播给orderer。

configtx.yaml包含网络的定义，并给出了网络组件的拓扑结构—2个成员（Org0和Org1）分别管理维护2个peer。还指出每个网络实体的加密材料的存储位置。crypto目录包含每个实体的admin证书、ca证书、签名证书和私钥。

为了方便使用，我们提供了一个脚本generateCfgTrx.sh，该脚本整合了configtxgen的执行过程，执行后会生成两个配置结果：orderer.block和channel.tx。如果你运行过上边的network_setup.sh则这两个配置结果已生成，要先到crypto/orderer目录将之删除。

执行generateCfgTrx.sh脚本

在e2e_cli目录下：

  1. cd $GOPATH/src/github.com/hyperledger/fabric/examples/e2e_cli

generateCfgTrx.sh脚本有个可选参数channel-ID，如果不设此参数，则默认为mychannel。

  1. # 如上所述，<channel-ID> 参数是可选的
  2. ./generateCfgTrx.sh <channel-ID>

执行成功后输出：

  1. 2017/02/28 17:01:52 Generating new channel configtx
  2. 2017/02/28 17:01:52 Creating no-op MSP instance
  3. 2017/02/28 17:01:52 Obtaining default signing identity
  4. 2017/02/28 17:01:52 Creating no-op signing identity instance
  5. 2017/02/28 17:01:52 Serializing identity
  6. 2017/02/28 17:01:52 signing message
  7. 2017/02/28 17:01:52 signing message
  8. 2017/02/28 17:01:52 Writing new channel tx

生成的orderer.block和channel.tx两个文件存放在crypto/orderer目录。

orderer.block是ordering服务的创世区块，channel.tx包含新channel的配置信息。如前所述，这俩文件都来自configtx.yaml及其所包含的加密材料和网络信息的数据。

注意：也可手动执行脚本generateCfgTrx.sh里的命令。如果使用这种方式，则必须先用e2e_cli目录下的configtx.yaml替换Fabric sampleconfig目录下默认的configtx.yaml，然后返回fabric目录执行这些命令，前提是删除之前generateCfgTrx.sh生成的两个文件。

启动网络

使用docker-compose启动网络，如果没有拉取Fabric镜像，则返回之前的操作去拉取镜像。

脚本script.sh嵌入到docker-compose文件里，该脚本将peer加入到channel并向peer发送read/write请求，如此便可自动执行交易流程。如果不想使用这个脚本自动执行交易，可以跳到下面“手动执行交易”一节。

在e2e_cli目录下使用docker-compose生成网络实体并执行嵌入的脚本：

  1. CHANNEL_NAME=<channel-id> docker-compose up -d

如果之前创建了一个channel名，就必须将其作为参数，否则使用默认的mychannel。例如：

  1. CHANNEL_NAME=mychannel docker-compose up -d

等待一会儿，因为背后有交易会发送到peer。执行docker ps查看运行状态的container，可以看到如下内容：

  1. vagrant@hyperledger-devenv:v0.3.0-4eec836:/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli$ docker ps
  2. CONTAINER ID        IMAGE                        COMMAND                  CREATED              STATUS              PORTS                                              NAMES
  3. 45e3e114f7a2        dev-peer3-mycc-1.0           "chaincode -peer.a..."   4 seconds ago        Up 4 seconds                                                           dev-peer3-mycc-1.0
  4. 5970f740ad2b        dev-peer0-mycc-1.0           "chaincode -peer.a..."   24 seconds ago       Up 23 seconds                                                          dev-peer0-mycc-1.0
  5. b84808d66e99        dev-peer2-mycc-1.0           "chaincode -peer.a..."   48 seconds ago       Up 47 seconds                                                          dev-peer2-mycc-1.0
  6. 16d7d94c8773        hyperledger/fabric-peer      "peer node start -..."   About a minute ago   Up About a minute   0.0.0.0:10051->7051/tcp, 0.0.0.0:10053->7053/tcp   peer3
  7. 3561a99e35e6        hyperledger/fabric-peer      "peer node start -..."   About a minute ago   Up About a minute   0.0.0.0:9051->7051/tcp, 0.0.0.0:9053->7053/tcp     peer2
  8. 0baad3047d92        hyperledger/fabric-peer      "peer node start -..."   About a minute ago   Up About a minute   0.0.0.0:8051->7051/tcp, 0.0.0.0:8053->7053/tcp     peer1
  9. 1216896b7b4f        hyperledger/fabric-peer      "peer node start -..."   About a minute ago   Up About a minute   0.0.0.0:7051->7051/tcp, 0.0.0.0:7053->7053/tcp     peer0
  10. 155ff8747b4d        hyperledger/fabric-orderer   "orderer"                About a minute ago   Up About a minute   0.0.0.0:7050->7050/tcp                             orderer

背后发生了什么？

  • 在CLI容器中执行了脚本script.sh。该脚本用默认的mychannel执行createChannel命令，这个命令用到了之前configtxgen工具生成的channel.tx。
  • createChannel执行后会生成一个创世区块mychannel.block并保存到当前目录。
  • 对4个peer分别执行joinChannel命令，通过初始区块mychannel.block加入channel。至此，有一个channel包含4个peer和2个organization。
  • PEER0和PEER1属于Org0，PEER2和PEER3属于Org1。这些关系的定义都在configtx.yaml中
  • Chaincode chaincode_example02被install到PEER0和PEER2
  • 然后Chaincode在PEER2上instantiate。实例化是指启动容器和初始化与Chaincode相关的键值对，本例中的初始值是[“a”,”100” “b”,”200”]。实例化的结果是一个名为dev-peer2-mycc-1.0的容器启动，注意，这个容器仅是针对PEER2。（译注：尤其注意这里仅仅是启动了一个container）
  • 实例化时还会带有背书策略参数，本例中背书策略为`-P “OR (‘Org0MSP.member’,’Org1MSP.member’)”，意思是任何交易必须由绑定到Org0或者Org1的peer背书。
  • 对于“a”的query请求发送到PEER0。在之前Chaincode被install到PEER0了，所以就可以启动一个名为dev-peer0-mycc-1.0的新容器，然后返回查询结果。由于没有write操作发生，所以“a”的值依然是“100”。
  • 从“a“转移”10“给”b”的invoke请求发送到PEER0
  • Chaincode install到PEER3
  • 对“a”的query请求发送到PEER3。这启动了第三个名为dev-peer3-mycc-1.0的容器，并返回查询结果90，正确的反映了之前的交易。

这表明了什么？

Chaincode必须被install到一个peer上才能成功的对这个peer的ledger执行read/write操作。此外，只有当在peer上针对chaincode执行read/write操作时，这个peer上才会启动该chaincode 容器。（比如，查询“a”的值）交易导致容器启动。channel中的所有peer（包括那些没有install chaincode的peer，就像上例中的PEER3）都会维护一个准确的ledger，ledger包含存储了不可变的、有序的交易记录的block，还有维护current state的statedb。在peer上install chaincode之后就可以直接使用该peer上的chaincode了（就像上例中的PEER3），因为之前已经instantiate过了 （译注：即同一channel中的chaincode只需一次instantiate）。

查看交易

查看CLI容器的log：

  1. docker logs -f cli

输出：

  1. 2017-02-28 04:31:20.841 UTC [logging] InitFromViper -> DEBU 001 Setting default logging level to DEBUG for command 'chaincode'
  2. 2017-02-28 04:31:20.842 UTC [msp] GetLocalMSP -> DEBU 002 Returning existing local MSP
  3. 2017-02-28 04:31:20.842 UTC [msp] GetDefaultSigningIdentity -> DEBU 003 Obtaining default signing identity
  4. 2017-02-28 04:31:20.843 UTC [msp] Sign -> DEBU 004 Sign: plaintext: 0A8F050A59080322096D796368616E6E...6D7963631A0A0A0571756572790A0161
  5. 2017-02-28 04:31:20.843 UTC [msp] Sign -> DEBU 005 Sign: digest: 52F1A41B7B0B08CF3FC94D9D7E916AC4C01C54399E71BC81D551B97F5619AB54
  6. Query Result: 90
  7. 2017-02-28 04:31:30.425 UTC [main] main -> INFO 006 Exiting.....
  8. ===================== Query on chaincode on PEER3 on channel 'mychannel' is successful =====================
  10. ===================== All GOOD, End-2-End execution completed =====================

你也可以实时查看日志，需要打开两个终端。

首先，停止运行着的docker容器：

  1. docker rm -f $(docker ps -aq)

在第一个终端启动docker-compose脚本：

  1. # add the appropriate CHANNEL_NAME parm
  2. CHANNEL_NAME=<channel-id> docker-compose up -d

在第二个终端查看log：

  1. docker logs -f cli

这将实时输出通过script.sh执行的交易信息。

查看chaincode日志

对每个chaincode容器单独查看log，输出：

  1. $ docker logs dev-peer2-mycc-1.0
  2. 04:30:45.947 [BCCSP_FACTORY] DEBU : Initialize BCCSP [SW]
  3. ex02 Init
  4. Aval = 100, Bval = 200
  6. $ docker logs dev-peer0-mycc-1.0
  7. 04:31:10.569 [BCCSP_FACTORY] DEBU : Initialize BCCSP [SW]
  8. ex02 Invoke
  9. Query Response:{"Name":"a","Amount":"100"}
  10. ex02 Invoke
  11. Aval = 90, Bval = 210
  13. $ docker logs dev-peer3-mycc-1.0
  14. 04:31:30.420 [BCCSP_FACTORY] DEBU : Initialize BCCSP [SW]
  15. ex02 Invoke
  16. Query Response:{"Name":"a","Amount":"90"}

手动执行交易

停止所有容器：

  1. docker rm -f $(docker ps -aq)

然后，执行docker images命令查看chaincode镜像，会有类似以下内容：

  1. REPOSITORY                     TAG                  IMAGE ID            CREATED             SIZE
  2. dev-peer3-mycc-1.0             latest               13f6c8b042c6        5 minutes ago       176 MB
  3. dev-peer0-mycc-1.0             latest               e27456b2bd92        5 minutes ago       176 MB
  4. dev-peer2-mycc-1.0             latest               111098a7c98c        5 minutes ago       176 MB

删除这些镜像：

  1. docker rmi <IMAGE ID> <IMAGE ID> <IMAGE ID>

比如：

  1.   docker rmi -f 13f e27 111

确保之前生成的配置内容还在，如果删除了就再执行脚本：

  1. ./generateCfgTrx.sh <channel-ID>

或者使用脚本中的命令手动生成。

修改docker-compose文件

打开docker-compose文件注释掉执行script.sh脚本的命令，如下：

  1. working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
  2. # command: /bin/bash -c './scripts/script.sh ${CHANNEL_NAME}'

保存文件，重启网络：

  1. # 在e2e_cli目录下执行，设置正确的CHANNEL_NAME
  2. CHANNEL_NAME=<channel-id> docker-compose up -d

命令语法

参照script.sh脚本中的create和join命令。下面的命令只是针对PEER0的，当对orderer和peer执行命令时，需要修改下面给出的四个环境变量的值。

  1. # 对PEER0所用的环境变量
  2. CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer0/localMspConfig
  3. CORE_PEER_ADDRESS=peer0:7051
  4. CORE_PEER_LOCALMSPID="Org0MSP"
  5. CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/    peer0/localMspConfig/cacerts/peerOrg0.pem

每个peer的环境变量的值都在docker-compose文件中

Create channel

进去cli容器：

  1. docker exec -it cli bash

执行成功输出：

  1. root@0d78bb69300d:/opt/gopath/src/github.com/hyperledger/fabric/peer#

用-c指定channel name，-f指定channel configuration transaction（此例中是channel.tx），当然也可以使用不同的名称安装 configuration transaction。

  1. # channel.tx 和 orderer.block 在 cli 容器的 crypto/orderer 目录下
  2.  peer channel create -o orderer0:7050 -c mychannel -f crypto/orderer/channel.tx --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem

由于此例的peer channel create命令是针对orderer的，所以需要修改之前的环境变量，因此上边的命令应该是：

  1. CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig CORE_PEER_LOCALMSPID="OrdererMSP" peer channel create -o orderer0:7050 -c mychannel -f crypto/orderer/channel.tx --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem

注意：下面的其他命令依然在CLI容器中执行，而且要记住命令里每个peer对应的环境变量

Join channel

将指定的peer加入到channel：

  1. # 默认只将 PEER0 加入
  2.  peer channel join -b mychannel.block

完整的命令应该是：

  1. CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer0/localMspConfig CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_LOCALMSPID="Org0MSP" CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer0/localMspConfig/cacerts/peerOrg0.pem peer channel join -b mychannel.block

修改这四个环境变量将其他的peer加入到channel中

Install chaincode

将示例chaincode代码安装到四个对等节点中的一个：

  1. # 在命令前面要加上peer对应的四个环境变量
  2. peer chaincode install -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02

Instantiate chaincode

在一个peer上实例化chaincode，这将对该peer启动一个chaincode容器，并为该chaincode设置背书策略。此例中定义的策略是有Org0或Org1中的一个peer背书即可。命令如下：

  1. # 在命令前面要加上peer对应的四个环境变量
  2. # 用 -C 参数设置正确的channel名，默认是 mychannel
  3. peer chaincode instantiate -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02 -c '{"Args":["init","a", "100", "b","200"]}' -P "OR ('Org0MSP.member','Org1MSP.member')"

Invoke chaincode

  1. # 在命令前面要加上peer对应的四个环境变量
  2. peer chaincode invoke -o orderer0:7050  --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem  -C mychannel -n mycc -c '{"Args":["invoke","a","b","10"]}'

Query chaincode

  1. # 在命令前面要加上peer对应的四个环境变量
  2. peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'

执行结果：

  1. Query Result: 90

手动构建镜像

构建peer和orderer镜像：

  1. # 在fabric目录下执行，如果不能顺利生成镜像，则使用vagrant环境
  2. make peer-docker orderer-docker

执行docker images命令输出：

  1. vagrant@hyperledger-devenv:v0.3.0-4eec836:/opt/gopath/src/github.com/hyperledger/fabric$ docker images
  2. REPOSITORY                     TAG                             IMAGE ID            CREATED             SIZE
  3. hyperledger/fabric-orderer     latest                          264e45897bfb        10 minutes ago      180 MB
  4. hyperledger/fabric-orderer     x86_64-0.7.0-snapshot-a0d032b   264e45897bfb        10 minutes ago      180 MB
  5. hyperledger/fabric-peer        latest                          b3d44cff07c6        10 minutes ago      184 MB
  6. hyperledger/fabric-peer        x86_64-0.7.0-snapshot-a0d032b   b3d44cff07c6        10 minutes ago      184 MB
  7. hyperledger/fabric-javaenv     latest                          6e2a2adb998a        10 minutes ago      1.42 GB
  8. hyperledger/fabric-javaenv     x86_64-0.7.0-snapshot-a0d032b   6e2a2adb998a        10 minutes ago      1.42 GB
  9. hyperledger/fabric-ccenv       latest                          0ce0e7dc043f        12 minutes ago      1.29 GB
  10. hyperledger/fabric-ccenv       x86_64-0.7.0-snapshot-a0d032b   0ce0e7dc043f        12 minutes ago      1.29 GB
  11. hyperledger/fabric-baseimage   x86_64-0.3.0                    f4751a503f02        4 weeks ago         1.27 GB
  12. hyperledger/fabric-baseos      x86_64-0.3.0                    c3a4cf3b3350        4 weeks ago         161 MB

使用本地二进制文件

进去vagrant环境：

  1. cd $GOPATH/src/github.com/hyperledger/fabric/devenv
  3. # 第一次启动VM用 vagrant up 
  4. vagrant ssh

在fabric目录下编译peer和orderer：

  1. make clean
  2. make native

生成ccenv镜像：

  1. make peer-docker

然后打开两个终端都进入vagrant，至此有三个终端都在vagrant里。

前首先清空ledger文件夹/var/hyperledger/（每次运行后，为避免错误或重复，都要清空）:

  1. rm -rf /var/hyperledger/*

终端1

使用configtxgen工具创建orderer创世区块：

  1. configtxgen -profile SampleSingleMSPSolo -outputBlock orderer.block

终端2

用刚生成的创世区块启动orderer：

  1. ORDERER_GENERAL_GENESISMETHOD=file ORDERER_GENERAL_GENESISFILE=./orderer.block orderer

终端1

创建 channel configuration transaction：

  1. configtxgen -profile SampleSingleMSPSolo -outputCreateChannelTx channel.tx -channelID <channel-ID>

执行成功会在当前目录生成channel.tx

终端3

以chainless模式启动peer：

  1. peer node start --peer-defaultchain=false

Create channel

以channel.tx为参数创建channel：

  1. peer channel create -o 127.0.0.1:7050 -c mychannel -f channel.tx

执行后在当前目录生成一个channel的创世区块mychannel.block

Join channel

通过channel的创世区块mychannel.block加入channel：

  1. peer channel join -b mychannel.block

Install chaincode

在peer上安装chaincode：

  1. peer chaincode install -o 127.0.0.1:7050 -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02

执行成功后查看文件可以看到mycc.1.0:

  1. ls /var/hyperledger/production/chaincodes

Instantiate chaincode

实例化chaincode：

  1. peer chaincode instantiate -o 127.0.0.1:7050 -C mychannel -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02 -c '{"Args":["init","a", "100", "b","200"]}'

docker ps查看运行中的容器，如果chaincode启动成功，则显示：

  1. CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS               NAMES
  2. bd9c6bda7560        dev-jdoe-mycc-1.0   "chaincode -peer.a..."   5 seconds ago       Up 5 seconds                            dev-jdoe-mycc-1.0

Invoke chaincode

调用chaincode从“a”转移“10”给“b“：

  1. peer chaincode invoke -o 127.0.0.1:7050 -C mychannel -n mycc -c '{"Args":["invoke","a","b","10"]}'

Query chaincode

查询”a“的值：

  1. # 返回值应是 90
  2. peer chaincode query -o 127.0.0.1:7050 -C mychannel -n mycc -c '{"Args":["query","a"]}'

运行完成后不要忘记清空ledger文件夹/var/hyperledger/：

  1. rm -rf /var/hyperledger/*

使用CouchDB

可以将stateDB默认的goleveldb替换成CouchDB。对于CouchDB，chaincode各功能依然可用，但将chaincode数据以JSON方式存储的话就可使用CouchDB的复杂查询的功能。

为了使用CouchDB，除了最前面的”前提“一节的操作外，还需要下边两步启动CouchDB容器并将之与peer容器关联：

  • 构建CouchDB镜像：

    1.   # make sure you are in the fabric directory
    2.   make couchdb

  • 编辑fabric/examples/e2e_cli/docker-compose.yaml和docker-compose.yam，将所有与CouchDB有关的内容取消注释。这样chaincode_example02就可以才CouchDB下运行了。

注意：如果将CouchDB容器的端口映射的主机，请一定要注意安全。在开发环境中将端口映射出来可以通过CouchDB的web界面可视化操作数据。生产环境中一般不会做端口映射，以限制CouchDB的外部访问。

可以用chaincode_example02在CouchDB下执行上边的chaincode操作，但是为了使用CouchDB的复杂查询功能，chaincode数据一定要以JSON格式存储（例如fabric/examples/chaincode/go/marbles02）。

使用手动执行交易这一节中的步骤install、instantiate、invoke和query marbles02，执行完Join channel这步后使用下边的命令操作marbles02：

  • 在PEER0上安装并实例化chaincode

    1.   peer chaincode install -o orderer0:7050 -n marbles -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/marbles02
    2.   peer chaincode instantiate -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/marbles02 -c '{"Args":["init"]}' -P "OR ('Org0MSP.member','Org1MSP.member')"

  • 创建一些marble并移动它们

    1.   peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -c '{"Args":["initMarble","marble1","blue","35","tom"]}'
    2.   peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -c '{"Args":["initMarble","marble2","red","50","tom"]}'
    3.   peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -c '{"Args":["initMarble","marble3","blue","70","tom"]}'
    4.   peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -c '{"Args":["transferMarble","marble2","jerry"]}'
    5.   peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -c '{"Args":["transferMarblesBasedOnColor","blue","jerry"]}'
    6.   peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n marbles -c '{"Args":["delete","marble1"]}'

  • 如果做了CouchDB容器的端口映射，可以通过web界面查看数据，可以看到名为mychannel的数据库及其文档

    • 如果使用的是vagrant环境

      1.   http://localhost:15984/_utils

    • 如果不是vagrant环境，使用CouchDB容器指定的端口

      1.   http://localhost:5984/_utils

  • 可有规律的查询chaincode（例如，读取marble2）

    1.   peer chaincode query -C mychannel -n marbles -c '{"Args":["readMarble","marble2"]}'

    可以看到marble2的详细信息：

    1.   Query Result: {"color":"red","docType":"marble","name":"marble2","owner":"jerry","size":50}

    获取marble1的历史：

    1.   peer chaincode query -C mychannel -n marbles -c '{"Args":["getHistoryForMarble","marble1"]}'

    可以看到操作过marble1的交易：

    1.   Query Result: [{"TxId":"1c3d3caf124c89f91a4c0f353723ac736c58155325f02890adebaa15e16e6464", "Value":{"docType":"marble","name":"marble1","color":"blue","size":35,"owner":"tom"}},{"TxId":"755d55c281889eaeebf405586f9e25d71d36eb3d35420af833a20a2f53a3eefd", "Value":{"docType":"marble","name":"marble1","color":"blue","size":35,"owner":"jerry"}},{"TxId":"819451032d813dde6247f85e56a89262555e04f14788ee33e28b232eef36d98f", "Value":}]

    还可以执行复杂查询，比如查询jerry所拥有的marble：

    1.   peer chaincode query -C mychannel -n marbles -c '{"Args":["queryMarblesByOwner","jerry"]}'

    查询结果为jerry所拥有的2个marble的信息：

    1.   Query Result: [{"Key":"marble2", "Record":{"color":"red","docType":"marble","name":"marble2","owner":"jerry","size":50}},{"Key":"marble3", "Record":{"color":"blue","docType":"marble","name":"marble3","owner":"jerry","size":70}}]

    通过owner字段等于jerry查询：

    1.   peer chaincode query -C mychannel -n marbles -c '{"Args":["queryMarbles","{\"selector\":{\"owner\":\"jerry\"}}"]}'

    查询结果如下：

    1.   Query Result: [{"Key":"marble2", "Record":{"color":"red","docType":"marble","name":"marble2","owner":"jerry","size":50}},{"Key":"marble3", "Record":{"color":"blue","docType":"marble","name":"marble3","owner":"jerry","size":70}}]

数据持久化

如果需要对peer或CouchDB容器的数据持久化，一种选择是将容器的相关目录挂在到docker主机。例如，将下面两行内容放到docker-compose.yaml文件中的对应peer处：

  1. volumes:
  2.  - /var/hyperledger/peer0:/var/hyperledger/production

将下面两行放到对应的CouchDB处：

  1. volumes:
  2.  - /var/hyperledger/couchdb0:/opt/couchdb/data

故障排出

  • 每次运行后要清理文件

  • 如果出现docker错误，则删除镜像，从头再操作一遍

    1.   make clean
    2.   make peer-docker orderer-docker

  • 如果出现下面的错误

    1.   Error: Error endorsing chaincode: rpc error: code = 2 desc = Error installing chaincode code mycc:1.0(chaincode /var/hyperledger/production/chaincodes/mycc.1.0 exits)

    chaincode镜像（如dev-peer0-mycc-1.0或dev-peer1-mycc-1.0）可能是以前运行过的。删除它们然后重试。

    1.   docker rmi -f $(docker images | grep peer[0-9]-peer[0-9] | awk '{print $3}')

  • 使用down选项清理网络

    1.   ./network_setup.sh down
    2.   Next  Previous