Hyperledger Fabric V1.0– 开发者快速入门
2017-06-28 16:56
726 查看
本文档演示使用Hyperledger Fabric V1.0来部署一个开发者环境并运行一个简单例子。文档包括创建和加入通道(账本)、客户端认证以及部署和调用智能合约。CLI将用于创建和加入通道(账本),NodeJS
SDK将用于客户端身份验证和使用账本的智能合约功能。
Docker Compose将用于创建包含三个Peer节点的联盟链、一个独立的Orderer和一个证书颁发机构(CA)。为了加快部署进度,预先生成了基于标准PKI实现的加密要素并打包进fabpre.tar.gz。证书颁发机构(CA)负责签发、撤销和维护代表一个企业的加密要素,这些要素提供给客户端(Node
SDK)用于身份认证。
Fabric网络将通过执行docker-compose自动生成,创建通道和加入通道的API将会自动被调用;同时,开发者也可以通过手动步骤生成自己的Fabric网络和通道(账本)或直接使用开发者模式进行应用开发。
v1.12 及更高版本
· Docker
Compose – v1.8 及更高版本
· Node.js –
v2.1.8 及更高版本
yum –y install docker.x86_64
yum –y install Python-pip
pip install docker-compose
yum –y install npm
验证npm安装:
npm install npm@latest
查看npm版本:
npm -v
·下载并安装 Curl 工具
· 创建 Fabric 工程和项目目录.
mkdir -p <workspace>
cd <workspace>
然后, 执行如下代码:
执行完这条命令,会下载并解压缩部署Fabric网络的相关组件 ,包括Docker Compose 脚本, 通道创建/加入脚本, 认证使用的加密要素等.
你当前目录看上去是这样的:
ls
ccenv channel_test.sh docker-compose.yml fabpre.tar.gz src tmp
你不需要手工拖取Docker镜像,通过执行docker-compose命令, fabric-peer, fabric-orderer, fabric-ca和 cli 都会自动下载、解压缩相关的镜像。
“join” – 使用 create 命令生成的创世区块向Peer节点发出加入通道的请求
1)确保 hyperledger/fabric-ccenv 镜像的标签是 latest:
执行docker-compose build
2)创建Fabric网络,创建通道(正本), 将Peer节点加入通道:
执行docker-compose up
3)查看你的容器:
docker ps
终端应该显示有6个独立运行的容器(3 个peer节点, 1个 独立的 orderer, CLI 和 CA). 嵌入在docker-compose.yml里的channel_test.sh会在CLI容器里执行创建通道和加入通道命令。执行结束,应该只有一个Fabric网络和一个通道(账本),通道包含三个节点peer0,Peer1,Peer2。
4)确保通道已成功创建,并且节点都成功加入:
执行docker exec -it cli sh
5)查看通道创建/节点加入的结果:
cat results.txt
屏幕显示的结果如下:
6)验证成功创建了创世块,执行如下命令:
ls -ltr myc1.block
· 创建案例程序目录:
mkdir –p test
这条命令会下载用于部署、调用和查询案例智能合约的 JavaScript 代码
,同时,它也包含了node SDK 依赖的模块
· 安装node 模块:
npm install
现在你已经拥有了全部Fabric网络运行需要的组件.
这个案例程序将通过Node SDK &APIs以及预先准备的CA认证所需的加密要素来实现客户端的登记、注册和登录。一旦客户端完成身份验证,就可以执行程序包含的智能合约功能(部署、调用、查询)。
1a)注册/登录 & 部署智能合约 (Linux or
OSX):
GOPATH=$PWD node deploy.js
1b)注册/登录& 部署智能合约 (Windows):
SET GOPATH=%cd%
node deploy.js
2)执行一个调用操作. 从 “a” 转移一定资产到 “b”:
node invoke.js
3)查询键值 “a”:
node query.js
你会在终端上得到一个数值为200的结果
你可以浏览NodeJS SDK 和APIs的文档来实现更多功能。
为了在CLI容器里手动执行创建通道和加入通道API,我们需要编辑Docker Compose文件。用任意文本编辑器打开docker-compose.yml注释掉channel_test.sh脚本,编辑操作如下:
cli:
container_name: cli
<CONTENT REMOVED FOR BREVITY>
working_dir: /opt/gopath/src/http://github.com/hyperledger/fabric/peer
# command: sh -c ‘./channel_test.sh; sleep 1000′
# command: /bin/sh
1)进入cli 容器:
docker exec -it cli sh
2)发送createChannel API 给 Orderer:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc1
3)发送joinchannel API 给 Peer0:
CreateChannel执行完毕将返回一个创世区块(myc1.block),然后你可以执行加入通道的指令,把Genesis block作为参数发送joinchannel API给 peer0。
注:通道的定义都保存在创世块内:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer0:7051 peer channel join -b myc1.block
4)如果想要加入其它节点,只需重新发送上述命令给peer1或Peer2即可
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer1:7051 peer channel join -b myc1.block
一旦全部Peer节点都加入了通道,你可以查询账本而无需在每个节点都部署智能合约。
1)运行部署命令:这个命令是在通道myc1上的Peer节点0上部署一个名叫MYCC的智能合约。构造函数把A和B的值分别初始化为100和200。
CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode deploy -C myc1 -n mycc -p http://github.com/hyperledger/fabric/examples -c
‘{“Args”:["init","a","100","b","200"]}’
2)运行调用命令:这个命令是从A移动10个单位到B
CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode invoke -C myc1 -n mycc -c ‘{“function”:”invoke”,”Args”:["move","a","b","10"]}’
3)运行查询命令:按照预期,查询a的返回值应该是90
CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode query -C myc1 -n mycc -c ‘{“function”:”invoke”,”Args”:["query","a"]}’
你可以在任何时间发出exit命令退出CLI容器。
1)如果已有容器在运行,执行docker-compose命令可能会收到报错,显示端口已被占用。如果发生这种情况,则需要杀死使用该端口的容器。
2)如果发现缺失部分文件,请确保Curl命令成功执行,并确保已经cd到了代码下载的目录。
3)如果你是用自动化步骤创建通道/加入通道的(即没有在yml文件注释channel_test.sh步骤),且通道myc1和创世区块myc1.block已经成功创建。这时,如果你想在CLI容器中手工执行后续的步骤:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc1
你可能看到类似的错误信息如下:
<EXACT_TIMESTAMP> UTC [msp] Sign -> DEBU 064 Sign: digest: 5ABA6805B3CDBAF16C6D0DCD6DC439F92793D55C82DB130206E35791BCF18E5F
Error: Got unexpected status: BAD_REQUEST
Usage:
peer channel create [flags]
这是因为你正试图创建一个重名的通道(myc1),这个通道已经存在!有两种解决方法,1)我们可以使用一个不同的通道名称来重新创建通道,例如:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc2
然后,执行加入通道指令:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer0:7051 peer channel join -b myc2.block
如果您选择创建一个新的通道,需要在config.json文件编辑“channelid”参数来匹配新的通道名称,例如:
2)如果你想继续使用原有的通道名称(myc1),可以删除所有的容器然后参照手动创建和加入通道部分的步骤继续执行。
1)删除一个容器
docker rm <containerID>
2)强制删除一个容器
docker rm -f <containerID>
3)强制删除全部容器
docker rm -f $(docker ps -aq)
4)删除一个镜像:
docker rmi <imageID>
5)强制删除一个镜像:
docker rmi -f <imageID>
6)强制删除全部镜像
docker rmi -f $(docker images -q)
SDK将用于客户端身份验证和使用账本的智能合约功能。
Docker Compose将用于创建包含三个Peer节点的联盟链、一个独立的Orderer和一个证书颁发机构(CA)。为了加快部署进度,预先生成了基于标准PKI实现的加密要素并打包进fabpre.tar.gz。证书颁发机构(CA)负责签发、撤销和维护代表一个企业的加密要素,这些要素提供给客户端(Node
SDK)用于身份认证。
Fabric网络将通过执行docker-compose自动生成,创建通道和加入通道的API将会自动被调用;同时,开发者也可以通过手动步骤生成自己的Fabric网络和通道(账本)或直接使用开发者模式进行应用开发。
一、前置条件和系统配置
· Docker –v1.12 及更高版本
· Docker
Compose – v1.8 及更高版本
· Node.js –
v2.1.8 及更高版本
yum –y install docker.x86_64
yum –y install Python-pip
pip install docker-compose
yum –y install npm
验证npm安装:
npm install npm@latest
查看npm版本:
npm -v
二、下载源代码并创建Fabric网络
·下载并安装 Curl 工具
· 创建 Fabric 工程和项目目录.
mkdir -p <workspace>
cd <workspace>
然后, 执行如下代码:
curl -L https://raw.githubusercontent.com/voodoo12345/polaris/master/fabpre.tar.gz -o fabpre.tar.gz 2> /dev/null; tar -xvf fabpre.tar.gz
执行完这条命令,会下载并解压缩部署Fabric网络的相关组件 ,包括Docker Compose 脚本, 通道创建/加入脚本, 认证使用的加密要素等.
你当前目录看上去是这样的:
ls
ccenv channel_test.sh docker-compose.yml fabpre.tar.gz src tmp
三、使用 Docker
你不需要手工拖取Docker镜像,通过执行docker-compose命令, fabric-peer, fabric-orderer, fabric-ca和 cli 都会自动下载、解压缩相关的镜像。
通道相关的命令:
“create” –在 orderer上创建并命名一个通道,返回一个通道的创世区块,生成的创世块以通道的名字命名“join” – 使用 create 命令生成的创世区块向Peer节点发出加入通道的请求
四、使用Docker 创建Fabric网络 & 创建/加入通道(账本)
1)确保 hyperledger/fabric-ccenv 镜像的标签是 latest:
执行docker-compose build
2)创建Fabric网络,创建通道(正本), 将Peer节点加入通道:
执行docker-compose up
3)查看你的容器:
docker ps
终端应该显示有6个独立运行的容器(3 个peer节点, 1个 独立的 orderer, CLI 和 CA). 嵌入在docker-compose.yml里的channel_test.sh会在CLI容器里执行创建通道和加入通道命令。执行结束,应该只有一个Fabric网络和一个通道(账本),通道包含三个节点peer0,Peer1,Peer2。
4)确保通道已成功创建,并且节点都成功加入:
执行docker exec -it cli sh
5)查看通道创建/节点加入的结果:
cat results.txt
屏幕显示的结果如下:
6)验证成功创建了创世块,执行如下命令:
ls -ltr myc1.block
五、下载演示程序和SDK 模块
· 创建案例程序目录:
mkdir –p test
curl -OOOOOO https://raw.githubusercontent.com/hyperledger/fabric-sdk-node/master/examples/balance-transfer/{config.json,deploy.js,helper.js,invoke.js,query.js,package.json}
这条命令会下载用于部署、调用和查询案例智能合约的 JavaScript 代码
,同时,它也包含了node SDK 依赖的模块
· 安装node 模块:
npm install
现在你已经拥有了全部Fabric网络运行需要的组件.
六、使用 node SDK 注册/登录一个用户并执行部署/调用/查询操作
这个案例程序将通过Node SDK &APIs以及预先准备的CA认证所需的加密要素来实现客户端的登记、注册和登录。一旦客户端完成身份验证,就可以执行程序包含的智能合约功能(部署、调用、查询)。
1a)注册/登录 & 部署智能合约 (Linux or
OSX):
GOPATH=$PWD node deploy.js
1b)注册/登录& 部署智能合约 (Windows):
SET GOPATH=%cd%
node deploy.js
2)执行一个调用操作. 从 “a” 转移一定资产到 “b”:
node invoke.js
3)查询键值 “a”:
node query.js
你会在终端上得到一个数值为200的结果
你可以浏览NodeJS SDK 和APIs的文档来实现更多功能。
七、手工创建和加入通道
为了在CLI容器里手动执行创建通道和加入通道API,我们需要编辑Docker Compose文件。用任意文本编辑器打开docker-compose.yml注释掉channel_test.sh脚本,编辑操作如下:
cli:
container_name: cli
<CONTENT REMOVED FOR BREVITY>
working_dir: /opt/gopath/src/http://github.com/hyperledger/fabric/peer
# command: sh -c ‘./channel_test.sh; sleep 1000′
# command: /bin/sh
1)进入cli 容器:
docker exec -it cli sh
2)发送createChannel API 给 Orderer:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc1
3)发送joinchannel API 给 Peer0:
CreateChannel执行完毕将返回一个创世区块(myc1.block),然后你可以执行加入通道的指令,把Genesis block作为参数发送joinchannel API给 peer0。
注:通道的定义都保存在创世块内:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer0:7051 peer channel join -b myc1.block
4)如果想要加入其它节点,只需重新发送上述命令给peer1或Peer2即可
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer1:7051 peer channel join -b myc1.block
一旦全部Peer节点都加入了通道,你可以查询账本而无需在每个节点都部署智能合约。
八、使用命令行工具部署/调用/查询智能合约
1)运行部署命令:这个命令是在通道myc1上的Peer节点0上部署一个名叫MYCC的智能合约。构造函数把A和B的值分别初始化为100和200。
CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode deploy -C myc1 -n mycc -p http://github.com/hyperledger/fabric/examples -c
‘{“Args”:["init","a","100","b","200"]}’
2)运行调用命令:这个命令是从A移动10个单位到B
CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode invoke -C myc1 -n mycc -c ‘{“function”:”invoke”,”Args”:["move","a","b","10"]}’
3)运行查询命令:按照预期,查询a的返回值应该是90
CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode query -C myc1 -n mycc -c ‘{“function”:”invoke”,”Args”:["query","a"]}’
你可以在任何时间发出exit命令退出CLI容器。
九、故障排除
1)如果已有容器在运行,执行docker-compose命令可能会收到报错,显示端口已被占用。如果发生这种情况,则需要杀死使用该端口的容器。
2)如果发现缺失部分文件,请确保Curl命令成功执行,并确保已经cd到了代码下载的目录。
3)如果你是用自动化步骤创建通道/加入通道的(即没有在yml文件注释channel_test.sh步骤),且通道myc1和创世区块myc1.block已经成功创建。这时,如果你想在CLI容器中手工执行后续的步骤:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc1
你可能看到类似的错误信息如下:
<EXACT_TIMESTAMP> UTC [msp] Sign -> DEBU 064 Sign: digest: 5ABA6805B3CDBAF16C6D0DCD6DC439F92793D55C82DB130206E35791BCF18E5F
Error: Got unexpected status: BAD_REQUEST
Usage:
peer channel create [flags]
这是因为你正试图创建一个重名的通道(myc1),这个通道已经存在!有两种解决方法,1)我们可以使用一个不同的通道名称来重新创建通道,例如:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc2
然后,执行加入通道指令:
CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer0:7051 peer channel join -b myc2.block
如果您选择创建一个新的通道,需要在config.json文件编辑“channelid”参数来匹配新的通道名称,例如:
{
"chainName":"fabric-client1",
"chaincodeID":"mycc",
"channelID":"myc2",
"goPath":"../../test/fixtures",
"chaincodePath":"github.com/example_cc",
2)如果你想继续使用原有的通道名称(myc1),可以删除所有的容器然后参照手动创建和加入通道部分的步骤继续执行。
十、常用docker命令:
1)删除一个容器
docker rm <containerID>
2)强制删除一个容器
docker rm -f <containerID>
3)强制删除全部容器
docker rm -f $(docker ps -aq)
4)删除一个镜像:
docker rmi <imageID>
5)强制删除一个镜像:
docker rmi -f <imageID>
6)强制删除全部镜像
docker rmi -f $(docker images -q)
相关文章推荐
- Hyperledger Fabric V1.0– 开发者快速入门
- Hyperledger Fabric V1.0– 开发者快速入门
- Hyperledger Fabric V1.0– 开发者快速入门
- vmware workstation12+ubuntu16版本快速启动hyperledger fabric1.0网络
- Hyperledger Fabric 1.0 快速部署
- 快速搭建一个Hyperledger Fabric 1.0的环境(目前很多环境搭建方法都会中途挂掉,这个亲测有效!)
- 【推荐】【入门】整理最新的区块链 Hyperledger Fabric 1.0 的资料
- Hyperledger Fabric 1.0 链码(chaincode)的原理、接口和结构
- Hyperledger Fabric 1.0 安装和使用
- Hyperledger Fabric1.0架构概览
- Hyperledger Fabric 1.0发布:基于区块链的开源分布式账本
- Hyperledger Fabric 1.0 从零开始(八)——Fabric多节点集群生产部署
- Hyperledger Fabric 1.0 从零开始(二)——环境构建(公网)
- Hyperledger Fabric 1.0 实战开发系列 第三课 chaincode开发
- Hyperledger Fabric 1.0 实战开发系列 第四课 搭建node.js服务器
- Hyperledger Fabric 1.0 从零开始(六)——创建Fabric多节点集群
- 区块链 hyperledger fabric1.0 环境搭建
- Hyperledger Fabric 1.0镜像下载
- the transaction flow in v1.0 of Hyperledger Fabric(fabric1.0交易流程)
- Hyperledger Fabric入门 -------- ( Hyperledger-fabric-doc.pdf)