Hyperledger Fabric 核心模块configtxlator工具

Posted 2021-06-26 thefist11

1. 定义

无论“配置交易文件 .tx”和“初始区块文件 .block”都是二进制格式，用户都无法直接编辑。configtxlator工具主要是用于将这些配置文件在二进制格式和方便阅读的json格式之间进行转换。

• 工具的名称是 configtx 和 translator 的拼接，意在传达该工具简单地在不同的等效数据之间进行转换。 它不产生配置。也不提交或撤回配置。它不修改配置本身，只是简单地提供一些配置格式的不同的双射展现。
• 没有包含任何密码工具和密钥信息， 所有它没有任何权限控制。
• 预计的典型部署方式是运行在沙盒容器中， 所以在本地的应用中， 有一个专用的configtxlator 进程给每一个使用者。

1.1 REST API 接口

被设计为提供一个API让任意一个SDK的用户都能够与之交互来更新配置，其暴露一个完全无状态的 REST API 接口用来和配置匀速进行交互。

2. 参数和功能

• 支持本地的配置和可读的JSON格式配置文件进行相互转换
• 根据配置文件的差异计算配置的更新。

分为 编码(proto_encode)、解码(proto_decode)、对比修改结构(compute_update)以及版本信息(version)。

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
    显示版本信息

3.标准用法

step1. 使用SDK取出最新的配置
step2. 使用configtxlator工具产生将二进制文件转成可读版本的配置文件，这样用户或者应用就可以编辑配置文件
step3. 使用 configtxlator 工具计算更新的配置与原有配置的差异
step4. 使用SDK提交配置以及签名