注册区块链
将需要进行跨链操作的区块链注册到TCS中,目前只支持华为云BCS服务提供的Hyperledger Fabric类型的区块链。注册成功后,支持修改和删除已注册成功的区块链。
前提条件
- 已购买Hyperledger Fabric区块链服务,详细操作请参基于CCE集群。
- 安装并实例化跨链辅助合约和跨链业务合约。跨链辅助合约可在TCS控制台总览界面右侧下载,链代码名称为固定值tcshelper;跨链业务合约需要您基于业务场景进行开发,具体开发可参考开发指南。
- 下载对应区块链服务的配置文件和证书文件,支持yaml和json格式,详细操作请参考下载SDK配置和证书。
- 下载配置文件时请参考如下表1填写参数。(以下截图的区块链类型是联盟链)
表1 参数说明 参数名称
说明
链代码名称
跨链辅助合约,固定值tcshelper。
证书存放路径
固定值:/home/service/Certs
通道名称
选择一个通道。
组织&Peer节点(区块链类型为私有链)
选择通道中的任意1个节点组织下的所有peer节点。这里的组织和“Peer节点证书”的组织需要保持一致。
选择成员(区块链类型为联盟链)
选择通道中的任意1个节点组织。这里的组织和“Peer节点证书”的组织保持一致。
共识节点证书
与区块链系统交互时,需要使用共识节点证书。请妥善保管对应证书的私钥,建议您进行加密保存。
Peer节点证书
- 指定节点组织:只能选择跨链辅助合约所在通道的任意一个组织。这里的组织和“组织&Peer节点”或“选择成员”的组织需要保持一致。
- 证书选择:管理员证书。
- 请妥善保管对应证书的私钥,建议您进行加密保存。
- 将下载的配置文件解压出yaml文件备用。获取解压出来的orderer文件夹和peer文件夹,并压缩成zip文件,目录结构参考如下截图,请以实际下载的文件为准。
tls文件中的这三个文件名称是固定的:ca.crt,server.crt,server.key。
图1 目录结构
- 下载配置文件时请参考如下表1填写参数。(以下截图的区块链类型是联盟链)
操作步骤
- 登录可信跨链服务管理控制台,进入“总览”页面。
- 在“总览”页面的注册区块链,单击“开始注册”。
- 在“注册区块链”页面,按照如下表2填写配置信息。
必须从同一个Hyperledger Fabric服务下载配置文件和证书。
表2 基本信息 参数
描述
区块链名称
区块链注册在TCS中的名称。
支持英文字符、数字及中划线,不能以中划线开头,长度为4-24个字符。
描述
描述节点信息。
区块链类型
目前只支持华为云BCS服务提供的Hyperledger Fabric。
合约名称
跨链合约名称,支持增加20个。
支持英文字符、数字及中划线,不能以中划线开头,长度为4-24个字符。
配置文件
Hyperledger Fabric服务的yaml或json格式的配置文件,详细操作请参考下载SDK配置和证书。
证书
Hyperledger Fabric服务的证书文件,将orderer文件和peer节点管理证书放在一个zip压缩包,详细操作请参考下载SDK配置和证书。
- 单击“立即注册”。
- 注册完成后,在“已注册区块链”页面生成一条记录,在“操作”列下载配置文件和证书。请妥善保管对应证书的私钥,建议您进行加密保存。
后续操作
注册成功后,支持修改和删除已注册区块链。
- 在“已注册区块链”页面,单击“操作”列“更多 > 编辑”。
- 在打开的页面,根据需要更新区块链的描述信息、合约名称、配置文件、证书。
- 单击“确定”。
- 在打开的提示框中,单击“确认”完成更新。
- 若需要删除该区块链,单击“操作”列“更多 > 删除”。删除区块链前,请先删除对应的跨链通道。