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

作者:陳兆麟 Email:[email protected]

在 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。

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

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

作者:陳兆麟 Email:[email protected]

開發環境:Win7 (64 bit) ,Docker Toolbox, blockchain, postman

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

2. 參考附錄 (1) 在 Win7安裝 Docker Toolbox (安裝最新版)

3. 桌面點選 (Docker Quickstart Terminal)

$ docker -v

$ docker-machine ls (Docker Quickstart Terminal接口執行,確認虛擬機default 已安裝)

$ docker-machine env default

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

$ docker-machine ls (確定虛擬機已經啓動)

$pwd

$docker pull hyperledger/fabric-peer:latest

$docker pull hyperledger/fabric-membersrvc:latest

$ docker images

$mkdir docker_blockchain

$cd docker_blockchain

$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

#ls

# go build ./ (編譯 chaincode_example02.go)

# ls

# 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)

7. 檢視已建立的 blockchain network

8. User 至 vp0 (validating peer 0) 註冊登錄:

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

10. a 轉移 b 10單元

11. 詢問是否a 剩下90

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

13. 模仿本例步驟可將先前 bluemix blockchain service 的範例:

附錄:

參考文獻: