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)