超级账本Fabric学习（二）Fabric1.0.0网络搭建（上）
超级账本Fabric学习（二）Fabric1.0.0版网络搭建（上）配置文件
- 1：配置文件准备
- 1.1：公私钥与证书
- 1.2：配置与介绍crypto-config.yaml文件
- 1.3：配置与介绍configtx.yaml文件
- 2：创世配置构造
- 2.1：MSP证书
- 2.2：Orderer创世区块
- 2.3：Channel创世交易/区块(通道的配置交易)
- 2.4：组织主节点配置文件
看完博客之后有喜欢的网友可以点赞关注哦，毕竟大家的支持就是我写博客的动力。
2020年8月7日，整理于家中。
注意：这里我们虽说是配置文件和搭建网络，但是为了大家方便理解我们并不做修改，多是介绍和讲解
1：配置文件准备
1.1：公私钥与证书
Fabric中有两种类型的公私钥和证书
- 第一种：一种是给节点之间，为了通讯安全而准备的TLS证书
- 第二种：另一种是用户登录和权限控制的用户证书
- （本来这些证书都应该是由CA来颁发的，但是我们这里是测试环境，并没有启用CA节点，这里我们使用cryptogen工具来生成这两种证书）
1.2：配置与介绍crypto-config.yaml文件
注意：该文件在 fabric-samples/first-network目录下
作用：
- crypto-config.yaml主要用于配置组织节点的个数，以及每个组织里面有用户的个数。
- 后面cryptogen工具还会根据该文件作为参数配置，生成这些组织，节点，用户相应的证书
也可以说是cryptogen工具读取这个配置文件产生证书和密钥。
重点：crypto-config.yaml文件源码详解
整个crypto-config.yaml源码可以分为两个部分：OrdererOrgs（排序节点组织) 和PeerOrgs（peer节点组织）
图片当中的注释可以参考
OrdererOrgs部分：
注意：上面源码中，我们使用了Specs的方式来定义了多个orderer节点，目前有三种模式：
- solo 模式:只允许有一个orderer节点，单个节点就可以部署。
- kafka模式：允许有一个或多个orderer节点，是需要群集支持（kafka和zookeeper）
- etcdraft模式：orderer本身集成了etcd服务，只需要启动一个或多个orderer即可，不需要额外的组件支持。
总结：solo模式仅供开发测试阶段使用，生产环境可以选择kafka或etcdraft。
PeerOrgs部分：
经过以上介绍之后，crypto-config.yaml配置文件可以根据我们自己的实际运用场景进行修改。
手动生成证书/密钥：
像上一篇博客中这一步的工作是直接靠byfn.sh脚本完成的，就是在脚本当中定义并调用了一个叫做generateCerts的函数,并且也使用了cryptogen工具。这里我们手动的话，根据configtx.yaml定义的网络配置，使用cryptogen工具生成证书，需要提供出工具所在的相对路径，然后加上cryptogen命令即可，工具二进制文件在fabric-samples/bin目录中。
../bin/cryptogen generate --config=./crypto-config.yaml
如果命令执行成功后，终端会显示如下内容：
org1.exmples.com
org2.exmples.com
而上述操作成功后生成的证书和密钥会保存在一个叫做crypto-config的文件夹中，如果我们之前没有在执行命令的目录下创建该文件夹，则会自动创建。如果之前拉取的源码目录下已经有这个目录，并且里面已经有了证书和密钥，可以把他们删除了，然后再自己测试一下。
该目录下，按照组织，节点，用户三大体系分类，不同的子目录下存放着各自的各种证书以及密钥。但如果我们仔细去看的话就会发现里面有很多证书都是一样的，比如说cacerts证书（CA证书）。就是"ca.example.com.cert.pem"文件
关于证书，我们现在可以不必过多的去关注，只需要知道他针对每一个组织，每一个节点，以及每一个用户都生成了一套证书就可以了。
而且每一套证书都包括CA呀，Amin证书，以及签名证书，加密通信证书等等。
1.3：配置与介绍configtx.yaml文件
注意：该文件在 fabric-samples/first-network目录下
作用：
configtx.yaml主要用于配置这个区块链联盟当中的组织信息
比如：
- 组织的名字呀，及对应的证书的位置。
- 对于peer节点来说，还有他的对外的主节点(锚节点AnchorPeer)
- 对于order节点来说，还有他共识机制的选择，区块的时间间隔呀，每一个块中能包含的交易的数量，块的大小，等等这些信息 。
configtxgen工具用于创建四个配置网络工件：
- genesis.block(创世区块)
- channek.tx(通道配置交易)
- Org1MSPchors.tx(锚节点交易)和Org2MSPchors.tx
解析：
其中创世区块是排序服务的创世区块；通道配置交易是在通道创建时广播给orderer；锚节点交易指定通道上每个组织的锚节。configtxgen将配置文件configtx.yaml作为参数配置，默认的configtx.yaml包含三个组织：一个orderer组织（OrdererOrg)和两个peer组织(Org1,Org2).每个peer组织维护两个peer节点（peer0,peer1），该文件还指定了一个联盟SampleConsortium,该联盟包含两个组织。
下面将插入configtx,yaml文件的源码图片，里面有中文注释，进行详细介绍
config.tx,yaml文件分为很多配置段，其中最为重要的是profiles配置段，该配置段相当于一个入口，通过configtxgen配置工具的-profiles参数指定选择哪个profile生成相应的文件，相当于一个回调函数的感觉，其他配置段都会在profiles配置端=段根据需求进行引用。
fabric中的configtx.yaml文件可以分为四个部分，四段，分别是：
- Profiles(配置入口段)
- Organizations(组织配置段)
- Orderer(排序节点配置段)
- Application(应用通道相关配置段)
Profiles
Organizations
Orderer
Application
2：创世配置构造
有了这两个配置文件下面我们就可以取构造区块链的创世配置了
创世配置的构造包括以下几个部分：
- MSP证书
- Orderer创世区块
- Channel创世交易/区块
*更新组织主节点的配置文件
2.1：MSP证书
第一个配置就是组织 ，节点，用户的证书。组织，节点，用户是三套不同的证书体系。而每一套证书体系都包括比如说：CA证书，加密通信的证书（tls证书），以及签名证书（sign)等等。
这一步就是上面将crypto-config.yaml文件生成各种证书和密钥的那一步。
生成证书文件：
cd ~/go/src/github.com/hypeledger/fabric-samples/first-network
../bin/cryptogen generate --config=./crypto-config.yaml
2.2：Orderer创世区块
目前通道分为两种类型：
-
系统通道
解释：排序节点通过系统通道来管理应用通道。
-
应用通道
解释：用户的交易信息通过应用通道传递，对一般用户来说，通道是指应用通道。
通过这个区块我们解决的是先有鸡还是现有蛋的问题，得先有系统链才能去创建其他链。
该创世区块是指生成系统通道的创世区块，主要用于启动Ordering服务，配置网络中的策略。
生成Orderer创世区块
用到configtxgen工具和configtx.yaml文件
configtxgen工具参数信息以及解释：
Usage of configtxgen:
1.-asOrg string
#作为特定的组织（按名称string）执行配置生成，包括org（可能）有权设置的写集中的值。如用来指明锚节点所在的组织。
2.-channelCreateTxBaseProfile string
#指定一个概要文件作为orderer系统通道当前状态，以允许再通道创建tx期间修改非应用程序参数。仅在与outputCreatChannelTx组合 #时有效。
3.-channelID string
#在configtx中使用的通道ID，及通道名称。
4.-configPath string
#包含要使用的配置路径（如果设置的话）
5.-inspectBlock string
#按指定路径打印块中包含的配置，用来检查通道的配置信息。
6.-inspectChannelCreateTx string
#按指定路径打印块中包含的配置，用于检查和输出通道中创世区块的内容，锚节点在configtx.yaml中的AnchorPeers中指定。
7.-outputAnchorPeerUpdate string
#创建一个配置更新来更新锚节点（仅在默认通道创建时工作，并且仅在第一次更新时工作）
8.-outputBlock string
#将genesis块写入（如果设置）的路径。confitx.yaml文件中的Profiles要指定Consortiums,否则启动排序服务节点失败。
9.-outputCreateChannelTx string
#将通道配置交易文件写入（如果设置）的路径。configtx.yaml文件中的Profiles必须包括Application,否则创建通道会失败。
10.-profile string
#指定使用的时configtx.yaml中某个用于生成的Profiles配置项。
11.-printOrg string
#将组织的定义打印为JSON。（对于手动向通道添加组织非常有用）
12.-version
#显示版本信息
接下来我们要告诉configtxgen工具在哪里能够寻找到他需要的configtx.yaml文件，我们告诉他当前路径
cd ~/go/src/hyperledger/fabric-samples/first-network
FABRIC_CFG_PATH=$PWD
生成创世区块的命令如下：
#cd到之前生成MSP证书的config目录下创建一个名叫channel-artifacts的目录
cd ~/go/src/github.com/hyperledger/fabric-samples/first-network/config
mkdir channel-artifacts
#cd回first-network目录下
cd ../
../bin/configtxgen -profile TwoOrgsOrderGenesis -outputBlock ./config/channel-artifacts/genesis.block
2.3：Channel创世交易/区块(通道的配置交易)
顾名思义，就是去构建通道的第一笔交易，这笔交易是一笔配置交易，包括了通道的初始化信息，并且这笔交易会被单独包装成一块区块，也就是这个通道的创世区块。
命令如下：
#同样是在first-network 目录下
../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./config/channel-artifacts/mychannel.tx / -channelID mychannel
2.4：组织主节点配置文件
就是去生成每个组织主节点的配置交易，在实际生产中也是可以不做的，因为在组织内部的peer节点之间，他们是通过Goosip协议进行区块同步的，如果我们没有去设置主节点，Goosip协议也会去动态选举一个主节点出来。
生成组织的锚节点交易，虽然这一步是没有必要的，但为了记录笔记，还是写上为好。
#在哪个路径下我都不想说了
../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./config/channel-artifacts/Org1MSPanchors.tx -channelID mychannel -asOrg Or1MSP
../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./config/channel-artifacts/Org2MSPanchors.tx -channelID mychannel -asOrg Or2MSP
以上所有操作当中一个字母都不能错，有一个错了，都会造成错误和偏差，所以请谨慎小心为妙。
上面四次操作如果都成功的话会在config/channel-artifacts目录下生成以下四个文件：
后面剩下的就是启动网络了，这一部分放到下一篇博客讲解，我们这里采用的是docker-compose的方式来部署环境，所以接下来我们就可以配置docker-compose的yaml文件，以便顺利启动Fabric的docker环境。详情请看下一篇博客。这篇博客十分重要哦，毕竟涉及到了：docker-compose-cli.yaml , docker-compose-base.yaml , peer-base.yaml