简介
- 开发我们的区块链对外的API接口，实现之前我们在Cli中进行的查询数据、插入数据、查询区块信息、查询交易信息、安装链码等等，将这些操作统一写成对外开放的RUSTful Web API。
- 本篇内容介绍的相关代码可能需要了解很多Nodejs相关的知识，还有许多NPM中的插件框架；诸如express、log4j、express-jwt等等。
官方英文版教程：
http://hyperledger-fabric.readthedocs.io/en/latest/index.html
官方Nodejs-SDK教程：
https://fabric-sdk-node.github.io/
1. 开发环境及配置准备
环境准备比较简单，这里只做简单的描述。
1.1 开发、IDE等环境
- 这里我们的开发环境是Windows。确保Windows下安装了Nodejs、NPM。
- 使用VS Code开发。
- 在此篇中我们需要讲解的是： https://github.com/hyperledger/fabric-samples主要详解其中balance-transfer部分。无论直接下载Zip或者Git下载都可以。
（这个项目质量相对较低，但是比没有的好；代码也不是很规范，各种NPM包版本也较低，实际开发应该替换） - 在项目目录下执行NPM Install，将所有引用的NPM包下载到项目中。
（其中grpc包可能下载慢或者失败，可以尝试-g全局下载，然后复制进项目中；如果失败的很多建议在云服务器中下载完成复制到本地开发环境；可能还需要下载Python 2.7）
1.2 区块链网络配置
区块链网络使用e2e例子中生成的网络，需要做一个简单的修改，如下：
（默认的网络配置中没有ca节点，我们需要在原来的基础上添加一个ca节点；e2e的配置中已经有了对应的配置文件）
首先清理之前生成的e2e网络：
$ cd /opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli
$ ./network_setup.sh down
等待清理完成，检查docker容器都被清理成功。
$ docker ps
打开'/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/network_setup.sh'
UP_DOWN="$1"
CH_NAME="$2"
CLI_TIMEOUT="$3"
IF_COUCHDB="$4"
: ${CLI_TIMEOUT:="10000"}
COMPOSE_FILE=docker-compose-cli.yaml
COMPOSE_FILE_COUCH=docker-compose-couch.yaml
#COMPOSE_FILE=docker-compose-e2e.yaml
....
....
我的需要的ca节点的配置其实在'docker-compose-e2e.yaml'文件中，只是这里将其注释掉了，换一下就好，修改后如下：
....
....
#COMPOSE_FILE=docker-compose-cli.yaml
COMPOSE_FILE_COUCH=docker-compose-couch.yaml
COMPOSE_FILE=docker-compose-e2e.yaml
....
....
再打开'docker-compose-cli.yaml'，将文件末尾的如下内容复制到'docker-compose-e2e-template.yaml'文件的结尾。
cli:
container_name: cli
image: hyperledger/fabric-tools
tty: true
environment:
- GOPATH=/opt/gopath
- CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
- CORE_LOGGING_LEVEL=DEBUG
- CORE_PEER_ID=cli
- CORE_PEER_ADDRESS=peer0.org1.example.com:7051
- CORE_PEER_LOCALMSPID=Org1MSP
- CORE_PEER_TLS_ENABLED=true
- CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.crt
- CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.key
- CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
- CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
command: /bin/bash -c './scripts/script.sh ${CHANNEL_NAME}; sleep $TIMEOUT'
volumes:
- /var/run/:/host/var/run/
- ../chaincode/go/:/opt/gopath/src/github.com/hyperledger/fabric/examples/chaincode/go
- ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/
- ./scripts:/opt/gopath/src/github.com/hyperledger/fabric/peer/scripts/
- ./channel-artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts
depends_on:
- orderer.example.com
- peer0.org1.example.com
- peer1.org1.example.com
- peer0.org2.example.com
- peer1.org2.example.com
注意：最好复制自己'docker-compose-cli.yaml'文件的中的对应内容，由于源码版本问题，可能会不一致。
这里有一个奇怪的地方，我们代码中执行的是'docker-compose-e2e.yaml'，然而我们却在修改'docker-compose-e2e-template.yaml'。
其实在e2e这个目录下'docker-compose-e2e-template.yaml'与'docker-compose-e2e.yaml'这两个文件，在执行的过程中将前一个文件完全复制替换到第二个文件，所以修改'docker-compose-e2e.yaml'是无效的
这里其实是在我们新的网络中加入了cli节点。如果不加后边生成网络会报错，为了简单一点直接加入cli节点就OK了。
最后重新生成e2e网络：
$ cd /opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli
$ ./network_setup.sh up
1.3 项目配置
首先打开"/balance-transfer/config.js"
var util = require('util');
var path = require('path');
var hfc = require('fabric-client');
var file = 'network-config%s.json';
var env = process.env.TARGET_NETWORK;
if (env)
file = util.format(file, '-' + env);
else
file = util.format(file, '');
hfc.addConfigFile(path.join(__dirname, 'app', file));
hfc.addConfigFile(path.join(__dirname, 'config.json'));
这里的重点是加载了区块链网络配置文件'network-config%s.json'；所有的区块链网络配置都将从这里读取，后续会有很多地方从这里读取peer、org等等信息；
当前web-API的配置在'config.json'。
打开"/balance-transfer/network-config.json"
以下是我修改过后的内容：
{
"network-config": {
"orderer": {
"url": "grpcs://193.112.13.226:7050",
"server-hostname": "orderer.example.com",
"tls_cacerts": "../artifacts/channel/crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/tls/ca.crt"
},
"org1": {
"name": "peerOrg1",
"mspid": "Org1MSP",
"ca": "https://193.112.13.226:7054",
"peers": {
"peer1": {
"requests": "grpcs://193.112.13.226:7051",
"events": "grpcs://193.112.13.226:7053",
"server-hostname": "peer0.org1.example.com",
"tls_cacerts": "../artifacts/channel/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt"
},
"peer2": {
"requests": "grpcs://193.112.13.226:8051",
"events": "grpcs://193.112.13.226:8053",
"server-hostname": "peer1.org1.example.com",
"tls_cacerts": "../artifacts/channel/crypto-config/peerOrganizations/org1.example.com/peers/peer1.org1.example.com/tls/ca.crt"
}
},
"admin": {
"key": "../artifacts/channel/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore",
"cert": "../artifacts/channel/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/signcerts"
}
},
"org2": {
"name": "peerOrg2",
"mspid": "Org2MSP",
"ca": "https://193.112.13.226:8054",
"peers": {
"peer1": {
"requests": "grpcs://193.112.13.226:9051",
"events": "grpcs://193.112.13.226:9053",
"server-hostname": "peer0.org2.example.com",
"tls_cacerts": "../artifacts/channel/crypto-config/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt"
},
"peer2": {
"requests": "grpcs://193.112.13.226:10051",
"events": "grpcs://193.112.13.226:10053",
"server-hostname": "peer1.org2.example.com",
"tls_cacerts": "../artifacts/channel/crypto-config/peerOrganizations/org2.example.com/peers/peer1.org2.example.com/tls/ca.crt"
}
},
"admin": {
"key": "../artifacts/channel/crypto-config/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp/keystore",
"cert": "../artifacts/channel/crypto-config/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp/signcerts"
}
}
}
}
e2e环境中：
e2e端口、节点、组织等参照对象：
'/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/base/docker-compose-base.yaml'
'/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/docker-compose-e2e.yaml'
把对应的端口、节点、组织等信息对应修改。
e2e的证书路径：
'/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/crypto-config'
将此路径文件全部复制到自己项目如下的路径中：
'fabric-samples\balance-transfer\artifacts\channel\crypto-config'
非e2e环境：
其他环境中基本上每一个节点都需要修改，针对自己的网络配置修改对应的地址、路径、信息等。一定要和自己生成的网络对应。以及证书路径等等，全完按照新的网络修改。
其次以上端口信息可以用如下命令查看
$ docker ps
里边有节点对应的端口映射，方便修改上述配置。
在"/balance-transfer/config.json"中默认端口4000，由于个人本地需求改为了5010。其他配置项目暂时无需修改。
2. 测试运行
确保在VScode中F5可以运行不报错。
由于这个项目中没有界面，我们需要一个post/get工具来测试。这里推荐的是谷歌浏览器插件Restlet Client。对此工具其他文章会有详细的介绍。
F5调试项目，确保无误，在浏览器中打开'http://localhost:5010/channels'
你会发先这样一个报错'No authorization token was found'。
这个报错的原因在于这个项目默认使用了Json Web Token(简称JWT，一个轻量级的认证规范)
所以直接打开是不可以的，需要在请求头里加入签名。
这里使用Restlet Client进行post
请求是成功的；并且返回了一些数据。
其中token就是刚才提到的请求头缺少的内容，在请求头中加入Authorization，值使用刚才得到的字符串，并加上前缀Bearer ；
让我们再试一次：
至此我们的Nodejs API接口已经调用成功了。
在app.js中可以看到其他接口的访问方式，大家可以逐个尝试。
在testAPIs.sh脚本中有写好的调用示例，可以参考。
3. 部署Nodejs
Nodejs运行在V8引擎下，是以单线程的方式运行的，因此在多核心处理器的系统中并不能发挥其最大的性能。所以就需要一个应用管理器帮我们解决这个问题，否则就需要大量的时间写相关的代码。
这里推荐使用pm2（Node应用的进程管理器）；实际上pm2就是一个npm包，官方的教程如下：
(最常见的线上部署nodejs项目的有forever，pm2)
https://www.npmjs.com/package/pm2
http://pm2.keymetrics.io/
pm2有非常灵活的配置，带有负载均衡（Node cluster 集群模块）功能，提供 HTTP API、远程控制和实时的接口 API ( Nodejs 模块，允许和 PM2 进程管理器交互 )等很多特性。
网上有众多相关教程与介绍，不再赘述。
下一篇将详细的分析balance-transfer中的代码，重点在各个接口所使用的Fabric-SDK代码
.
.
.
.
.
.
.
.
【本文章出自NM1024.com，转载请注明作者出处。】
>>转载请注明原文链接地址：Hyperledger-Fabric安装开发部署（四）NodeJs-SDK
1 条回复
[…] 此篇所需要的开发环境与Hyperledger-Fabric安装开发部署（四）NodeJs-SDK、Hyperledger-Fabric安装开发部署（五）NodeJs-SDK详解相同。 […]