Hyperledger Caliper 镜像文档

镜像概述

Hyperledger Caliper是一个区块链性能基准测试框架，旨在对各种区块链平台进行客观、标准的性能评估。本镜像封装了Caliper框架，提供了便捷的容器化部署方式，帮助用户快速开展区块链性能测试工作，无需手动配置复杂的依赖环境。

核心功能和特性

• 多平台支持：兼容主流区块链平台，包括Hyperledger Fabric、***、Corda、FISCO BCOS等
• 全面测试指标：支持测量吞吐量（TPS）、延迟（端到端/确认延迟）、资源利用率（CPU、内存、网络IO）等关键性能指标
• 灵活配置：支持自定义测试工作负载、网络拓扑、部署配置，满足多样化测试需求
• 自动化测试流程：提供从测试执行到结果收集的全流程自动化支持
• 丰富报告生成：可生成详细的测试报告（支持JSON、HTML等格式），包含数据可视化图表
• 开源可扩展：基于Hyperledger开源项目，支持通过插件扩展新的区块链平台或测试指标

使用场景和适用范围

典型使用场景

• 区块链平台性能基线评估与验证
• 不同区块链配置（如共识算法、区块大小、并发数）下的性能对比分析
• 区块链系统升级或优化后的性能回归测试
• 区块链应用在不同负载条件下的稳定性测试
• 学术研究中的区块链性能对比实验

适用对象

• 区块链平台开发者（评估平台性能）
• 区块链应用开发者（测试应用性能瓶颈）
• 系统测试工程师（执行标准化性能测试）
• 区块链研究人员（开展性能相关研究）
• 区块链运维人员（验证部署环境性能）

使用方法和配置说明

镜像获取

docker pull hyperledger/caliper:latest

基本使用示例

简单测试执行

docker run -it --rm \
  -v $(pwd)/benchmarks:/hyperledger/caliper/benchmarks \
  -v $(pwd)/networks:/hyperledger/caliper/networks \
  -v $(pwd)/reports:/hyperledger/caliper/reports \
  hyperledger/caliper:latest \
  launch master \
  --caliper-workspace /hyperledger/caliper \
  --caliper-benchconfig benchmarks/my-benchmark.yaml \
  --caliper-networkconfig networks/my-network.yaml

参数说明

• -v $(pwd)/benchmarks:/hyperledger/caliper/benchmarks: 挂载本地测试工作负载配置目录
• -v $(pwd)/networks:/hyperledger/caliper/networks: 挂载本地区块链网络配置目录
• -v $(pwd)/reports:/hyperledger/caliper/reports: 挂载目录用于存储测试报告
• launch master: 启动Caliper主进程
• --caliper-benchconfig: 指定测试工作负载配置文件路径
• --caliper-networkconfig: 指定区块链网络配置文件路径

环境变量配置

高级配置示例（docker-compose）

version: '3'
services:
  caliper:
    image: hyperledger/caliper:latest
    volumes:
      - ./benchmarks:/hyperledger/caliper/benchmarks
      - ./networks:/hyperledger/caliper/networks
      - ./reports:/hyperledger/caliper/reports
      - ./***-config:/hyperledger/caliper/***-config  # 挂载区块链网络证书（如Fabric）
    environment:
      - CALIPER_LOGGING_LEVEL=debug
      - CALIPER_REPORT_FORMAT=json
      - CALIPER_REPORT_NAME=performance-test-result
    command: >
      launch master
      --caliper-workspace /hyperledger/caliper
      --caliper-benchconfig benchmarks/sample.yaml
      --caliper-networkconfig networks/fabric-network.yaml

更多资源

• 官方文档：[***]
• GitHub仓库：[***]
• 测试配置示例：可参考GitHub仓库中的samples目录
• 支持矩阵：查看官方文档了解支持的区块链平台及版本