启动Fabric网络
主要步骤包括计划拓扑、准备相关配置文件、启动Orderer节点、启动Peer节点和操作网络等。
网络拓扑
启动的Fabric网络中包括一个Orderer节点和四个Peer节点,以及一个管理节点生成相关启动文件
在网络启动后作为操作客户端执行命令。四个Peer节点分属于同一个管理域(example.com)下的两个组织Org1和Org2,这两个组织都加入同一个应用通道(business-channel)中。每个组织中的第一个节点(peer0节点)作为锚节点与其他组织进行通信,所有节点通过域名都可以相互访问,
整体网络拓扑如下图所示。
准备相关配置文件
Fabric网络在启动之前,需要提前生成一些用于启动的配置文件,主要包括MSP相关文件(msp/*)、TLS相关文件(tls/*)、系统通道初始区块(orderer.genesis.block)、新建应用通道交易文件(businesschannel.tx)、锚节点配置更新交易文件Org1MSPanchors.tx和Org2MSPanchors.tx)等。
各个文件的功能如下所示。
生成组织关系和身份证书
Fabric网络提供的是联盟链服务,联盟由多个组织构成,组织中的成员提供了节点服务来维护网络,并且通过身份来进行权限管理。因此,首先需要对各个组织和成员的关系进行规划,分别生成对应的身份证书文件,并部署到其对应的节点上。
用户可以通过PKI服务(如使用fabric-ca)或者OpenSSL工具来手动生成各个实体的证书和私钥。但当组织结构比较复杂时,这种手动生成的方式容易出错,并且效率不高。
Fabric项目提供了cryptogen工具(基于crypto标准库)实现自动化生成。这一过程首先依赖crypto-config.yaml配置文件。crypto-config.yaml配置文件的结构十分简单,支持定义两种类型(OrdererOrgs和PeerOrgs)的若干组织。每个组织中又可以定义多个节点(Spec)和用户(User)。
一个示例的crypto-config.yaml配置文件内容如下,其中定义了一个OrdererOrgs类型的组织Orderer(包括一个节点orderer.example.com),以及两个PeerOrgs类型的组织Org1和Org2(分别包括2个节点和1个普通用户)。
使用该配置文件,通过如下命令可以为Fabric网络生成指定拓扑结构的组织和身份文件,存放到crypto-config目录下:
$ cryptogen generate --config=./crypto-config.yaml --output ./crypto-config
查看crypto-config目录结构,按照示例crypto-config.yaml中的定义进行生成:
$ tree -L 4 crypto-config
按照crypto-config.yaml中的定义,所生成的crypto-config目录下包括多级目录结构。
ordererOrganizations下包括构成Orderer组织(1个Orderer节点)的身份信息;
peerOrganizations下为所有的Peer节点组织(2个组织,4个节点)的相关身份信息。
其中最关键的是msp目录,代表了实体的身份信息。
对于Orderer节点来说,需要将crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com目录下的内容(包括msp和tls两个子目录)复制到Orderer节点的/etc/hyperledger/fabric路径(与Orderer自身配置一致)下。
对于Peer节点来说,则需要复制peerOrganizations下对应的身份证书文件。
以org1的peer0为例,将crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com目录下的内容(包括msp和tls)复制到Peer0节点的/etc/hyperledger/fabric(与Peer自身配置一致)路径下。
对于客户端节点来说,为了方便操作,可将完整的crypto-config目录复制到/etc/hyperledger/fabric(与configtx.yaml中配置一致)路径下。
注意 目前,组织结构一旦生成,如果要进行修改,只能手动对证书进行调整,因此需要提前做好联盟的规划。未来会支持对组织结构和节点身份进行动态在线调整。
生成Ordering服务启动初始区块
Orderer节点在启动时,可以指定使用提前生成的初始区块文件作为系统通道的初始配置。
初始区块中包括了Ordering服务的相关配置信息以及联盟信息。
初始区块可以使用configtxgen工具进行生成。生成过程需要依赖/etc/hyperledger/fabric/configtx.yaml文件。configtx.yaml配置文件定义了整个网络中的相关配置和拓扑结构信息。
编写configtx.yaml配置文件可以参考Fabric代码中(如examples/e2e_cli路径下或sampleconfig路径下)的示例。
该配置文件定义了两个模板:TwoOrgsOrdererGenesis和TwoOrgsChannel,其中前者可以用来生成Ordering服务的初始区块文件。通过如下命令指定使用configtx.yaml文件中定义的TwoOrgsOrdererGenesis模板,来生成Ordering服务系统通道的初始区块文件。
注意这里排序服务类型采用了简单的solo模式,生产环境中可以采用kafka集群服务:
$ configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./orderer.genesis.block
所生成的orderer.genesis.block需要复制到Orderer节点上(与Orderer配置中ORDERER_GENERAL_GENESISFILE指定文件路径一致,默认放到/etc/hyperledger/fabric路径下),在启动Orderering服务时进行使用。3.生成新建应用通道的配置交易新建应用通道时,需要事先准备好配置交易文件,其中包括属于该通道的组织结构信息。这些信息会写入该应用通道的初始区块中。同样需要提前编写好configtx.yaml配置文件,之后可以使用configtxgen工具来生成新建通道的配置交易文件。为了后续命令使用方便,将新建应用通道名称busi