hyperledger fabric 1.0.5 分布式部署 （五）

梳理fabric e2e_cli 测试程序的具体步骤

作者在 hyperledger fabric 1.0.5 分布式部署 （一）中给读者们介绍了如何从零开始部署一个测试的 demo 环境，如果细心的读者可能会留意到，在启动fabric 的服务时，是直接执行network_setup.sh 脚本命令启动服务的。

如果我们打开 network_setup.sh 脚本查看，会发现启动的关键代码如下

function networkUp () {
    if [ -f "./crypto-config" ]; then
      echo "crypto-config directory already exists."
    else
      #Generate all the artifacts that includes org certs, orderer genesis block,
      # channel configuration transaction
      source generateArtifacts.sh $CH_NAME
    fi

    if [ "${IF_COUCHDB}" == "couchdb" ]; then
      CHANNEL_NAME=$CH_NAME TIMEOUT=$CLI_TIMEOUT docker-compose -f $COMPOSE_FILE -f $COMPOSE_FILE_COUCH up -d 2>&1
    else
      CHANNEL_NAME=$CH_NAME TIMEOUT=$CLI_TIMEOUT docker-compose -f $COMPOSE_FILE up -d 2>&1
    fi
    if [ $? -ne 0 ]; then
        echo "ERROR !!!! Unable to pull the images "
        exit 1
    fi
    docker logs -f cli
}

读者可以看到，实际上 network_setup.sh 脚本就执行了两个命令，分别是

1 source generateArtifacts.sh $CH_NAME
2 CHANNEL_NAME=$CH_NAME TIMEOUT=$CLI_TIMEOUT docker-compose -f $COMPOSE_FILE -f $COMPOSE_FILE_COUCH up -d 2>&1

让我们先来分析 generateArtifacts.sh 脚本

• generateArtifacts.sh 脚本

generateArtifacts.sh 脚本的主要构成部分为三个函数，分别是

1. generateCerts
2. replacePrivateKey
3. generateChannelArtifacts

generateCerts 函数的工作内容主要是根据 e2e_cli/crypto-config.yaml 描述的组织机构形式生成对应的私钥和证书，以供后续节点通讯使用。

fabric 用来生成私钥和证书的程序叫“cryptogen”，生成私钥和证书的命令为

cryptogen generate --config=./crypto-config.yaml

cryptogen 生成的私钥和证书文件存放在 e2e_cli/crypto-config

replacePrivateKey 函数的工作内容则是基于新生成的私钥和证书文件来修改docker-compose-e2e.yaml 配置文件中的相关私钥和证书信息，因为e2e_cli demo 没有用到 ca 服务，所以暂时不讨论这个方法，读者可以理解为该函数对于部署e2e_cli 没有任何帮助。

generateChannelArtifacts 函数的工作内容主要是创建创世块区，创建channel 对应的文件，以及将组织机构信息添加到channel 上。

该函数主要依赖 configtxgen 命令执行，configtxgen 通过读取 configtx.yaml 配置文件配置获取节点的组织关系。另外，configtxgen 依赖之前生成的私钥和证书工作，所以执行有先后顺序。

创建创世块区的命令

configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block

创建 channel 文件

configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME

生成节点集合认证文件

configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP
configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

•  docker-compose 命令

 如果在执行 network_setup.sh 脚本时，指定使用 couchdb 作为存储，则用户在启动e2e_cli 相关docker 镜像时会同时启动常规节点镜像和couchdb 镜像。

常规节点镜像包含，orader、peer、cli 镜像，描述启动常规节点镜像的配置文件为 docker-compose-cli.yaml。

docker-compose 在启动 cli 时，还会执行一个 script.sh 脚本，该脚本描述了如何在fabric 集群中创建channel，以及如何将chaincode 加入到 channel 中。

• script.sh 脚本

用户需要首先需要理解，script.sh 脚本是在 cli 的docker 镜像中执行，并且在宿主机器上执行。

在 script.sh 脚本中，有以下5大函数需要用户注意的

1. setGlobals，设置环境变量，执行peer 命令时，主要依赖这些环境变量来执行对应的命令，例如哪个peer 节点加入到channel 中
2. createChannel，创建channel
3. joinChannel，将对应的peer 节点加入到channel 中
4. updateAnchorPeers，将各个peer 节点和组织机构绑定在一起
5. installChaincode，给channel 安装 chaincode

 script.sh 脚本中，chaincodeQuery 和 chaincodeInvoke 都是e2e_cli demo的测试部分，对于部署fabric 集群没有任何帮助

 

参考博客：

http://www.cnblogs.com/aberic/p/7542835.html