在现有Fabric网络上设置和运行Caliper性能测试 官方操作文档中文版

此文档是官方的操作文档， 实战请参考 这篇博客。

1.概述

本教程将带您完成在预先存在的Fabric网络上使用Caliper对智能合约进行性能测试。

要完成本教程，您需要安装NodeJS。为此，我们建议使用nvm。

本教程基于官方Hyperledger Fabric文档中提供的资源。假设一个由两个组织和一个单独排序者组成的网络，具有asset-transfer-basic的javascript智能合约，假定已经建立并准备好进行性能测试。

下面的命令列表是一个最简单的快速步骤指南，用于启动和运行所需的Fabric网络。我们在显式级别使用可用的Hyperledger Fabric资源。要了解并排除创建测试网络期间发生的情况，请参阅上面链接的Fabric文档！

# 克隆Hyperledger Fabric samples repo的固定版本
git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples
git checkout 22393b629bcac7f7807cc6998aa44e06ecc77426

# 安装Fabric工具并将其添加到PATH
curl -sSL https://bit.ly/2ysbOFE | bash -s -- 2.2.0 1.4.8 -s
export PATH=$PATH:$(pwd)/bin

# 创建并初始化网络
cd test-network
./network.sh up createChannel
./network.sh deployCC -ccn basic -ccl javascript

2.步骤1-创建Caliper工作区

在fabric-samples目录的同一级别创建一个名为caliper-workspace的文件夹，然后在caliper-workspace文件夹中，分别创建三个名为networks、benchmarks和workload的文件夹

Caliper的安装和使用将基于当地的npm安装。在caliper-workspace目录中，使用以下终端命令安装caliper CLI：

npm install --only=prod @hyperledger/caliper-cli@0.4.0

使用以下终端命令绑定SDK：

npx caliper bind --caliper-bind-sut fabric:2.1

有关Caliper安装和捆绑的更多信息，请参见相关文件页。
Caliper需要两个配置文件：

• 网络配置文件，它描述被测网络并提供要使用的测试标识。
• 基准文件，它定义了要通过一组有序的测试循环来完成的性能测试，每个测试轮都指定了一个工作负载模块和一系列选项，以在一个时间间隔内驱动工作负载。

现在我们将用Caliper所需的资源填充这些文件夹。

3.步骤2-构建网络配置文件

网络配置文件是Caliper工作人员创建到现有Fabric网络的连接所需的文件，以便他们可以提交交易。它类似于Fabric公共连接配置文件，并添加了其他必需字段。文件可以是YAML或JSON格式，本教程显示JSON格式。

创建模板网络配置文件

在“networks”文件夹下创建一个名为networkConfig.json包括以下内容：

{
   
    "version" : "1.0",
    "name": "Caliper test",
    "caliper" : {
   
        "blockchain": "fabric"
    },
    "clients" : {
   
    },
    "channels" : {
   
    },
    "organizations" : {
   
    },
    "peers" : {
   
    }
}

版本：正在使用的配置文件的版本。只接受“1.0”。
名称：配置的名称，在本例中为“Caliper测试”。
Caliper：指示对目标的SUT进行Caliper，可能包含本教程中不需要的其他开始/结束命令。在本教程中，我们以Fabric网络为目标。
客户端：列出要在性能测试中使用的标识
通道：描述可用的Hyperledger Fabric通道、它们的状态以及在这些通道上部署的智能合约
组织：要在基准测试中使用的超级账本Fabric组织
节点：要在基准测试中使用的Hyperledger Fabric节点

填充模板文件

在测试网络教程之后，将生成一个公共连接配置文件（CCP）；我们将使用此文件帮助填充Caliper网络配置文件的特定于Hyperledger Fabric的元素。模板将为所创建的Hyperledger Fabric网络提供一些唯一的证书，因此您将注意到后续阶段中显示的内容的差异；您必须使用为与您希望目标的测试网络进行交互而创建的证书。

在本例中，我们将使用Org1进行连接。要查找生成的JSON或yamlccp文件，请查看fabric-samples -> test-network -> organizations -> peerOrganizations -> org1.example.com。 我们假设使用json CCP connection-org1.json。

组织和同行

使用CCP的内容进行填充：

将CCP的organizations和peers元素复制到Caliper网络配置文件中。

在organizations.Org1对象，删除certificateAuthorities列表。这样做有两个原因：

i） 我们不会使用证书颁发机构注册或注册
ii）向CCP提交的变更与配置文件中的验证Caliper不兼容。

Caliper网络配置文件现在应该类似于：

{
   
    "version" : "1.0",
    "name": "Caliper test",
    "caliper" : {
   
        "blockchain": "fabric"
    },
    "clients" : {
   
    },
    "channels" : {
   
    },
    "organizations": {
   
        "Org1": {
   
            "mspid": "Org1MSP",
            "peers": [
                "peer0.org1.example.com"
            ]
        }
    },
    "peers": {
   
        "peer0.org1.example.com": {
   
            "url": "grpcs://localhost:7051",
            "tlsCACerts": {
   
                "pem": "-----BEGIN CERTIFICATE-----<UNIQUE CONTENT>-----END CERTIFICATE-----\n"
            },
            "grpcOptions": {
   
                "ssl-target-name-override": "peer0.org1.example.com",
                "hostnameOverride": "peer0.org1.example.com"
            }
        }
    }
}

客户端

指定执行基准测试时Caliper要使用的标识。身份必须有效，这意味着它们必须为Fabric网络所知，并且具有相应的加密材料以供使用。标识在clients节中列出。这里我们使用单一身份Admin@org1.example.com，我们在其中嵌套来自CCP的client对象，以指示标识所属的组织，并提供基本的连接超时信息。

"clients": {
   
    "Admin@org1.example.com": {
   
        "client": {
   
            "organization": "Org1",
            "connection": {
   
                "timeout": {
   
                    "peer": {
   
                        "endorser": "300"
                    }
                }
            }
        }
    }
}

在client对象下，添加一个名为credentialStore的属性，在该属性下添加一个名为path的属性，该属性具有一个字符串变量，该变量指向工作区中名为/tmp/org1的临时文件。另外，在credentialStore属性下添加一个名为cryptoStore的属性，并在该属性下添加另一个指向上面相同临时文件/tmp/org1的路径属性。

以下是应该添加到client的内容：

"credentialStore": {
   
    "path": "/tmp/org1",
    "cryptoStore": {
   
        "path": "/tmp/org1"
    }
}

在client对象下添加一个名为clientPrivateKey的属性，在此属性下添加一个名为path</