Fabric-V1.4安装配置 及 票据应用示例

Fabric-V1.4安装配置 及 票据应用示例

Fabric 1.4 更新内容

Fabric已经发布到1.4LTS版本,各个版本对比如下:

Fabric v1.1版本主要的新特性包括:

  • Fabric CA的CRL
  • 区块以及交易的事件推送
  • 增加了所有组建间的双向TLS通信
  • Node.js Chaincode链码的支持
  • Chaincode API新增了creator identity
  • 性能相对v1.0有了明显的提升

Fabric v1.2开始有了比较大的feature开始出现:

  • Private Data Collections:这个特性不得不说在隐私保护上解决了不少项目的痛点,也减少了许多项目为了隐私保护在业务层做的复杂设计。
  • Service Discovery:服务发现这个特性,使得客户端拥有了更多的灵活性和可操作性,可以动态感知整个Fabric网络的变化。
  • Pluggable endorsement and validation:可插拔的背书及校验机制,采用了Go Plugin机制来实现,避免了之前需要重新编译源代码的操作,提升了灵活性。

Fabric v1.3中,同样增加了十分有用的feature:

  • 基于Identity Mixer的MSP Implementation:基于零知识证明实现的身份的匿名和不可链接,这个特性替代了v0.6版本中的T-cert。
  • key-level endorsement policies:更细粒度的背书策略,细化到具体的key-value,更加灵活,不仅限于一个链码程序作背书。
  • 新增Java Chaincode:至此,v1.3之后支持了Go、Node.js、Java 三种Chaincode,为开发者提供了更多的选择。
  • Peer channel-based event services:Channel级别的事件订阅机制,早在v1.1版本中已经亮相了,在v1.3版本中正式发布,至此,旧的Event Hub正式宣告弃用。

Fabric v1.4是一个里程碑式的版本,是首个LTS的版本(Long Term Support的版本):

  • 可操作性和可维护性的提升:
  • 开放日志级别设置的接口
  • 开放节点健康状态的检查接口
  • 开放节点数据指标的收集接口
  • 改进了Node SDK的编程模型,简化开发者的代码复杂度,使得SDK更加易用
  • Private Data的增强:
  • 对于后续添加的允许访问节点能够获取之前的隐私数据
  • 添加客户端层面的隐私数据的权限控制,不需要添加链码逻辑。

环境搭建准备工作

实验环境

这里作一个更新,新建Centos7.4的虚拟机环境。大致搭建过程如下。
云主机:Centos 7.4 、CPU:4C、内存:16G,硬盘:200G。

相关前置软件安装

关闭Selinux,关闭防火墙等相关操作,相关操作网络上随处可查。

建议更新后再进行下列操作:

1
> yum update

安装git、curl、pip

1
2
3
4
5
> yum install git
> yum install curl
> yum -y install epel-release
> yum install python-pip
> pip install --upgrade pip

安装docker相关

1
2
3
4
>  yum install docker-ce
# 或者:yum install docker-ce.18.06.3.ce-3.el7 指定具体版本,可以先设置好yum 源(yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo)
> pip install docker-compose #(可能会失败,那就用以下的命令)
> pip install docker-compose --ignore-installed requests

相关软件环境:
安装完成后查看各个软件版本,如下图:
屏幕快照 2019-04-01 下午3.37.38.png-435kB

注: 可能会碰到docker-compose报错:

1
2
3
File "/usr/lib/python2.7/site-packages/paramiko/ssh_gss.py", line 55, in <module>
GSS_EXCEPTIONS = (gssapi.GSSException,)
AttributeError: 'module' object has no attribute 'GSSException'

那么通过修改配置文件:/usr/lib/python2.7/site-packages/paramiko/ssh_gss.py来解决:

1
2
3
4
vi /usr/lib/python2.7/site-packages/paramiko/ssh_gss.py
53.55行修改如下解决:
53:import gssapi.error
55:GSS_EXCEPTIONS = (gssapi.error.GSSException,)

屏幕快照 2019-04-01 下午3.42.12.png-158.8kB


安装Golang、Node.js、npm

安装Golang

如果单独去下载安装包麻烦的话,那么直接通过wget来下载解压,配置环境变量。

1
2
wget https://studygolang.com/dl/golang/go1.10.8.linux-amd64.tar.gz
tar -xvf go1.10.8.linux-amd64.tar.gz

配置环境变量。修改/etc/profile文件,路径根据下载安装路径来。

1
2
3
4
5
vim /etc/profile
添加
export GOROOT=/usr/go
export GOPATH=/usr/gopath
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

安装Node.js

1
2
3
4
5
6
wget https://npm.taobao.org/mirrors/node/v11.0.0/node-v11.0.0.tar.gz
tar -xvf node-v11.0.0.tar.gz
解压后进入Node文件夹:
yum install gcc gcc-c++
完成后gcc -v,这时候会发现gcc为4.8.5 建议更新:
wget http://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz

