Hyperledger Fabric 1.0 从零开始（六）——创建Fabric多节点集群

4：创建Fabric多节点集群

4.1、配置说明

首先可以根据官方Fabric自带的e2e_cli列子中的集群方案来生成我们自己的集群，与案例不同的是我们需要把容器都分配到不同的服务器上，彼此之间通过网络来进行通信，网络构建完成后则进行相关的channel和chaincode操作。

笔者目前申请了五台服务器，所有的服务器均是按照上述e2e_cli环境构建与测试步骤配置。计划其中四台服务器运行peer节点，另外一台服务器运行orderer节点，为其它四个节点提供order服务。

虚拟机具体参数如下表所示：

名称	ip	节点标识	节点Hostname	Organization（组织机构）
Server1	10.130.116.8	orderer	orderer.example.cn	Orderer
Server2	10.130.116.9	sp0	peer0.org1.example.cn	Org1
Server3	10.130.116.10	sp1	peer1.org1.example.cn	Org1
Server4	10.130.116.25	sp2	peer0.org2.example.cn	Org2
Server5	10.130.116.27	sp3	Peer1.org2.example.cn	Org2

4.2、生成公私钥、证书、创世区块等

公私钥和证书是用于Server与Server之间的安全通信，另外要创建channel并让其它节点加入channel就需要创世区块，这些必备文件都可以通过一个命令生成，并且官方已经给出了脚本，在如下目录中的文件：

/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/ generateArtifacts.sh

使用generateArtifacts.sh生成证书和config.tx，具体执行命令如下：

bash generateArtifacts.sh mychannel

这里创建了5台服务器，在任意一台服务器的该目录下执行此项命令即可，将会生成两个目录，它们分别为channel-artifacts和crypto-config，两个目录的结果和含义如下视图：

在上述目录里的文件用于orderer创建channel，它们根据configex.yaml的配置生成。

在上述目录里有orderer和peer的证书、私钥和用于通信加密的tls证书等文件，它通过configex.yaml配置文件生成。

4.3、配置多服务器

根据4.2的方案，以及之前所述的gopath目录等配置方案，我们假定所有的服务器都按照该文档的配置来操作，所有服务器都有Fabric源码且目录为

/opt/gopath/src/github.com/hyperledger/fabric

我们在Server1上执行如下命令生成构建Fabric网络所需的成员证书等必要材料：

bash generateArtifacts.sh mychannel

如4.2中所述，该命令只需在其中某一台服务器上运行一次即可，其它服务器无需再次运行。

在运行该命令的服务器/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli目录下会生成channel-artifacts和crypto-config目录，需要把它们拷贝到其它服务器相同的e2e_cli目录下，如果在其它服务器中已经存在该目录，则先把此目录删除。

当所有服务器都有同一个channel-artifacts和crypto-config目录后，接下来就开始配置compose文件。

4.4、设置peer0.org1.example.com节点的docker-compose文件

e2e_cli中提供了多个yaml文件，我们可以基于docker-compose-cli.yaml文件创建，具体可执行如下命令：

cp docker-compose-cli.yaml docker-compose-peer.yaml

然后修改docker-compose-peer.yaml，去掉orderer的配置，只保留一个peer和cli，因为我们要多级部署，节点与节点之前又是通过主机名通讯，所以需要修改容器中的host文件，也就是extra_hosts设置，修改后的peer配置如下：

 peer0.org1.example.com:
     container_name: peer0.org1.example.com
     extends:
       file:  base/docker-compose-base.yaml
       service: peer0.org1.example.com
     extra_hosts:
      - "orderer.example.com:10.130.116.8"

