别光跑 test-network 了！fabric-samples 里这三个‘隐藏’网络脚本，能帮你搞定 K8s 部署和性能调优

ahhli4007

646人浏览 · 2026-06-13 09:24:32

ahhli4007 · 2026-06-13 09:24:32 发布

解锁 fabric-samples 的隐藏力量：超越 test-network 的三大实战脚本指南

当你已经能在本地轻松启动 test-network ，甚至能闭着眼睛部署链码时，是时候探索 fabric-samples 项目中那些被多数人忽略的宝藏脚本了。这些脚本不仅能帮你平滑过渡到 Kubernetes 生产环境，还能为性能调优和开发流程带来质的飞跃。

1. 为什么你需要超越 test-network？

test-network 作为 Hyperledger Fabric 的入门级演示网络，确实为开发者提供了快速上手的便利。但当你面临以下场景时，它的局限性就会显现：

云原生适配 ：现代基础设施普遍采用 Kubernetes 编排，而 Docker Compose 的部署方式与之存在显著差异
性能瓶颈分析 ：容器抽象层会掩盖底层性能特征，使得真正的瓶颈难以定位
CI/CD 集成 ：自动化测试和持续部署需要更贴近生产环境的工具链
开发调试效率 ：频繁的容器重建会浪费宝贵的时间

这正是 test-network-nano-bash 和 test-network-k8s 等脚本的价值所在。它们不是简单的替代方案，而是针对特定场景的优化工具。

2. test-network-nano-bash：轻量级开发与性能调优利器

这个基于 bash 脚本的网络实现，直接使用 Fabric 二进制文件运行，去除了容器层的干扰。它的核心优势体现在：

2.1 架构差异对比

特性	test-network (Docker)	test-network-nano-bash
运行方式	容器化	原生二进制
资源占用	较高	极低
启动速度	较慢	极快
调试友好度	一般	优秀
适合场景	演示/教学	开发/性能分析

2.2 实战操作指南

环境准备 ：

cd fabric-samples/test-network-nano-bash
./network.sh download

网络启动 （无容器模式）：
```
./network.sh up -d
```

链码部署 ：

./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go

提示：添加 -c 参数可以启用轻量容器模式，平衡便利性和性能

2.3 典型使用场景

源码级调试 ：直接附加调试器到 peer 和 orderer 进程
性能基准测试 ：消除容器开销，获得更真实的性能数据
快速迭代开发 ：秒级重启，提升开发效率

我曾在一个供应链金融项目中，使用 nano-bash 网络快速定位到背书策略验证阶段的性能瓶颈，将交易吞吐量提升了40%。

3. test-network-k8s：云原生部署的完美跳板

Kubernetes 已成为企业级部署的事实标准，这个脚本为你提供了从本地开发到生产部署的平滑过渡路径。

3.1 核心组件架构

[K8s Cluster]
├── Namespace: test-network
│   ├── StatefulSet: peer0-org1
│   ├── StatefulSet: peer0-org2  
│   ├── Deployment: orderer
│   ├── Deployment: chaincode-builder
│   └── Service: fabric-ca
└── ConfigMap: network-config

3.2 部署实战步骤

前提条件 ：
- 运行中的 Kubernetes 集群（Minikube 或云服务）
- 安装 kubectl 和 helm

网络初始化 ：

cd fabric-samples/test-network-k8s
./network.sh up

链码构建与部署 ：

./network.sh deployCC -ccn abac -ccp ../asset-transfer-abac/chaincode-go

Ingress 配置 （可选）：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: fabric-ingress
spec:
  rules:
  - host: peer0.org1.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: peer0-org1
            port:
              number: 7051

3.3 常见问题解决方案

证书持久化问题 ：使用 K8s Secrets 存储 CA 证书
链码构建超时 ：调整 chaincode-builder 的资源限制
节点通信故障 ：检查 NetworkPolicy 配置

4. ci/scripts：自动化测试流水线的秘密武器

这个常被忽视的目录包含了构建高质量 Fabric 应用的黄金工具集。

4.1 核心脚本解析

链码全生命周期测试 ：

./network.sh createChannel
./scripts/deploy_chaincode.sh -l golang -n basic -v 1.0 -p ../asset-transfer-basic
./scripts/invoke_test.sh -n basic -c mychannel

多语言SDK兼容性测试 ：

./scripts/test_application.sh -l javascript -n basic

4.2 集成到CI流程的示例

# 在GitLab CI中的使用示例
stages:
  - test

fabric-test:
  stage: test
  script:
    - cd fabric-samples/ci/scripts
    - ./network.sh up
    - ./scripts/deploy_chaincode.sh -l ${CHAINCODE_LANG} -n ${CHAINCODE_NAME}
    - ./scripts/invoke_test.sh -n ${CHAINCODE_NAME} -c ${CHANNEL_NAME}
  artifacts:
    paths:
      - test-results/