更新完成后,解压gcc,并安装:

1
2
3
4
5
6
7
8
9
tar -xvf gcc-7.3.0.tar.gz
进入gcc-7.3.0目录执行:
./contrib/download_prerequisites
mkdir 一个新的目录
进入该目录 cd 目录
../configure --enable-checking=release --enable-languages=c,c++ --disable-multilib
make (请耐心等待,我这里大概等待了2个多小时。。。)
make install
建议重启后再进行之后的操作

重启后看到gcc版本为7.3.0

屏幕快照 2019-04-01 下午7.22.57.png-137.4kB

安装Node.js

1
2
3
4
5
进入Node.js文件夹(这里可能有一个文件夹名的问题,建议修改node7.3.0文件夹名直接为node)
./configure
make (耐心等待)
make install
建议重启后再进行之后的操作

安装npm

1
npm install npm -g

完成上述操作后,查看各软件版本:

屏幕快照 2019-04-02 上午10.40.50.png-206.8kB

安装 Fabric

首先下载Fabric源码,我们在go/src目录下新建文件夹。

1
2
3
mkdir -p github.com/hyperledger
进入该文件夹执行:
git clone https://github.com/hyperledger/fabric.git (耐心等待)

完成后进入 fabric/scripts文件夹,可以看到bootstrap.sh脚本,cat该脚本可以看到fabric版本为1.4.0:

屏幕快照 2019-04-02 上午11.21.22.png-259.7kB

执行bootstrap.sh脚本,自动进行fabric相关镜像的下载,耐心等待

1
./bootstrap.sh

屏幕快照 2019-04-02 上午11.26.35.png-781.6kB

镜像下载完成后如图:

屏幕快照 2019-04-02 上午11.48.58.png-476.3kB

通过Fabric-samples提供的BYFN(build your first network)构建网络。

1
./byfn.sh -m generate -c jackychannel(自定义名字)

过程很快,完成后如图:
屏幕快照 2019-04-02 下午12.34.40.png-432.6kB

启动网络:

1
./byfn.sh -m up -c jackychannel

启动后如图:
屏幕快照 2019-04-02 下午12.36.24.png-610.7kB
完成后如图:
屏幕快照 2019-04-02 下午12.37.48.png-86.5kB

这个时候出现4个peer节点,通过top命令可以清楚看到:
屏幕快照 2019-04-02 下午12.39.07.png-308.2kB

注: 关闭命令:./byfn.sh -m down

启动网络服务后会启动排序服务节点、4个Peer节点,以及1个命令行容器cli。

搭建完成后功能测试

上述步骤完成后,可是去看下一些基本的操作和命令。

1
/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network/channel-artifacts目录中,可称为创世区块目录(目录根据每个人的配置)

可以看到下列文件:

屏幕快照 2019-04-02 下午12.57.54.png-155.5kB

Org1MSPanchors.tx、Org2MSPanchors.tx,两个锚节点配置。
channel.tx,生成通道配置文件。
genesis.block,创世区块文件。

1
/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network/crypto-config目录中,可称为证书目录(目录根据每个人的配置)

该目录存放生成排序服务节点和Peer节点的MSP证书文件,如图:
1112019-04-02 下午1.11.57.png-560.3kB

使用docker命令查看运行中的镜像:

1
docker ps

结果如图:
12222019-04-02 下午1.14.47.png-614.9kB

进入cli来进行一些简单的操作:

1
docker exec -it cli bash

切换到容器内做一个简单的查询:

1
peer chaincode query -C jackychannel(刚设置启动的名称) -n mycc -c '{"Args":["query","a"]}'

结果会看到90余额。

票据应用测试

在Fabric官网文档中有一个商业票据的例子,这里简单进行了测试。(停止Fabric网络服务后再进行以下操作。)

两个组织:MagnetoCorp、DigiBank,
票据网络:PaperNet。

进入该目录启动基本网络:

1
2
/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/basic-network
./start.sh

启动完成后查看:docker ps 会出现4个运行中容器。

使用:docker network inspect net_basic命令查看docker网络:
屏幕快照 2019-04-02 下午4.20.01.png-780.9kB

进入以下目录,启动:

1
2
cd commercial-paper/organization/magnetocorp/configuration/cli/
./monitordocker.sh net_basic

出现下图:

屏幕快照 2019-04-02 下午4.32.23.png-79.5kB

另外开一个终端连接到服务器,在之前目录下,创建MagnetoCorp公司特定的docker容器。

1
2
cd commercial-paper/organization/magnetocorp/configuration/cli/
docker-compose -f docker-compose.yml up -d cliMagnetoCorp

再输入:docker ps 可以看到fabric-tools:3f078207c01a已加入网络中:
屏幕快照 2019-04-02 下午4.34.27.png-304.3kB

