# 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配置文件示例
```bash
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
- &Org1
Name: Org1MSP
ID: Org1MSP
AnchorPeers: #锚节点地址，用于跨组织的Gossip通信
Port: 7051
- &Org2
Name: Org2MSP
ID: Org2MSP
AnchorPeers: #锚节点地址，用于跨组织的Gossip通信
Port: 7051
Orderer: &OrdererDefaults
OrdererType: solo # Orderer共识插件类型，分solo或kafka
Addresses:
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为应用通道所关联的联盟名称。
-表示数组，&表示锚点，*表示引用，<<表示合并到当前数据。
## 3、configtx.yaml配置文件相关的结构体及方法
### 3.1、configtx.yaml配置文件相关的结构体定义
```go
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配置文件相关的方法
```go
//获取指定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接口定义：
```go
type Generator interface {
bootstrap.Helper
ChannelTemplate() configtx.Template //获取用于初始化通道的模板
GenesisBlockForChannel(channelID string) *cb.Block //用于outputBlock
}
//代码在common/configtx/tool/provisional/provisional.go
```