在 Win7 使用 Docker Image 在 Local Machine 建构 Blockchain Network System

作者:陳兆麟 Email:chenlin2@ms9.hinet.net

在 local machine 建立 blockchain network有2 种方法, 1)使用包含 hyperledger/fabric的 dokcer images或2)直接在本机使用 hyperledger/fabric 源码,为了让问题简单化(编译 source code 可能会失败),先使用储存在docker hub的 docker images,建构 local blockchain netwok,测试原先在 bluemix blockchain service 使用的范例。将blockchain 做成 docker images 是一重要程序,你可以将已开发完毕客制化的 docker images 放在支持 docker 的云端平台提供客户使用;以下范例使用 postman 执行 REST API 开发 local blockchain netwok内之chaincode (智能合约) 。

开发环境:Win7 (64 bit) ,Docker Toolbox, blockchain, postman

1.win7 安装 cygwin (https://cygwin.com/install.html)

将安装之执行文件目录 (C:\cygwin64\bin) 设定在控制台系统 path 变量

2. 参考附录 (1) 在 Win7安装 Docker Toolbox (安装最新版)

(Win 10 可直接安装 Docker 请参考附录2 )

3. 桌面点选 (Docker Quickstart Terminal)

$ docker -v

Docker version 1.12.0, build 8eab29e

$ docker-machine ls (Docker Quickstart Terminal接口执行,确认虚拟机default 已安装)

NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS default virtualbox Running tcp://192.168.99.101:2376 v1.10.3

$ docker-machine env default

SET DOCKER_TLS_VERIFY=1 SET DOCKER_HOST=tcp://192.168.99.100:2376 SET DOCKER_CERT_PATH=C:\Users\user\.docker\machine\machines\default SET DOCKER_MACHINE_NAME=default REM Run this command to configure your shell: REM FOR /f "tokens=*" %i IN ('docker-machine env default') DO %i

$ FOR /f “tokens=*” %i IN (‘docker-machine env default’) DO %i

$ docker-machine ls (确定虚拟机已经启动)

NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS default * virtualbox Running tcp://192.168.99.100:2376 v1.10.3

$pwd

#/Users/user

$docker pull hyperledger/fabric-peer:latest

$docker pull hyperledger/fabric-membersrvc:latest

$ docker images

hyperledger/fabric-peer latest af109e2bfebc 7 days a go 1.422 GB hyperledger/fabric-membersrvc latest 16d2098ab252 7 days a go 1.415 GB

$mkdir docker_blockchain

$cd docker_blockchain

编辑 docker-compose.yml (如附录 4)

$docker-compose up (启动 container)

4. 使用 putty (见附录 3)登录虚拟机器(ip:192.168.99.100 username=docker password=tcuser)

$docker ps (container已被启动)

5 进入 fabric-peer container shell (汇入chaincode_example02.go)

$docker exec -it dockerblockchain_vp0_1 bash

root@6ce0d68446e3:/opt/gopath/src/github.com/hyperledger/fabric

#mkdir -p $GOPATH/src/github.com/chaincode_example02/

#cd $GOPATH/src/github.com/chaincode_example02

#curl GET https://raw.githubusercontent.com/hyperledger/fabric/master/examples/chaincode/go/chaincode_example02/chaincode_example02.go > chaincode_example02.go

#ls

chaincode_example02.go

# go build ./ (编译 chaincode_example02.go)

# ls

chaincode_example02 chaincode_example02.go

# export CORE_CHAINCODE_ID_NAME=mycc

#export CORE_PEER_ADDRESS=0.0.0.0:7051

#./chaincode_example02 & (chaincode 启动接收外界送来的交易)

6. 在 win7下载安装 Postman (Postman-win64-4.7.1-Setup.exe)

https://www.getpostman.com/apps Postman 具有好用的人机接口,藉REST API 与 Blockchain Netwok 沟通

7. 检视已建立的 blockchain network

REST API字段输入:http://192.168.99.100:7050/network/peers 192.168.99.100 (来自虚拟机器default之IP), 7050定义于docker-compose.yml

8. User 至 vp0 (validating peer 0) 注册登录:

REST API字段输入: http://192.168.99.100:7050/registrar { “enrollId”: “jim”, “enrollSecret”: “6avZQLwcUe9b”

9. 初始设定 a=100 b=200

REST API字段输入: http://192.168.99.100:7050/chcincode 执行init function args:[“a”, “100”, “b”, “200”] { “jsonrpc”: “2.0”, “method”: “deploy”, “params”: { “type”: 1, “chaincodeID”:{ “name”: “mycc” }, “ctorMsg”: { “function”:”init”, “args”:[“a”, “100”, “b”, “200”] }, “secureContext”: “jim” }, “id”: 1 }

10. a 转移 b 10单元

REST API字段输入: http://192.168.99.100:7050/chcincode 执行 invoke function args:[“a”, “b”, “10”] { “jsonrpc”: “2.0”, “method”: “invoke”, “params”: { “type”: 1, “chaincodeID”:{ “name”:”mycc” }, “ctorMsg”: { “function”:”invoke”, “args”:[“a”, “b”, “10”] }, “secureContext”: “jim” }, “id”: 3 }

11. 询问是否a 剩下90

REST API字段输入: http://192.168.99.100:7050/chcincode 执行 function:query, args:[“a”] { “jsonrpc”: “2.0”, “method”: “query”, “params”: { “type”: 1, “chaincodeID”:{ “name”:”mycc” }, “ctorMsg”: { “function”:”query”, “args”:[“a”] }, “secureContext”: “jim” }, “id”: 5 }

12. 本例步骤已存至postman_collection.jsonchaincode_example02.json (附錄 6)

当执行至步骤6 import json档后,依序点选项目(peers,login,init,invoke,read)即可执行相对 REST API。

13. 模仿本例步骤可将先前 bluemix blockchain service 的范例:

http://www.remkohde.com/2016/07/04/running-your-own-blockchain/ 转换至 local blockchain network 环境执行。

附录:

1.Win7 安装Docker Toolbox: https://www.docker.com/products/docker-toolbox http://knight-.iteye.com/blog/2254627 http://rominirani.com/2015/08/15/docker-toolbox-setup-windows/ https://getcarina.com/docs/troubleshooting/troubleshooting-windows-docker-vm-startup/ http://dockone.io/article/594 2.Win 10 安装Docker http://blog.miniasp.com/post/2016/08/01/Docker-for-Windows-1-12-Released.aspx 3.putty安装及使用: http://www.ascc.sinica.edu.tw/putty 4.docker-compose.yml (文字要对齐) https://1drv.ms/u/s!AkBmzWP0h-Vxgg74u_PQ9l9cRyta 5.Postman使用手册 http://www.jianshu.com/p/13c8017bb5c8 6.chaincode_example02.postman_collection.json网址 https://1drv.ms/u/s!AkBmzWP0h-VxggtvAjN_PPAYw6DZ 7.陈兆麟 facebook https://zh-cn.facebook.com/chaolin.chen.18

參考文獻:

1.https://github.com/hyperledger/fabric/blob/master/docs/Setup/Chaincode-setup.md 2.https://github.com/ibm-watson-iot/blockchain-samples 3.https://github.com/igorbarinov/awesome-blockchain 4.https://www.linkedin.com/pulse/blockchain-smart-contracts-health-booz-allen-hamilton-tori-adams 5.https://bitsonblocks.net/2015/09/09/a-gentle-introduction-to-blockchain-technology/ 6.https://www.ibm.com/internet-of-things/iot-news/announcements/private-blockchain/ 7.http://blockcan.com/news/topic/21040 8.https://www.ibm.com/internet-of-things/iot-news/announcements/private-blockchain/ 9.https://1drv.ms/f/s!AkBmzWP0h-Vxbr7h1uTNsTMcPWI 10.https://1drv.ms/b/s!AkBmzWP0h-VxazOBOsVz8nGMLpM 11.https://1drv.ms/b/s!AkBmzWP0h-VxbLK7FOjH9IL5HHc 12.https://www.youtube.com/watch?v=24JAF9Eu1mk&list=UUOTZe-b_jE_Ovy9K9UhZ4BA&index=74 13.https://www.youtube.com/watch?v=wSmJ-rwUo8I&list=UUOTZe-b_jE_Ovy9K9UhZ4BA&index=73 14.https://www.youtube.com/watch?v=SOsn6MvGH60&list=UUOTZe-b_jE_Ovy9K9UhZ4BA&index=72