同样，cli也需要能够和各个节点通讯，所以cli下面也需要添加extra_hosts设置，去掉无效的依赖，并且去掉command这一行，因为我们是每个peer都会有个对应的客户端，也就是cli，所以我只需要去手动执行一次命令，而不是自动运行。修改后的cli配置如下：

 cli:
     container_name: cli
     image: hyperledger/fabric-tools
     tty: true
     environment:
       - GOPATH=/opt/gopath
       - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
       - CORE_LOGGING_LEVEL=DEBUG
       - CORE_PEER_ID=cli
       - CORE_PEER_ADDRESS=peer0.org1.example.com:
       - CORE_PEER_LOCALMSPID=Org1MSP
       - CORE_PEER_TLS_ENABLED=true
       - CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.crt
       - CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.key
       - CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
       - CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
     working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
     volumes:
         - /var/run/:/host/var/run/
         - ../chaincode/go/:/opt/gopath/src/github.com/hyperledger/fabric/examples/chaincode/go
         - ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/
         - ./scripts:/opt/gopath/src/github.com/hyperledger/fabric/peer/scripts/
         - ./channel-artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts
     depends_on:
       - peer0.org1.example.com
     extra_hosts:
      - "orderer.example.com:10.130.116.8"
      - "peer0.org1.example.com:10.130.116.9"
      - "peer1.org1.example.com:10.130.116.10"
      - "peer0.org2.example.com:10.130.116.25"
      - "peer1.org2.example.com:10.130.116.27"

在3.2示例单机模式下，4个peer会映射主机不同的端口，但是我们在多机部署的时候是不需要映射不同端口的，所以需要修改base/docker-compose-base.yaml文件，将所有peer的端口映射都改为相同的：

 ports:
   - :
   - :
   - :

4.5、设置peer1.org1.excmple.com节点的docker-compose文件

与peer0.org1.example.com节点compose文件配置一样，不过需要将启动的容器改为peer1.org1.example.com，并且添加peer0.org1.example.com的IP映射，对应的cli中也改成对peer1.org1.example.com的依赖。这是修改后的peer1.org1.example.com上的配置示例：

 peer1.org1.example.com:
     container_name: peer1.org1.example.com
     extends:
       file:  base/docker-compose-base.yaml
       service: peer1.org1.example.com
     extra_hosts:
      - "orderer.example.com:10.130.116.8"
      - "peer0.org1.example.com:10.130.116.9"

   cli:
     container_name: cli
     image: hyperledger/fabric-tools
     tty: true
     environment:
       - GOPATH=/opt/gopath
       - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
       - CORE_LOGGING_LEVEL=DEBUG
       - CORE_PEER_ID=cli
       - CORE_PEER_ADDRESS=peer1.org1.example.com:
       - CORE_PEER_LOCALMSPID=Org1MSP
       - CORE_PEER_TLS_ENABLED=true
       - CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer1.org1.example.com/tls/server.crt
       - CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer1.org1.example.com/tls/server.key
       - CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer1.org1.example.com/tls/ca.crt
       - CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
     working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
     volumes:
         - /var/run/:/host/var/run/
         - ../chaincode/go/:/opt/gopath/src/github.com/hyperledger/fabric/examples/chaincode/go
         - ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/
         - ./scripts:/opt/gopath/src/github.com/hyperledger/fabric/peer/scripts/
         - ./channel-artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts
     depends_on:
       - peer1.org1.example.com
     extra_hosts:
      - "orderer.example.com:10.130.116.8"
      - "peer0.org1.example.com:10.130.116.9"
      - "peer1.org1.example.com:10.130.116.10"
      - "peer0.org2.example.com:10.130.116.25"
      - "peer1.org2.example.com:10.130.116.27"

与上述类似，可以再次设置peer0.org2.example.com及peer1.org2.example.com节点compose配置文件。

4.6、设置order节点的docker-compose文件

与创建peer的配置文件类似，我们也复制一个yaml文件出来进行修改：

cp docker-compose-cli.yaml docker-compose-orderer.yaml

orderer服务器上我们只需要保留order设置，其他peer和cli设置都可以删除。orderer可以不设置extra_hosts。

以下是order compose的配置示例：

 orderer.example.com:
     extends:
       file:   base/docker-compose-base.yaml
       service: orderer.example.com
     container_name: orderer.example.com

本章节及后面的一章可以直接参阅：Fabric 1.0的多机部署，在这位老师的博客里写的非常清楚，而且我也是参考这篇博客来完成多机多节点自动部署方案的，只是手动调配及后续操作在网上基本上没有可供参考的中文内容，需要查看官网文档来逐步实现。