Fabric官方文档:https://hyperledger-fabric.readthedocs.io/en/release-2.2/

1.Fabric简介

Fabric 作为当下联盟链最为火热的框架之一,是区块链技术学习人员必须掌握的技术。Fabric不同于比特币、以太坊等无许可的公链,它是一个有许可的联盟链。接下来我会在此系列中依次介绍fabric的安装、运行流程、底层架构等。

hyperledger的生态圈:

在较高级别上,Fabric 由以下模块化组件组成:

  • 一个可插拔的排序服务就交易的顺序建立共识,然后将区块广播给对等方。
  • 可插拔成员资格服务提供商负责将网络中的实体与加密身份相关联。
  • 可选的点对点八卦服务通过向其他对等点订购服务来传播块输出。
  • 智能合约(“链码”)在容器环境(例如 Docker)中运行以进行隔离。它们可以用标准编程语言编写,但不能直接访问分类帐状态。
  • 分类帐可以配置为支持各种 DBMS。
  • 可插入的背书和验证策略实施,可以为每个应用程序独立配置。

2.Fabirc安装(坑很多)

2.1先决软件安装

为了正确的安装fabric,需要安装以下的一些组件,这些模块的安装在网上都有教程,这里就不贴出来啦:

  • git
  • docker和docker-compose
  • nodejs
  • go语言

2.2fabric官方安装方式(下载极慢,容易被墙)

2.2.1创建一个存放fabric-sample的目录

//创建文件夹mkdir fabric//进入文件夹cd fabric

2.2.2 运行官方安装脚本

//此命令默认下载最新版的Fabriccurl -sSL https://bit.ly/2ysbOFE | bash -s//可以在后面加上版本号,来下载指定版本,格式如下curl -sSL https://bit.ly/2ysbOFE | bash -s -- 2.2.4 1.5.2//以上的链接非常容易被墙,可以尝试以下链接:curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/release-2.2/scripts/bootstrap.sh | bash -s//整个过程十分的漫长。。。。漫长。。。漫长。。。。笔者不得不去研究新的安装方式。。

2.3 笔者的安装方式

对官网安装脚本进行分析后,发现其实就做了四件事。

  • 使用git克隆fabric-samples项目
  • 下载fabric压缩包安装二进制文件
  • 下载fabric-ca压缩包安装二进制文件
  • 使用docker安装一些必须一些镜像

其中导致安装慢的主要原因就是压缩包的下载,找出问题了我们就自己动手呗!

2.3.1 git克隆fabric-samples项目

//创建存放项目的目录mkdir fabric//进入目录cd fabric//下载项目git clone https://github.com/hyperledger/fabric-samples//git clone很慢解决:git clone git://github.com/hyperledger/fabric-samples//进入指定版本git checkout v2.2.0

2.3.2 下载fabric压缩包和fabric-ca压缩包并解压

在网速快的地方下载如下两个文件

https://github.com/hyperledger/fabric/releases/download/v2.2.0/hyperledger-fabric-linux-amd64-2.2.0.tar.gzhttps://github.com/hyperledger/fabric-ca/releases/download/v1.4.0/hyperledger-fabric-ca-linux-amd64-1.4.0.tar.gz

将文件放入上一步下载的fabric-sample文件夹中,然后解压

tar zxvf hyperledger-fabric-linux-amd64-2.2.0.tar.gztar zxvf hyperledger-fabric-ca-linux-amd64-1.4.0.tar.gz

成功后会看到fabric-samples目录下多出了bin目录和config目录,里面的内容如下:

2.3.3 使用docker安装一些必须镜像

在安装前确保docker已经开启了

//开启docker服务systemctl start docker//重启服务systemctl restartdocker

写了个shell脚本,直接安装吧

#!/bin/bash# 安装镜像docker pull hyperledger/fabric-peer:2.2.0docker pull hyperledger/fabric-ccenv:2.2.0docker pull hyperledger/fabric-tools:2.2.0docker pull hyperledger/fabric-orderer:2.2.0docker pull hyperledger/fabric-ca:1.4.0# 给镜像打上标签docker tag hyperledger/fabric-peer:2.2.0 hyperledger/fabric-peer:latestdocker tag hyperledger/fabric-tools:2.2.0 hyperledger/fabric-tools:latestdocker tag hyperledger/fabric-orderer:2.2.0 hyperledger/fabric-orderer:latestdocker tag hyperledger/fabric-ccenv:2.2.0 hyperledger/fabric-ccenv:latestdocker tag hyperledger/fabric-ca:1.4.0 hyperledger/fabric-ca:latest

使用如下命令测试镜像是否安装完毕:

docker images

应该有这些包:

3.开启测试网络

在完成上面的安装后,就可以进行开启fabric的测试网络了。使用以下命令导航到测试网络目录:

使用以下命令导航到测试网络目录:

cd fabric-samples/test-network

运行如下命令,以从任何先前运行中删除任何容器或工件:

./network.sh down

或者通过通过docker删除所有容器,-v会一起删除数据卷

dockerrm -v $(docker ps -aq)

然后,您可以通过发出以下命令来启动网络。

./network.sh up

启动后,可以使用如下命令进行查看组成部分:

docker ps -a

如果正确运行,应该有如下的几个节点正在运行

测试创建通道命令

./network.sh createChannel

在通道上安装链码

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

与网络进行交互,先配置环境变量,注意,此命令要在test-network目录下使用

export PATH=${PWD}/../bin:$PATHexport FABRIC_CFG_PATH=$PWD/../config///配置ORG1的相关设置export CORE_PEER_TLS_ENABLED=trueexport CORE_PEER_LOCALMSPID="Org1MSP"export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crtexport CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org1.example.com/users/Admin@org1.example.com/mspexport CORE_PEER_ADDRESS=localhost:7051

接下来就可以调用链码了,初始化账本。

peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile ${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles ${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses localhost:9051 --tlsRootCertFiles ${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"function":"InitLedger","Args":[]}'

查询账本

peer chaincode query -C mychannel -n basic -c '{"Args":["GetAllAssets"]}'

使用完网络后,可以使用如下命令关闭测试网络。

./network.sh down

4.总结

在本文中,着重介绍了fabric的安装。只有还有fabric的交易模式、网络架构、基础概念等待介绍。

5.可能的出错

Error starting container: API error (404): {“message“:“network _test not found“}

解决参考:https://blog.csdn.net/m0_57128752/article/details/120287922

补充:还需要修改down里面的两处 不然使用测试环境的network down会报错: