区块链教程Fabric1.0源代码分析配置交易-生成通道配置-兄弟连-阿里云开发者社区

开发者社区> 微服务> 正文

区块链教程Fabric1.0源代码分析配置交易-生成通道配置-兄弟连

简介:

Fabric 1.0源代码笔记 之 configtx(配置交易) #configtxgen(生成通道配置)

1、configtxgen概述

configtxgen,用于生成通道配置,具体有如下三种用法:

  • 生成Orderer服务启动的初始区块(即系统通道的创世区块文件)
        * configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block
  • 生成新建应用通道的配置交易(即用于创建应用通道的配置交易文件)
        * configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychannel
  • 生成锚节点配置更新文件
        * configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID mychannel -asOrg Org1MSP

    
configtxgen代码分布在common/configtx/tool目录,目录结构如下:

  • localconfig/config.go,configtx.yaml配置文件相关的结构体及方法。

2、configtx.yaml配置文件示例

Profiles:
    TwoOrgsOrdererGenesis: #Orderer系统通道配置
        Orderer:
            <<: *OrdererDefaults #引用OrdererDefaults并合并到当前
            Organizations: #属于Orderer通道的组织
                - *OrdererOrg 
        Consortiums: #Orderer所服务的联盟列表
            SampleConsortium:
                Organizations:
                    - *Org1
                    - *Org2
    TwoOrgsChannel: #应用通道配置
        Consortium: SampleConsortium #应用通道关联的联盟
        Application: 
            <<: *ApplicationDefaults #引用ApplicationDefaults并合并到当前
            Organizations: #初始加入应用通道的组织
                - *Org1
                - *Org2
Organizations:
    - &OrdererOrg
        Name: OrdererOrg
        ID: OrdererMSP # MSP ID
        MSPDir: crypto-config/ordererOrganizations/example.com/msp #MSP相关文件本地路径
    - &Org1
        Name: Org1MSP
        ID: Org1MSP
        MSPDir: crypto-config/peerOrganizations/org1.example.com/msp
        AnchorPeers: #锚节点地址,用于跨组织的Gossip通信
            - Host: peer0.org1.example.com
              Port: 7051
    - &Org2
        Name: Org2MSP
        ID: Org2MSP
        MSPDir: crypto-config/peerOrganizations/org2.example.com/msp
        AnchorPeers: #锚节点地址,用于跨组织的Gossip通信
            - Host: peer0.org2.example.com
              Port: 7051
Orderer: &OrdererDefaults
    OrdererType: solo # Orderer共识插件类型,分solo或kafka
    Addresses:
        - orderer.example.com:7050 #服务地址
    BatchTimeout: 2s #创建批量交易的最大超时,一批交易构成一个块
    BatchSize: #写入区块内的交易个数
        MaxMessageCount: 10 #一批消息的最大个数
        AbsoluteMaxBytes: 98 MB #一批交易的最大字节数,任何时候均不能超过
        PreferredMaxBytes: 512 KB #批量交易的建议字节数
    Kafka:
        Brokers: #Kafka端口
            - 127.0.0.1:9092
    Organizations: #参与维护Orderer的组织,默认空
Application: &ApplicationDefaults
    Organizations: #加入到通道的组织信息,此处为不包括任何组织

配置文件解读:

  • 每个Profile表示某种场景下的通道配置模板,包括Orderer系统通道模板和应用通道模板,其中TwoOrgsOrdererGenesis为系统通道模板,TwoOrgsChannel为应用通道模板。
  • Orderer系统通道模板,包括Orderer和Consortiums,其中Orderer指定系统通道配置,Consortiums为Orderer服务的联盟列表。
  • 应用通道,包括Application和Consortium,其中Application为应用通道的配置,Consortium为应用通道所关联的联盟名称。
        

附:YAML 语言教程
-表示数组,&表示锚点,*表示引用,<<表示合并到当前数据。

3、configtx.yaml配置文件相关的结构体及方法

3.1、configtx.yaml配置文件相关的结构体定义

type TopLevel struct {
    Profiles      map[string]*Profile //通道配置
    Organizations []*Organization //组织
    Application   *Application //应用通道配置
    Orderer       *Orderer //系统通道配置
}

type Profile struct { //通道配置:系统通道配置或应用通道配置
    Consortium  string //应用通道配置中通道所关联的联盟名称
    Application *Application //应用通道配置
    Orderer     *Orderer //系统通道配置
    Consortiums map[string]*Consortium //系统通道配置中Orderer服务的联盟列表
}

type Consortium struct { //联盟,即组织列表
    Organizations []*Organization //组织
}

type Application struct { //应用通道配置,即初始加入通道的组织
    Organizations []*Organization
}

type Organization struct { //组织
    Name           string //组织名称
    ID             string //组织MSP ID
    MSPDir         string //组织MSP文件所在路径
    AdminPrincipal string //管理员身份规则
    AnchorPeers []*AnchorPeer //锚节点列表
}

type AnchorPeer struct { //锚节点,即主机和端口
    Host string
    Port int
}

type Orderer struct { //系统通道配置
    OrdererType   string //共识插件类型
    Addresses     []string //Orderer服务地址
    BatchTimeout  time.Duration //批处理超时
    BatchSize     BatchSize //批处理大小
    Kafka         Kafka //Kafka
    Organizations []*Organization //参与维护Orderer的组织,默认空
    MaxChannels   uint64 //Orderer最大通道数
}

type BatchSize struct { //批处理大小
    MaxMessageCount   uint32 //最大交易数量
    AbsoluteMaxBytes  uint32 //最大字节数
    PreferredMaxBytes uint32 //建议字节数
}

type Kafka struct {
    Brokers []string //Kafka Broker
}
//代码在common/configtx/tool/localconfig/config.go

3.2、configtx.yaml配置文件相关的方法

//获取指定profile的Profile结构
func Load(profile string) *Profile 
//将Profile校验并补充完整
func (p *Profile) completeInitialization(configDir string) 
func translatePaths(configDir string, org *Organization) 
//代码在common/configtx/tool/localconfig/config.go

4、Generator接口及实现

Generator接口定义:

type Generator interface {
    bootstrap.Helper
    ChannelTemplate() configtx.Template //获取用于初始化通道的模板
    GenesisBlockForChannel(channelID string) *cb.Block //用于outputBlock
}
//代码在common/configtx/tool/provisional/provisional.go

未完待续欢迎关注兄弟连区块链教程分享!

版权声明:本文首发在云栖社区,遵循云栖社区版权声明:本文内容由互联网用户自发贡献,版权归用户作者所有,云栖社区不为本文内容承担相关法律责任。云栖社区已升级为阿里云开发者社区。如果您发现本文中有涉嫌抄袭的内容,欢迎发送邮件至:developer2020@service.aliyun.com 进行举报,并提供相关证据,一经查实,阿里云开发者社区将协助删除涉嫌侵权内容。

分享:
微服务
使用钉钉扫一扫加入圈子
+ 订阅

构建可靠、高效、易扩展的技术基石

其他文章