fabric 链码本地开发调试 debug

Hyperledger fabric first-network dev-debug model

这里介绍的是链码运程调试详细教程, 使用windows系统对链码进行本地调试,MacOs系统链码调试类似

fabric 版本是:1.4.0

first-network项目的docker-compose 文件启动peer容器,添加 --peer-chaincodedev 参数

first-network/base 目录下的peer-base.yaml 添加–peer-chaincodedev

# Copyright IBM Corp. All Rights Reserved.
#
# SPDX-License-Identifier: Apache-2.0
#

version: '2'

services:
  peer-base:
    image: hyperledger/fabric-peer:$IMAGE_TAG
    environment:
      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
      # the following setting starts chaincode containers on the same
      # bridge network as the peers
      # https://docs.docker.com/compose/networking/
      - CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=${COMPOSE_PROJECT_NAME}_byfn
      - FABRIC_LOGGING_SPEC=INFO
      #- FABRIC_LOGGING_SPEC=DEBUG
      - CORE_PEER_TLS_ENABLED=false
      - CORE_PEER_GOSSIP_USELEADERELECTION=true
      - CORE_PEER_GOSSIP_ORGLEADER=false
      - CORE_PEER_PROFILE_ENABLED=true
      - CORE_PEER_TLS_CERT_FILE=/etc/hyperledger/fabric/tls/server.crt
      - CORE_PEER_TLS_KEY_FILE=/etc/hyperledger/fabric/tls/server.key
      - CORE_PEER_TLS_ROOTCERT_FILE=/etc/hyperledger/fabric/tls/ca.crt
    working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
    command: peer node start --peer-chaincodedev=true

peer节点调试端口(7052)映射到宿主机

first-network/base 目录下的docker-compose-base.yaml

peer0.org1.example.com 示例

 peer0.org1.example.com:
    container_name: peer0.org1.example.com
    extends:
      file: peer-base.yaml
      service: peer-base
    environment:
      - CORE_PEER_ID=peer0.org1.example.com
      - CORE_PEER_ADDRESS=peer0.org1.example.com:7051
      - CORE_PEER_GOSSIP_BOOTSTRAP=peer1.org1.example.com:7051
      - CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer0.org1.example.com:7051
      - CORE_PEER_LOCALMSPID=Org1MSP
    volumes:
        - /var/run/:/host/var/run/
        - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/msp:/etc/hyperledger/fabric/msp
        - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls:/etc/hyperledger/fabric/tls
        - peer0.org1.example.com:/var/hyperledger/production
    ports:
      - 7051:7051
      - 7052:7052
      - 7053:7053

关闭first-network的TLS后,启动first-network

orderer TLS关闭

修改first-network/base 目录下的docker-compose-base.yaml

orderer 容器配置为:

- ORDERER_GENERAL_TLS_ENABLED=false

ORDERER_GENERAL_TLS_ENABLED=false

peer TLS关闭

修改 first-network/base 目录下的peer-base.yaml

peer容器配置为:

- CORE_PEER_TLS_ENABLED=false

cli TLS关闭

修改first-network 目录下的docker-compose-cli.yaml

cli 容器配置为:

- CORE_PEER_TLS_ENABLED=false

配置修改完成后使用 byfn.sh启动fabric网络

./byfn.sh up

byfn.sh 脚本启动fabric网络之后,会自动安装实例化chaincode_example02.go链码.

自定义编写的链码,也可以安装到启动好之后的fabric网络中,进行实例化之后,也可以调用,也可以进行debug.

安装,实例化链码和往常操作一样,使用cli容器进行.

peer chaincode install -n 链码名 -v 1 -p 链码路径
peer chaincode instantiate -o orderer.example.com:7050 -C 通道名称 -n 链码名   -v 版本号 -c '{"Args":[""]}' -P "OR ('Org1MSP.member','Org2MSP.member')"

当然byfn.sh脚本启动的cli容器,默认连接peer节点是:peer0.org1.example.com(查看docker-compose-cli.yaml文件即可知道),所有使用cli容器安装后实例化链码,链码是安装在peer0.org1.example.com节点上的,其他节点上并安装链码. 但是这并不影响对链码的开发调试(dev-debug).

注意: 如果所有的peer节点都开启调试端口(7052),并且都有对应的宿主机端口映射,理论上都能进行链码调试,前提是该peer节点要安装链码

(链码调试最好将链码实例化在mychannel通道内,新建通道链码调试未验证)

使用idea对链码(go语言编写)进行debug调试

以官方转账链码(chaincode_example02.go)示例进行dev-debug

创建golang项目,将chancode_example02.go放入项目中, 修改package为 main

配置两个链码运行环境变量:

CORE_PEER_ADDRESS peer节点宿主机地址:调试端口

CORE_CHAINCODE_ID_NAME 链码名称:版本

CORE_PEER_ADDRESS=192.168.1.245:7052
CORE_CHAINCODE_ID_NAME=mycc:1.0

idea debug启动chancode_example02.go

启动成功如下:

断点调试链码

在peer节点运行的宿主机上,使用cli容器调用链码查询函数

注意: 第一次执行如果没有进入到断点, idea重启链码调试,重新执行一下命令

docker exec -it cli peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'

idea 控制台运行成功结果

链码调用成功结果