基于华为云区块链服务快速部署和搭建链上应用
华为云区块链服务的整体架构
华为云区块链服务BCS是面向企业及开发者的高性能、高可用和高安全的区块链技术平台服务,可以帮助企业和开发人员在华为云上快速、低成本的创建、部署和管理区块链应用。
BCS基于Hyperledger1.0、kubernetes搭建,配置简单,数分钟内即可完成部署,提供全流程的自动化运维服务,多维度监控;支持多种高效共识算法,切换灵活,秒级共识(2000+ TPS);多角色节点和成员可动态加入/退出;采用容器化物理资源管理;一键上链,节约80%的开发、部署成本;按需付费,减少60% 使用成本;统一运维,节约监控和运维成本;根据用户需求进行弹性伸缩, 升级回滚;完善的用户、秘钥、权限管理和隔离处理,多层加密保障,国密和同态加密等隐私处理,可靠的网络安全基础能力,运营安全无忧。
BCS的总体逻辑架构如图1所示的三个层次,即区块链服务平台、合约链码层和业务应用层。
区块链服务平台
区块链服务平台具有极强的可靠性和扩展性,后续根据市场需求逐步支持Corda 和EEA 等优秀区块链框架,为上层应用低成本、快速的提供高安全、高可靠、高性能的企业级区块链系统。
合约链码
合约链码层目前提供Hyperledger 标准智能合约接口,用户可以根据不同应用场景构建不同的智能合约,后续将与合作伙伴一起为用户打造通用场景智能合约库,如供应链管理和溯源、供应链金融、数字资产、公益慈善和互联网保险等,企业可以在此基础上快速构建区块链应用场景。
业务应用层
业务应用层为最终用户提供可信、安全、快捷的区块链应用。用户可以使用华为云提供的各种解决方案(例如供应链金融解决方案、游戏行业解决方案、供应链溯源解决方案、新能源行业解决方案等),结合合约层快速搭建区块链应用。
图1 华为云区块链服务BCS的逻辑架构部署区块链服务
步骤1:资源准备
为了更稳定的运行区块链服务需准备2台8u16g机器来进行服务的部署。注册并登陆华为云账号,进入华为云管理控制台, 选择计算/云容器引擎服务(见图2)。
点击创建Kubernetes集群按钮,进入创建虚拟机的界面,在集群名称输入框中命名集群的名字,按需选择自己要使用的配置(可以采用默认配置)并点击下一步按钮进入图3界面。
在图3的界面上选择2台8核16GB内存的机器,在弹性IP栏点击现在购买弹性IP,公网弹性IP主要用于对公网发布BCS代理的访问地址。在云容器引擎左侧导航条中点击资源管理/虚拟机集群如图4,查看集群列表中刚创建的集群状态是否购买成功。
图2 云容器引擎服务总览 图3 选择节点机器规格 图4 集群信息列表步骤2:部署服务
在云管理控制台点击区块链服务进入如图5的区块链服务页面, 点击该页面右上角的“购买区块链服务”的按钮进入图6。
图5 区块链服务总览在图6的区块链服务购买页面中填写区块链服务名称,选择步骤1中创建的容器集群。在该示例中我们创建了两个节点组织testorg和developerorg,并为每个组织分配两个peer节点;选择快速拜占庭容错共识策略,基于拜占庭容错共识节点的最小数量为4,即3f+1,f=1;选择ECDSA签名算法的成员证书分发机制;配置链码管理Portal的登录密码。
图6 购买区块链服务区块链节点的通道配置如图7所示, 我们创建一个通道命名为testchannel, 把之前创建的组织testorg和developerorg加入该通道。完成如上配置之后, 点击下一步浏览该服务的概要信息,最后提交订单完成服务的订购和配置过程如图8。
图7 区块链节点的通道配置 图8 区块链服务订单详情点击左侧导航条的服务管理进入服务状态查询页面,等待数分钟后查看所部署的服务状态如图9所示, 该服务进入成功运行状态。
图9 区块链服务运行界面开发链码
链码也称为智能合约,实质上是控制区块链网络中的不同实体或相关方相互交易的业务逻辑。简言之,链码将业务网络交易封装在代码中,可以调用链码来设置和获取账本,即区块数据或世界状态(world state)。
步骤1:示例场景说明
该示例场景使用区块链来追踪研发团队内的某产品的测试数据,通过查询某个产品或者服务一段时间内的测试用例结果, 进而分析产品的功能状态。开发人员可以查询到失败用例是哪些、集中在产品的哪些模块,还可以根据测试人员的名字,联系测试人员快速定位问题;测试管理者能根据不同测试人员的测试用例,发现问题的多少和模块的稳定程度;测试人员在系统中记录测试结果,其他参与方可以查询测试结果。该示例场景的基本功能说明如下。链码的交互流程如图10。
1、测试管理者manager创建项目和模块;
2、测试管理者manager根据项目名称、模块添加测试用例、创建人和创建时间;
3、测试人员tester根据测试用例添加测试结果、测试时间、测试人员和备注;
4、测试人员tester、测试管理者manager、开发人员developer可以根据项目名称、模块查询测试用例;根据测试用例查询测试结果、时间、测试人员和备注。
图10 线下APP和链码的简单交互流程图步骤2:编写链码
链码开发人员可从
"github.com/hyperledger/fabric/core/chaincode/shim" 模块查看链码的接口,需实现init和invoke接口。shim模块中的接口定义如下:
在定义好整个代码的保存目录结构后,开发人员需将"github.com/hyperledger/fabric/core/chaincode/shim" 加入到方法引用。
对于有需要初始化处理的数据,可以在初始化函数init中编写并在链码实例化的过程中进行。这里我们定义了一个示例即初始化项目名称,代码实现如下:
接下来开始定义内部逻辑的启用函数invoke。首先通过接口中的内置方法GetFunctionAndParameters()来获取传入的函数别名和参数,通过switch case或if else条件语句把之前分析的各个用户角色可以调用的方法起个别名,然后和内部的真实方法做好一一对应关系,并将接口对象和相应调用参数传入对应的方法。
具体的用户能够访问哪个方法的权限逻辑控制可由上层的应用app实现,链码主要完成对数据的存储和查询的逻辑。Invoke 链码示例如下:
完成invoke函数后我们需要给这个go文件定义好它的入口main函数,通过fabric shim包中的Start方法来启动我们定义的全局智能合约,保证链码可以被正确的调用,示例如下:
这样我们链码的基本代码架构就搭建好了,开发人员可继续填充每个方法内的逻辑,即别名所对应的真实方法的实现。我们以创建测试用例和查询测试用例为示例说明。
● 创建测试用例以项目名称、模块名称及测试用例名称构成复合主键,然后为它创建一个索引,再将创建好的索引存入链中。这样查询的时候就可以使用不同的组合查询方式查询真实需要的结果。
● 查询测试用例通过部分匹配复合主键将具有相同的项目名称和模块名称的值查询出来,然后通过迭代器将键值中的测试用例名称截取出来存成一个列表,对其进行json序列化并作为查询结果返回给上层App。上层App需要对查询的数值进行反序列化即可拿到整个用例名称的列表,根据其他需要查询具体用例结果。
步骤3:安装部署链码
链码编写完成之后我们需要把链码部署到fabric集群环境中。华为云区块链服务提供了可视化的链码生命周期管理工具。在区块链服务的管理控制台上点击服务列表后面的链码管理链接,打开图11中的链码管理登陆页面,输入默认的用户名admin和用户创建服务时所设置的密码,登陆链码管理平台对链码进行相应的操作。
图11 链码管理登陆界面登陆后用户可选择在哪个组织的哪个节点peer上安装链代码。如图12所示我们选择在testorg的peer-1节点安装链代码。点击右上角的安装链码按钮,需要填写链码名称、版本号以及为了保证完整性的信息摘要,最后上传一个图13所示的链码zip格式的压缩文件。
图12 链码管理界面 图13 链码安装界面链码的zip压缩包和压缩包的摘要信息计算如图14和15所示。
图14 链码压缩包 图15 链码压缩包摘要信息链码使用之前需要先实例化,安装成功以后我们在链码的操作按钮列中可以看到图16实例化按钮已经处于激活状态。点击实例化按钮,选择链码背书策略,输入链码的函数名、init方法的参数如上述示例中的项目名称testproject、选择要实例化的通道如testchannel,然后点击确定按钮,触发链码的实例化。实例化结束后可在如图17的界面上查询链码状态,在testchannel上可以查看链码是否已经实例化成功。
图16 链码激活状态界面 图17 链码实例化成功界面开发业务层区块链应用
Hyperledger fabric目前支持java,nodejs,go和python语言的sdk,供用户选择用不同的语言开发上层应用,使用相应的sdk调用部署在区块链上的链码。以下示例中我们选择使用go语言开发业务层应用。
步骤1:配置fabric sdk
Hyperledger fabric官方提供了我们需要的go sdk文件包,下载地址是:
https://github.com/hyperledger/fabric-sdk-go。目前BCS服务使用的版本commit号是035e4f9。
我们需要为fabric sdk生成相应的配置文件和访问区块链节点的组织证书。SDK配置文件主要包括要访问的链码名称/版本、证书解压的目录位置、实例化链码的通道,安装链码的节点组织/名称。在订购的区块链服务状态中的点击图18中的“下载SDK配置“会弹出图19配置窗口,完成sdk配置。
图18 SDK配置文件下载界面 图19 配置SDK文件下载界面在订购的区块链服务状态列表页面上可以查看每个节点的状态以及相应的证书下载功能,我们需要下载相关的证书到sdk的配置文件所指定目录中,使得业务应用可以和区块链节点正常的进行通讯。图20显示了orderer节点和peer节点的证书下载链接。
图20 orderer节点和peer节点的证书下载步骤2:编写业务应用代码
合理配置sdk与区块链节点peer的通信后,业务层应用代码仅需对接链码的invoke和query的方法。以下示例中我们使用sdk提供的接口ChannelClient,即先通过加载sdk配置文件生成一个sdk实例,然后传入通道名称和用户信息生成一个ChannelClient对象,最后使用该ChannelClient发起一笔执行链码的交易。
图21 ChannelClient初始化过程在业务应用代码中定义好一个链码的数据结构ChainCodeSpec,包括ChannelClient对象、 用户信息和链码名称等,在ChannelClient初始化时给其赋值。将链码的invoke和query方法定义成结构体方法,可以很简单的在发起交易的时候完成数据传递如图22所示。
图22 调用链码的invoke和query方法步骤3:测试业务应用代码
下面我们简单的定义一个main方法如图23来测试一下我们的代码。首先声明之前在链码管理网站实例化的链码信息,即链码名称chaicodetest,实例化的通道名称testchannel,用户使用的是组织内的普通用户。其次,定义两个测试方法创建测试用例和查询测试用例。
创建测试用例create_testcases需要按顺序传入4个参数即项目名称、模块名称、测试用例名称和测试用例描述,调用invoke方法将一次交易写入区块链。查询测试用例query_testcases方法传入项目名称和模块名称,查询测试用例信息。
图23 业务应用调用链码实现端到端测试之后我们使用go run来执行这个测试用例,如图24我们可以看到已经生成testchannel实例并与区块链节点建立连接。为了确认交易是否正常,链码是否正确保存之前用例的复合键值索引,我们登陆区块链节点并用“docker logs <容器id>”命令我们可以看到如图25中为每笔交易创建的区块。图26链码容器也可检查我们之前链码打印的日志来确定是否可以正确查询测试用例。
图24 SDK代码执行结果 图25 查看区块链节点peer中的运行结果 图26 链码运行本文通过一个简单的例子介绍如何通过华为云提供的区块链服务快速的开发和搭建起一个应用,用户可以根据所需的场景,基于本文的示例部署区块链服务,开发链码和业务层应用。
本文只阐述了部分代码的实现,完整的代码下载地址是:
https://github.com/cloud1230/testsystem,供开发人员参考。
华为云区块链服务:http://t.cn/RFbDa1H