hyperledge工具-configtxlator
参考:http://www.blockchainbrother.com/article/1337
1.作用:
因为无论配置交易文件 .tx和初始区块文件 .block都是二进制格式,用户无法直接编辑。
configtxlator工具将这些配置文件在二进制格式和方便阅读的json格式之间进行转换。
开发 configtxlator
工具是为了支持独立于SDK来进行重新配置。configtxlator
工具被设计为提供一个API让任意一个SDK的用户都能够与之交互来更新配置。
工具的名称是 configtx 和 translator 的拼接,意在传达该工具简单地在不同的等效数据之间进行转换。 它不产生配置。也不提交或撤回配置。它不修改配置本身,只是简单地提供一些配置格式的不同的双射展现。
2.配置该工具的方法有:
该工具的源码在github.com/hyperledger/fabric/common/tools/configtxlator
1)在github.com/hyperledger/fabric目录下运行:
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ make configtxlator
.build/bin/configtxlator
CGO_CFLAGS=" " GOBIN=/opt/gopath/src/github.com/hyperledger/fabric/.build/bin go install -tags "" -ldflags "-X github.com/hyperledger/fabric/common/tools/configtxlator/metadata.CommitSHA=325999f" github.com/hyperledger/fabric/common/tools/configtxlator
Binary available as .build/bin/configtxlator
然后会生成./build/bin/configtxlator可执行文件
2)在github.com/hyperledger/fabric/common/tools/configtxlator目录下运行go build
3.标准用法:
- 首先使用SDK取出最新的配置
- 然后使用configtxlator 工具产生将二进制文件转成可读版本的配置文件
- 这样用户或者应用就可以编辑配置文件
- 接着使用 configtxlator 工具计算更新的配置与原有配置的差异
- 最后使用SDK提交配置以及签名
configtxlator
工具暴露一个完全无状态的 REST API 接口用来和配置匀速进行交互。 这些 REST 组件支持本地的配置和可读的JSON格式配置文件进行相互转换, 同时根据配置文件的差异计算配置的更新。
因为 configtxlator
工具特意没有包含任何密码工具和密钥信息, 所有它没有任何权限控制。 预计的典型部署方式是运行在沙盒容器中, 所以在本地的应用中, 有一个专用的 configtxlator
进程给每一个使用者。
4.如何使用该工具
1)查看该工具能够使用的命令:
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ configtxlator --help
usage: configtxlator [<flags>] <command> [<args> ...] 用于生成Hyperledger Fabric通道配置的实用程序 Flags:
--help 显示上下文敏感的帮助信息 (also try --help-long and --help-man). Commands:
help [<command>...]
显示帮助信息. start [<flags>]
开启configtxlator REST服务端 proto_encode --type=TYPE [<flags>]
转换JSON文件成指定的protobuf格式 proto_decode --type=TYPE [<flags>]
转换proto信息为JSON格式 compute_update --channel_id=CHANNEL_ID [<flags>]
带两个编码的common.Config消息,并计算在两者之间转换的配置更新。
version
显示版本信息
1》start — 开启服务端
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ configtxlator help start
usage: configtxlator start [<flags>]
开启configtxlator REST服务端 Flags:
--help 显示上下文敏感的帮助信息(also try --help-long and
--help-man).
--hostname="0.0.0.0" REST服务端坚挺的主机名或IP地址,默认为0.0.0.
--port= REST服务端坚挺的端口,默认为7059
--CORS=CORS ... 容许的CORS(跨来源资源共享)域名, 如'*' or 'www.example.com'(may be repeated).
工具启动一个服务器监听指定的端口且等待处理请求,如在本地8080端口启动rest服务
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ configtxlator start --hostname="127.0.0.1" --port=
-- ::26.715 UTC [configtxlator] startServer -> INFO Serving HTTP requests on 127.0.0.1:
这是开启了一个REST服务端,但是其实我们也可以不用启动这个服务端,直接使用的命令行进行操作
2》proto解码
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ configtxlator help proto_decode
usage: configtxlator proto_decode --type=TYPE [<flags>] 将proto信息转换成JSON格式 Flags:
--help 显示上下文敏感的帮助信息 (also try --help-long and
--help-man).
--type=TYPE 要解码的protobuf结构的类型。比如'common.Config'
--input=/dev/stdin 指定包含proto信息的文件,,默认为/dev/stdin,即控制台输入
--output=/dev/stdout 指定要将解码所得的JSON信息写入的文件,默认为/dev/stdout,即控制台输出
configtxlator
命令用来将fabric的数据结构在protobuf和JSON 之间进行转换,也可以用来创建配置更新。
- 该命令可以启动一个REST 服务来通过HTTP暴露服务接口,
- 也可以直接在命令行使用
1> 如果使用的是启动一个REST 服务来通过HTTP暴露服务接口的方法,那么需要运行configtxlator start命令开启服务,如上面进行的操作
要转换原型到可读的 JSON 格式,只要发送二进制原型到 rest 目标http://$SERVER:$PORT/protolator/decode/<message.Name>
,<message.Name>
是合法原型名的全称,合法原型名如下:
- common.Block:区块结构;
- common.Envelope:带有效载荷和数字签名的数字信封,区块的数据部分就是序列化后的数字信封;
- common.ConfigEnvelope:包含链配置的数字信封,内容包含ConfigUpdateEnvelope;
- common.ConfigUpdateEnvelope:提交给排序节点的配置数字信封;
- common.Config:ConfigEnvelope的配置部分;
- common.ConfigUpdate:ConfigUpdateEnvelope的一部分。
然后进行解码。例如,为了解析一个存储为 configuration_block.pb
的配置区块,执行命令:
curl -X POST --data-binary @configuration_block.pb http://127.0.0.1:8080/protolator/decode/common.Block
2>另一种方式就是不启动服务端,直接使用命令进行操作,上面的例子可以写成:
configtxlator proto_decode --input configuration_block.pb --type common.Block
3》proto编码
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ configtxlator help proto_encode
usage: configtxlator proto_encode --type=TYPE [<flags>] 将JSON文件转移成protobuf. Flags:
--help 显示上下文敏感的帮助信息(also try --help-long and
--help-man).
--type=TYPE 指定要编码成的protobuf结构的类型,比如'common.Config'.
--input=/dev/stdin 指定要转换的JSON文件,默认为/dev/stdin,即控制台输入
--output=/dev/stdout 指定将输出写如的文件,默认为/dev/stdout,即控制台输出
1>通过HTTP暴露服务接口编码,举例将控制台输入的json格式的policy,转换为protobuf格式并存入文件policy.pb:
curl -X POST --data-binary /dev/stdin http://127.0.0.1:8080/protolator/encode/common.Policy > policy.pb
2>命令行格式为:
configtxlator proto_encode --type common.Policy --output policy.pb
4》compute_update
vagrant@ubuntu-xenial:/opt/gopath/src/github.com/hyperledger/fabric$ configtxlator help compute_update
usage: configtxlator compute_update --channel_id=CHANNEL_ID [<flags>] 计算生成两个common.Config消息之间的配置更新 Flags:
--help 显示上下文敏感的帮助信息(also try --help-long and
--help-man).
--original=ORIGINAL 原始的配置信息
--updated=UPDATED 更新后的配置信息下
--channel_id=CHANNEL_ID 这次更新的通道的名字T
--output=/dev/stdout 指明将JSON文件写入的文件,默认为/dev/stdout,即控制台输出
1>通过HTTP暴露服务接口编码,举例计算从original_config.pb到modified_config.pb的配置更新,并在stdout输出JSON解码后的数据:
configtxlator compute_update --channel_id testchan --original original_config.pb --updated modified_config.pb | configtxlator proto_decode --type common.ConfigUpdate
2>命令行格式为:
curl -X POST -F channel=testchan -F "original=@original_config.pb" -F "updated=@modified_config.pb" "http://127.0.0.1:8080/configtxlator/compute/update-from-configs" | curl -X POST --data-binary /dev/stdin "http://127.0.0.1:8080/protolator/encode/common.ConfigUpdate"
hyperledge工具-configtxlator的更多相关文章
- hyperledge工具-configtxgen
参考http://www.blockchainbrother.com/article/1339 configtxgen是Hyperledger Fabric提供的用于通道配置的实用程序,主要生成以下3 ...
- hyperledge工具-cryptogen
参考:http://baijiahao.baidu.com/s?id=1596614770784685300&wfr=spider&for=pc cryptogen是Hyperledg ...
- hyperledger中文文档学习-4-构建第一个fabric网络
接下来的操作都将在hyperledge环境安装构建的虚拟机的环境下进行 参考https://hyperledgercn.github.io/hyperledgerDocs/build_network_ ...
- Hyperledger Fabric 动态增加组织到网络中
本文基于Hyperledger Fabric 1.4版本. 官方文档地址:传送门 动态添加一个组织到Fabric网络中也是一个比较重要的功能.官方文档写的已经很详细了,有能力的尽量还是看官方文档,本文 ...
- 【干货干货】configtxlator 工具介绍
这一章我们对configtxlator做一个解说. 1, configtxlator 他是什么,有什么用? configtxlator 官方说明是用于生成Hyperledger结构通道配置的实用程序: ...
- Unity3d入门 - 关于unity工具的熟悉
上周由于工作内容较多,花在unity上学习的时间不多,但总归还是学习了一些东西,内容如下: .1 根据相关的教程在mac上安装了unity. .2 学习了unity的主要的工具分布和对应工具的相关的功 ...
- 细说前端自动化打包工具--webpack
背景 记得2004年的时候,互联网开发就是做网页,那时也没有前端和后端的区分,有时一个网站就是一些纯静态的html,通过链接组织在一起.用过Dreamweaver的都知道,做网页就像用word编辑文档 ...
- 应用工具 .NET Portability Analyzer 分析迁移dotnet core
大多数开发人员更喜欢一次性编写好业务逻辑代码,以后再重用这些代码.与构建不同的应用以面向多个平台相比,这种方法更加容易.如果您创建与 .NET Core 兼容的.NET 标准库,那么现在比以往任何时候 ...
- .NetCore中的日志(2)集成第三方日志工具
.NetCore中的日志(2)集成第三方日志工具 0x00 在.NetCore的Logging组件中集成NLog 上一篇讨论了.NetCore中日志框架的结构,这一篇讨论一下.NetCore的Logg ...
随机推荐
- Django APP打包重用
引言 有时候,我们需要将自己写的app分发(dist)给同事,分享给朋友,或者在互联网上发布,这都需要打包.分发我们的app. Django的子系统重用是基于app级别的.也就是一个项目可以包含多个互 ...
- (python)排序算法
一.冒泡排序 1.冒泡排序实现思路 需要两层循环,外层循环控制总共循环几次,内层循环控制交换的次数(注意索引超界的问题). 外层第一次循环,内层第一次循环,将第一个元素(y)与第二个元素(y+1)进行 ...
- [20181214]open file using O_DIRECT.txt
[20181214]open file using O_DIRECT.txt --//因为一个测试需要,需要写一个测试小例子,验证使用O_DIRECT打开文件每次都是从磁盘读取.--//没想到浪费1个 ...
- Java读取.properties配置文件
一.介绍 Properties文件在Java中主要为配置文件,文件类型为:.properties,格式为文本文件,内容格式为"键=值" 二.读取 这里我采用的是getResourc ...
- c/c++求解图的关键路径 critical path
c/c++求解图的关键路径 critical path 上图表示一个工程,工程以V1为起始子工程,V9为终止子工程. 由图可以看出,要开工V5工程,必须在完成工程V2和V3后才可以. 完成V2需要a1 ...
- NPOI 笔记
前言 文档:http://npoi.codeplex.com/documentation 示例:https://npoi.svn.codeplex.com/svn/ 下载:https://www.nu ...
- 表单取消历史保存之autocomplete的用法
表单取消历史保存之autocomplete的用法 应用场景 浏览器开启了表单自动填充设置后,有些表单中的input元素在添加时会以下拉的形式显示以前填写过的表单,有时候可能会影响用户的使用.比如:da ...
- [HBase_1] HBase安装与配置
0. 说明 1. 简介 1.1 简介 基于 HDFS 的大表软件(实时数据库) 十亿行 x 百万列 x 上千个版本 版本是通过 mvcc 技术控制:multiple version concurren ...
- 基于SurfaceView的可拖动视频控件
视频播放控件(一) 可拖动,变换SurfaceView public class DragSurfaceView extends SurfaceView implements View.OnTouch ...
- C# -- 二分法查找
二分法查找:适用于已经排序好的数组 1.二分法查找(入门案例) static void Main(string[] args) { , , , , , , , , , , , , , , , , , ...