MagnetoCorp 管理员通过fabric-tools:3f078207c01a来进行操作。

接下来看下智能合约:
进入以下目录:

1
cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/magnetocorp/contract/lib

该目录下三个文件,其中papercontract.js为商业票据的智能合约。可以cat看下具体内容,这里暂不展开。

执行如下部署合约代码:

1
docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract -l node

屏幕快照 2019-04-02 下午4.56.54.png-179.5kB

实例化智能合约:

1
docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l node -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')"

输入如下:
屏幕快照 2019-04-02 下午4.58.28.png-209.7kB

之前打开的终端中会有输出,也就是logsout容器的中的日志输出内容,具体如下:
屏幕快照 2019-04-02 下午4.59.47.png-1484.7kB

再次docker ps就可以看到:dev-peer0.org1.example.com-papercontract-0,说明此容器是peer0.org1.example.com节点启动的,且正在运行的papercontract链码版本为0。
屏幕快照 2019-04-02 下午5.01.25.png-403.6kB

MagnetoCorp Application进行票据发行:

过程图:
屏幕快照 2019-04-03 下午12.03.35.png-153kB

MagnetoCorp的Isabella发起整个交易过程。

进入以下目录:

1
cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/magnetocorp/application

可以看到下列文件:
eslintrc.js、issue.js、package.json、addToWallet.js、node_modules

1
node addToWallet.js

在执行上述命令的时候,强烈建议先进行如下操作:这几个坑一般都存在~~

1
2
3
4
5
6
7
8
9
修改package.json文件
vi package.json
把里面1.0.0版本改成1.4.0
npm install(如报错执行下列命令)
npm install --unsafe-perm fabric-network
如有:Error: /lib64/libstdc++.so.6: version `CXXABI_1.3.9' not found 报错那么执行下列命令:
find / -name "libstdc++.so.6*
找到文件的指定目录,笔者这里是6.0.24,复制到/lib64目录、删除之前的libstdc++.so.6文件,执行如下命令链接:
ln -s libstdc++.so.6.0.24 libstdc++.so.6

再删除之前的node_modules文件夹,再次执行:

1
2
3
npm install(如报错执行下列命令)
npm install --unsafe-perm fabric-network
node addToWallet.js

这个时候正常的话会出现done,如图:
屏幕快照 2019-04-03 上午11.25.58.png-26.2kB

查看钱包的结构:

1
2
ll ../identity/user/isabella/wallet/
ll ../identity/user/isabella/wallet/User1\@org1.example.com

结果如下图:
屏幕快照 2019-04-03 上午11.59.10.png-199.3kB

Isabella钱包信息:
用户私钥:c75bd6911aca808941c3557ee7c97e90f3952e379497dc55eb903f31b50abc83-priv
用户公钥:c75bd6911aca808941c3557ee7c97e90f3952e379497dc55eb903f31b50abc83-pub
用户证书文件:User1@org1.example.com

发起交易:
Isabella现在可以使用issue.js来提交一个交易(发行MagnetoCorp 公司的商业票据00001)

1
node issue.js

结果如图:
屏幕快照 2019-04-03 下午12.11.41.png-239.8kB


以上操作都是在MagnetoCorp的Isabella,接下来是,DigiBank-Balaji ,他将购买刚刚发行的商业票据。

购买流程图:
购买流程图

进入下列目录:

1
2
/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/digibank/configuration/cli
执行:docker-compose -f docker-compose.yml up -d cliDigiBank

结果如图:

屏幕快照 2019-04-03 下午12.22.48.png-104.5kB

1
2
cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/digibank/application
vi buy.js

buy.js文件可查看合约内容.

和之前npm的操作一样、修改相关文件内容:

1
2
3
4
修改package.json文件
vi package.json # 把里面1.0.0版本改成1.4.0
npm install(如报错执行下列命令)
npm install --unsafe-perm fabric-network

创建账户及购买,商业票据00001生命周期的最后一个交易是redeem交易,Balaji 通过运行redeem.js程序来实现这一过程。

1
2
3
node addToWallet.js 
node buy.js
node redeem.js

在执行过程中可能会出现:
屏幕快照 2019-04-03 下午1.17.42.png-343.7kB

那么执行:

1
npm install -g js-yaml

结果如图:
11111.png-261.8kB
2222.png-231.8kB

整个实验大致完成。

参考文章:

  1. https://www.jianshu.com/p/cb032c42c909
  2. https://blog.csdn.net/ASN_forever/article/details/87859346
  3. https://hyperledger-fabric.readthedocs.io/en/latest/

深入浅出区块链 - 系统学习区块链,打造最好的区块链技术博客

LBC-Team wechat
微信号:深入浅出区块链技术,欢迎订阅
0%