自由行走

年轻没有失败,挑战无处不在!让我们一起加油!

Hyperledger Fabric V1.0– 开发者快速入门

Hyperledger Fabric V1.0– 开发者快速入门

本文档演示使用Hyperledger Fabric V1.0来部署一个开发者环境并运行一个简单例子。文档包括创建和加入通道(账本)、客户端认证以及部署和调用智能合约。CLI将用于创建和加入通道(账本),NodeJS 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 及更高版本

nodejs带有节点的包管理(NPM)。如果你的机器上已经安装了NPM,可以发出以下命令来获取新的软件包:

npm install npm@latest

查看npm安装的版本:

npm -v

如图:这里写图片描述

查看docker安装的版本:

docker -v

如图:这里写图片描述

查看docker-compose安装的版本:

docker-compose -v

如图:这里写图片描述

查看nodejs安装的版本:

node -v

如图:这里写图片描述

安装docker、docker-compose、python-pip、nodejs、npm都不一一安装了,如果不会安装的,可以看下我的前一篇博文。


一、下载源代码和创建网络

  • 如果没有安装Curl,请先下载并安装 Curl 工具
yum install curl
  • 创建 Fabric 工程和项目目录
mkdir -p  testone
  • 进入项目目录
cd testone

然后, 执行如下代码:

curl -L https://raw.githubusercontent.com/hyperledger/fabric/master/examples/sfhackfest/sfhackfest.tar.gz -o sfhackfest.tar.gz 2> /dev/null;  tar -xvf sfhackfest.tar.gz

执行完这条命令,会下载并解压缩部署Fabric网络的相关组件 ,包括Docker Compose 脚本, 通道创建/加入脚本, 认证使用的加密要素等,在/ src / github.com/example_cc目录你可以将链码部署。

这时你的目录里的内容应该是这样的

sfhackfest.tar.gz   channel_test.sh   src
ccenv     docker-compose-gettingstarted.yml  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 -f docker-compose-gettingstarted.yml build

(2)创建Fabric网络 ,创建通道(账本), 将Peer节点加入通道,执行命令如下:

docker-compose -f docker-compose-gettingstarted.yml up -d

(3)查看你的容器,命令如下:

docker ps -a

终端应该显示有6个独立运行的容器(3 个peer节点, 1个 独立的 orderer, CLI 和 CA). 嵌入在docker-compose.yml里的channel_test.sh会在CLI容器里执行创建通道和加入通道命令。执行结束,应该只有一个Fabric网络和一个通道(账本),通道包含三个节点peer0,Peer1,Peer2。

(4)确保已创建通道,并已成功连接节点:

docker exec -it cli bash

(5)查看通道创建/节点加入的结果:

more results.txt

显示的结果如下:

SUCCESSFUL CHANNEL CREATION
SUCCESSFUL JOIN CHANNEL on PEER0
SUCCESSFUL JOIN CHANNEL on PEER1
SUCCESSFUL JOIN CHANNEL on PEER2

(6)验证成功创建了创世块,执行如下命令:

more myc1.block

(7)退出容器

exit

五、下载应用程序源代码和SDK模块

  • 在发出命令之前,确保你在工作的目录中,已经下载好代码。确保你已经退出了CLI的容器。
  • 执行以下命令:
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认证所需的加密要素来实现客户端的登记、注册和登录。一旦客户端完成身份验证,就可以执行程序包含的智能合约功能(部署、调用、查询)。
在每个节点程序成功后,你将在终端接收到“200”响应。

(1)注册/登录 & 部署智能合约 (Linux or OSX):

GOPATH=$PWD node deploy.js

(2)执行一个调用操作, 从 “a” 转移一定资产到 “b”:

node invoke.js

(3)查询键值 “b”:

node query.js

你可以浏览NodeJS SDK 和APIs的文档来实现更多功能。


七、手动创建和加入通道

使用CLI容器手动执行创建通道和加入通道API。
通道myc1已经存在,所以,让我们创建一个新的通道,命名为myc2。

(1)进入cli容器:

docker exec -it cli bash

(2)如果成功,您应该在您的终端看到以下:

/opt/gopath/src/github.com/hyperledger/fabric/peer #

(3)发送createChannel API 给 Orderer:

CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer channel create -c myc2

(4)发送joinchannel API 给 Peer0:

  • CreateChannel执行完毕将返回一个创世区块(myc2.block),然后你可以执行加入通道的指令,把Genesis block作为参数发送joinchannel API给 peer0。

通道的定义都保存在创世块内:

CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer0:7051 peer channel join -b myc2.block

(5)如果想要加入其它节点,只需重新发送上述命令给peer1或Peer2即可

CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 CORE_PEER_ADDRESS=peer1:7051 peer channel join -b myc2.block

一旦全部Peer节点都加入了通道,你可以查询账本而无需在每个节点都部署智能合约。

八、使用CLI命令,部署,调用和查询智能合约

(1)运行部署命令:这个命令是在通道myc2上的Peer节点0上部署一个名叫MYCC的智能合约。构造函数把A和B的值分别初始化为100和200

CORE_PEER_ADDRESS=peer0:7051 CORE_PEER_COMMITTER_LEDGER_ORDERER=orderer:7050 peer chaincode deploy -C myc2 -n mycc -p 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 myc2 -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 myc2 -n mycc -c '{"function":"invoke","Args":["query","a"]}'

你可以在任何时间发出exit命令退出CLI容器。

九、常用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)
阅读更多
版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/zhaoliang1131/article/details/55048967
文章标签: 区块链
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

不良信息举报

Hyperledger Fabric V1.0– 开发者快速入门

最多只允许输入30个字

加入CSDN,享受更精准的内容推荐,与500万程序员共同成长!
关闭
关闭