理论基础
Hyperledger Fabric提供了一个基于docker和docker-compose的“单机版环境”,同时,peer节点可以运行在一种特殊的“devmode”下。这种模式下,peer不会自己启动特定的链码容器,允许我们使用调试模式直接运行一个链码程序,并让他连接到peer上。
更详细的说明可以参考官方文档:https://hyperledger-fabric.readthedocs.io/en/release-1.4/peer-chaincode-devmode.html
VS Code插件
自己手动安装和应用”单机版环境“还是比较繁琐的。好在我们有VS Code以及“IBM Blockchain Platform”插件 https://marketplace.visualstudio.com/items?itemName=IBMBlockchain.ibm-blockchain-platform
就让我们来看看怎么在VS Code环境里搞定Fabric的合约开发、调试、部署整个流程吧!
环境准备
VS Code V1.32 或更高版本。 https://code.visualstudio.com/
Docker V17.06.2-ce 或更高版本。 https://www.docker.com/get-started
Docker Compose V1.14.0 或更高版本。 https://docs.docker.com/compose/install/
如果要开发 Go 智能合同,那么需要安装 Go V1.12 或更高版本。 https://golang.org/dl/
如果要开发 Node 智能合同,那么需要安装 Node V8.x 或更高版本以及 npm V5.x 或更高版本。 https://nodejs.org/en/download/
如果要开发 Java 智能合同,那么需要安装 Java JDK V8。 https://openjdk.java.net/install/
这些都准备完成,通过IBM Blockchain Platform插件的检查后,我们就可以继续啦!
开发chaincode
这里我们就以Fabric官方golang版本的chaincode_example02为例。看看怎么打包、部署、调试chaincode。
注意:
区块链插件不会理解go语言插件中对于GOPATH的设置,因此启动VS Code前需要确保导出来GOPATH环境变量
export GOPATH=<你的GOPATH>
启动VS Code,打开合约项目:
cd $GOPATH
mkdir -p github.com/hyperledger
cd github.com/hyperledger
git clone https://github.com/hyperledger/fabric-samples
cd fabric-samples/chaincode/chaincode_example02/go/
code .
打包合约、启动本地Fabric网络
我们可以在VS Code的左侧找到插件入口。
- 通过插件的SMART CONCONTRACTS->Package Open Project来打包chaincode。点击后插件会提示你输入链码的名称和版本。这里我的链码取名为gocc,版本1.0。
通过插件的FABRIC ENVIRONMENTS->Local Fabric,来启动一个本地Fabric网络。
- 启动会比较慢,需要拉一堆docker镜像,请大家耐心等待。
- 插件就是封装了官方的单机版,如果过程中出错,可以在VS Code的输出中看到错误信息。
安装、实例化链码
当我们打包完成,并且启动了本地Fabric网络后,就可以安装、实例化链码了。
通过插件的FABRIC ENVIRONMENTS->+Install来安装链码。
- 选择之前我们创建的gocc@1.0。
通过插件的FABRIC ENVIRONMENTS->+Instantiate来实例化链码。
- 选择我们之前创建并安装的gocc@1.0
- 输入初始化函数 init
- 输入函数初始化参数 ["a","100","b","200"]
- collection config file配置选择No(这是一个链码的高级安全功能,后续的系列文章会有介绍)
调用链码
通过插件提供的Evaluate Transaction和Submit Transaction来调用链码(shift+command+p 是VS Code的插件命令快捷键,调出后输入tran,可以快速找到这些功能)
- 选择链码:gocc@1.0
- 输入函数:query
- 输入参数:["a"]
- 输入transient data,我们直接回车(这也是链码的高级安全功能,后续的系列文章会有介绍)
- 我们可以在VS Code的输出窗口看到查询结果,a的余额有100
调试链码
在VS Code调试界面新增加一个调试配置。选择Go智能合约debug配置。
然后我们需要给合约运行加上必要的环境变量,目前只有一个"CORE_PEER_TLS_ENABLED":"false"是必须的。
配置完成后,就可以用VS Code的调试功能运行这个合约了。运行前系统会要去我们填写合约的名称和版本,在这个例子中,合约名称就是gocc,版本1.0
我们可以为程序设置断点。我们可以使用之前的方法调用链码。在调用链码过程中,程序就会停在断点上了。示例的这次调用,我故意填写了一个不存在的账户"A",通过单步调试,可以看到,调试中程序走到了相应逻辑中,最后报错返回。
上云
好啦,看到这里,相信本地链码的开发、调试都难不倒你了。那么有什么办法能方便的发布链码到云上呢?答案就是另一款VS Code插件:AlibabaCloud BaaS VS Code Extension
联系我们
欢迎感兴趣的同学加入钉钉群(钉钉群号: 23181816)。