Hyperledger Fabric 1.0快速搭建 ---运行e2e_cli项目实践

青旅半醒 2022-05-14 03:24 207阅读 0赞

## **一、准备工作** ##

**我所用的liunx系统是centos7**

在开始之前我们要做相应的准备，golang docker  docker-compose git 的安装

golang安装参考：[https://blog.csdn.net/qq\_36956154/article/details/82225429][https_blog.csdn.net_qq_36956154_article_details_82225429]

docker安装参考：[https://blog.csdn.net/qq\_36956154/article/details/81095465][https_blog.csdn.net_qq_36956154_article_details_81095465]

docker-compost参考：[https://blog.csdn.net/qq\_36956154/article/details/82223950][https_blog.csdn.net_qq_36956154_article_details_82223950]

git安装可直接安装使用命令：yum install -y git即可

在这些都安装完以后进行下一步

[下一篇：运行frist\_network项目实践][frist_network]

## **二、下载Fabric源码** ##

在go的工作路径下创建src/github.com/hyperledger文件夹

mkdir -p src/github.com/hyperledger
    cd /opt/golang/src/github.com/hyperledger
    git clone https://github.com/hyperledger/fabric.git
    //在这里下载的是最新版本的，网上大多数资料是fabric-1.0.0版本的资料
    //网上的做法是下载最新的版本以后运行 git checkout -b v1.0.0 命令切换到1.0.0分支下
    //但是我这么做以后在后面运行e2e_cli项目的时候出现错误，应该是版本不兼容的错误
    //fabric 和 镜像的版本 和 cryptogen的版本要一致才能运行起来
    //所以我的解决办法是直接下载1.0.0版本的fabric项目
    git clone https://gerrit.hyperledger.org/r/fabric -b v1.0.0
    //这样可以确保项目的版本是1.0.0版本的

下载完以后在hyperledger下会有一个fabric文件夹（这个fabric已经是1.0.0版本的了）

[root@localhost hyperledger]# ll
    total 4
    drwxr-xr-x. 27 root root 4096 Sep  1 07:46 fabric

2.1下载fabric镜像

在fabric中的e2e\_cli项目有一个download-dockerimages.sh，运行以后会帮我把所需要的镜像都下载好

[root@localhost hyperledger]# cd fabric/examples/e2e_cli/
    [root@localhost e2e_cli]# ll
    total 84
    drwxr-xr-x. 2 root root    60 Sep  1 08:04 base
    drwxr-xr-x. 2 root root   111 Sep  1 08:05 channel-artifacts
    -rw-r--r--. 1 root root  5013 Sep  1 07:46 configtx.yaml
    drwxr-xr-x. 4 root root    59 Sep  1 08:05 crypto-config
    -rw-r--r--. 1 root root  3858 Sep  1 07:46 crypto-config.yaml
    -rw-r--r--. 1 root root  2677 Sep  1 07:46 docker-compose-cli.yaml
    -rw-r--r--. 1 root root  2005 Sep  1 07:46 docker-compose-couch.yaml
    -rw-r--r--. 1 root root  2517 Sep  1 07:46 docker-compose-e2e-template.yaml
    -rw-r--r--. 1 root root  2725 Sep  1 08:05 docker-compose-e2e.yaml
    -rw-r--r--. 1 root root  2119 Sep  1 07:46 download-dockerimages.sh
    -rw-r--r--. 1 root root 41711 Sep  1 07:46 end-to-end.rst
    drwxr-xr-x. 3 root root    23 Sep  1 07:46 examples
    -rwxr-xr-x. 1 root root  3588 Sep  1 07:46 generateArtifacts.sh
    -rwxr-xr-x. 1 root root  2617 Sep  1 07:46 network_setup.sh
    drwxr-xr-x. 2 root root    23 Sep  1 07:46 scripts
    [root@localhost e2e_cli]# bash download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0
    //运行此命令以后会下载所需镜像，在设置阿里云国内镜像加速以后下载会很快，但也会根据网络情况而定

下载以后运行docker images,会看到以下镜像

[root@localhost e2e_cli]# docker images
    REPOSITORY                     TAG                 IMAGE ID            CREATED             SIZE
    hyperledger/fabric-tools       latest              0403fd1c72c7        13 months ago       1.32GB
    hyperledger/fabric-tools       x86_64-1.0.0        0403fd1c72c7        13 months ago       1.32GB
    hyperledger/fabric-couchdb     latest              2fbdbf3ab945        13 months ago       1.48GB
    hyperledger/fabric-couchdb     x86_64-1.0.0        2fbdbf3ab945        13 months ago       1.48GB
    hyperledger/fabric-kafka       latest              dbd3f94de4b5        13 months ago       1.3GB
    hyperledger/fabric-kafka       x86_64-1.0.0        dbd3f94de4b5        13 months ago       1.3GB
    hyperledger/fabric-zookeeper   latest              e545dbf1c6af        13 months ago       1.31GB
    hyperledger/fabric-zookeeper   x86_64-1.0.0        e545dbf1c6af        13 months ago       1.31GB
    hyperledger/fabric-orderer     latest              e317ca5638ba        13 months ago       179MB
    hyperledger/fabric-orderer     x86_64-1.0.0        e317ca5638ba        13 months ago       179MB
    hyperledger/fabric-peer        latest              6830dcd7b9b5        13 months ago       182MB
    hyperledger/fabric-peer        x86_64-1.0.0        6830dcd7b9b5        13 months ago       182MB
    hyperledger/fabric-javaenv     latest              8948126f0935        13 months ago       1.42GB
    hyperledger/fabric-javaenv     x86_64-1.0.0        8948126f0935        13 months ago       1.42GB
    hyperledger/fabric-ccenv       latest              7182c260a5ca        13 months ago       1.29GB
    hyperledger/fabric-ccenv       x86_64-1.0.0        7182c260a5ca        13 months ago       1.29GB
    hyperledger/fabric-ca          latest              a15c59ecda5b        13 months ago       238MB
    hyperledger/fabric-ca          x86_64-1.0.0        a15c59ecda5b        13 months ago       238MB

## **三、遇到的错误：** ##

1.这个时候运行 bash network\_setup.sh up命令

![outside_default.png][]

如果红箭头所指的不是1.0.0那你就有可能版本不对，可以先查看以下项目的版本是不是1.0.0的版本

2.运行到一半的时候还会遇到以下错误

Error: Error endorsing chaincode: rpc error: code = Unknown desc = Error starting container: API error (404): {"message":"network e2ecli_default not found"}

解决办法：

[root@localhost e2e_cli]# cd base/
    [root@localhost base]# ll
    total 12
    -rw-r--r--. 1 root root 4566 Sep  1 07:46 docker-compose-base.yaml
    -rw-r--r--. 1 root root  991 Sep  1 08:04 peer-base.yaml
    [root@localhost base]# vi peer-base.yaml
    
    //e2e_cli目录是固定的，启动后会创建一个docker network以此为名字，这里是e2e_cli。如果修改该目录，要修改/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/base目录下的peer-base.yaml
    将网络名改成如下名称即可
    - CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=e2e_cli_default

![outside_default.png][]

3.还有一种错误就是会报没有这个文件的错误No such file 这个是你没有生成密钥文件

解决办法：cryptogen这个工具跟你项目版本有可能不对所以还是去保证你 frbric项目和 镜像  和  cryptogen这三个版本一致才能生成正确的密钥文件。

## 四、编译 ##

把这些修改以后再运行bash network\_setup.sh up   会自动进行以下操作：

编译生成Fabric公私钥、证书的程序，程序在目录：fabric/release/linux-amd64/bin

基于configtx.yaml生成创世区块和通道相关信息，并保存在channel-artifacts文件夹。

基于crypto-config.yaml生成公私钥和证书信息，并保存在crypto-config文件夹中。

基于docker-compose-cli.yaml启动1Orderer+4Peer+1CLI的Fabric容器。

在CLI启动的时候，会运行scripts/script.sh文件，这个脚本文件包含了创建Channel，加入Channel，安装Example02，运行Example02等功能。

当出现以下界面时代表你运行成功，构建的fabric网络正常，可以继续学习了

2018-09-01 12:06:22.810 UTC [msp] GetLocalMSP -> DEBU 001 Returning existing local MSP
    2018-09-01 12:06:22.810 UTC [msp] GetDefaultSigningIdentity -> DEBU 002 Obtaining default signing identity
    2018-09-01 12:06:22.810 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
    2018-09-01 12:06:22.810 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
    2018-09-01 12:06:22.811 UTC [msp/identity] Sign -> DEBU 005 Sign: plaintext: 0A95070A6708031A0C08BE81AADC0510...6D7963631A0A0A0571756572790A0161 
    2018-09-01 12:06:22.811 UTC [msp/identity] Sign -> DEBU 006 Sign: digest: C3FE35C92F1F40D85B35A3165A3ED9D6485EA439D888A257D4ED7125942B936C 
    Query Result: 90
    2018-09-01 12:06:30.439 UTC [main] main -> INFO 007 Exiting.....
    ===================== Query on PEER3 on channel 'mychannel' is successful ===================== 
    
    ===================== All GOOD, End-2-End execution completed ===================== 
    
    
     _____   _   _   ____            _____   ____    _____ 
    | ____| | \ | | |  _ \          | ____| |___ \  | ____|
    |  _|   |  \| | | | | |  _____  |  _|     __) | |  _|  
    | |___  | |\  | | |_| | |_____| | |___   / __/  | |___ 
    |_____| |_| \_| |____/          |_____| |_____| |_____|

## 五、**手动测试e2e\_cli项目** ##

我们可以直接在上面fabric网络启动起来，并跑完测试例子的基础上进行手动测试：

我实在虚拟机中把e2e\_cli项目跑起来以后用xshell连接虚拟机（相当于再开一个命令行界面）

运行docker ps 查看启动的容器

[root@localhost e2e_cli]# docker ps
    CONTAINER ID        IMAGE                                 COMMAND                  CREATED             STATUS              PORTS                                                                       NAMES
    2b36d108e91f        dev-peer1.org2.example.com-mycc-1.0   "chaincode -peer.add…"   13 minutes ago      Up 13 minutes                                                                                   dev-peer1.org2.example.com-mycc-1.0
    d06f9004a5a5        dev-peer0.org1.example.com-mycc-1.0   "chaincode -peer.add…"   13 minutes ago      Up 13 minutes                                                                                   dev-peer0.org1.example.com-mycc-1.0
    1670d2a72e19        dev-peer0.org2.example.com-mycc-1.0   "chaincode -peer.add…"   13 minutes ago      Up 13 minutes                                                                                   dev-peer0.org2.example.com-mycc-1.0
    4506e3c2130d        hyperledger/fabric-tools              "/bin/bash -c './scr…"   14 minutes ago      Up 14 minutes                                                                                   cli
    a5bd5036153a        hyperledger/fabric-peer               "peer node start"        14 minutes ago      Up 14 minutes       0.0.0.0:8051->7051/tcp, 0.0.0.0:8052->7052/tcp, 0.0.0.0:8053->7053/tcp      peer1.org1.example.com
    8380e3c27dd6        hyperledger/fabric-peer               "peer node start"        14 minutes ago      Up 14 minutes       0.0.0.0:9051->7051/tcp, 0.0.0.0:9052->7052/tcp, 0.0.0.0:9053->7053/tcp      peer0.org2.example.com
    6fb04bac1569        hyperledger/fabric-peer               "peer node start"        14 minutes ago      Up 14 minutes       0.0.0.0:7051-7053->7051-7053/tcp                                            peer0.org1.example.com
    746e275a1e6f        hyperledger/fabric-peer               "peer node start"        14 minutes ago      Up 14 minutes       0.0.0.0:10051->7051/tcp, 0.0.0.0:10052->7052/tcp, 0.0.0.0:10053->7053/tcp   peer1.org2.example.com
    5c271be54a47        hyperledger/fabric-orderer            "orderer"                14 minutes ago      Up 14 minutes       0.0.0.0:7050->7050/tcp                                                      orderer.example.com

上面三个dev开头的容器是三个链码容器，一个fabric-tools充当客户端cli, 4个fabric-peer， 一个fabric-order提供节点共识服务。

接下里我们执行：docker exec -it cli bash  进入cli容器，进行操作测试：

在example02上面已经对a进行了初始化，所以我们不用再初始化了，直接进行查询：

peer chaincode query -C mychannel -n mycc -c '\{"Args":\["query","a"\]\}'

root@4506e3c2130d:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
    2018-09-01 12:59:58.605 UTC [msp] GetLocalMSP -> DEBU 001 Returning existing local MSP
    2018-09-01 12:59:58.605 UTC [msp] GetDefaultSigningIdentity -> DEBU 002 Obtaining default signing identity
    2018-09-01 12:59:58.605 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
    2018-09-01 12:59:58.605 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
    2018-09-01 12:59:58.605 UTC [msp/identity] Sign -> DEBU 005 Sign: plaintext: 0A95070A6708031A0C08CE9AAADC0510...6D7963631A0A0A0571756572790A0161 
    2018-09-01 12:59:58.605 UTC [msp/identity] Sign -> DEBU 006 Sign: digest: 0E152D959839872E72E69C36F0EDD7C821874F7540A6770D78468EC01B4E6B28 
    Query Result: 90
    2018-09-01 12:59:58.614 UTC [main] main -> INFO 007 Exiting.....

查询的结果是：Query Result: 90 说明a现在有90元

下面我们做一个交易，a向b转账20元。

root@4506e3c2130d:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode invoke -o orderer.example.com:7050  --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem  -C mychannel -n mycc -c '{"Args":["invoke","a","b","20"]}'
    2018-09-01 13:02:04.777 UTC [msp] GetLocalMSP -> DEBU 001 Returning existing local MSP
    2018-09-01 13:02:04.778 UTC [msp] GetDefaultSigningIdentity -> DEBU 002 Obtaining default signing identity
    2018-09-01 13:02:04.783 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
    2018-09-01 13:02:04.783 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
    2018-09-01 13:02:04.784 UTC [msp/identity] Sign -> DEBU 005 Sign: plaintext: 0A95070A6708031A0C08CC9BAADC0510...696E766F6B650A01610A01620A023230 
    2018-09-01 13:02:04.784 UTC [msp/identity] Sign -> DEBU 006 Sign: digest: 220E8B34AD256599F6FEE61F6CF12062116EB72F08565D0F024F94FAD36E4BAF 
    2018-09-01 13:02:04.799 UTC [msp/identity] Sign -> DEBU 007 Sign: plaintext: 0A95070A6708031A0C08CC9BAADC0510...EBC518E367DA8D647824B03CCC78737C 
    2018-09-01 13:02:04.799 UTC [msp/identity] Sign -> DEBU 008 Sign: digest: D822109D40C483201696DD75B38638B9E48B0D412EAB76CC43FAF0DD7CCE72FD 
    2018-09-01 13:02:04.802 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> DEBU 009 ESCC invoke result: version:1 response:<status:200 message:"OK" > payload:"\n \016Yg?/\374\326\342{'\300\274\023\252\326\302d\212\013\231\355A\033\240\376\276\2470K\277\204\327\022Y\nE\022\024\n\004lscc\022\014\n\n\n\004mycc\022\002\010\003\022-\n\004mycc\022%\n\007\n\001a\022\002\010\004\n\007\n\001b\022\002\010\004\032\007\n\001a\032\00270\032\010\n\001b\032\003230\032\003\010\310\001\"\013\022\004mycc\032\0031.0" endorsement:<endorser:"\n\007Org1MSP\022\200\006-----BEGIN -----\nMIICGTCCAb+gAwIBAgIQXY5Nh/+T/6zngZ3L+vJCmDAKBggqhkjOPQQDAjBzMQsw\nCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZy\nYW5jaXNjbzEZMBcGA1UEChMQb3JnMS5leGFtcGxlLmNvbTEcMBoGA1UEAxMTY2Eu\nb3JnMS5leGFtcGxlLmNvbTAeFw0xODA5MDExMjQyNDdaFw0yODA4MjkxMjQyNDda\nMFsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1T\nYW4gRnJhbmNpc2NvMR8wHQYDVQQDExZwZWVyMC5vcmcxLmV4YW1wbGUuY29tMFkw\nEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE/wxgP8uPz1M2GL+MOtRjj5guGVZfKx8w\ntkJIG4syQ5cwGITf/9QuKm3NCtcPOHhKPdZPUDgrNbqk4P7QEzwY/KNNMEswDgYD\nVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwKwYDVR0jBCQwIoAg973lj17wp0Qz\nOi2uCQqSkvQj7WNPM5cqPDcJ3ADnhfUwCgYIKoZIzj0EAwIDSAAwRQIhAPpn54dr\nDwQxW6O06ko4VVQzAYnRFt9oMluKpU9cAZ8LAiBqZDh6Qm0GMXITfS5IDUAOmDgp\neUfJ8cLbJvFwyCmveg==\n-----END -----\n" signature:"0E\002!\000\346\3746\272\262\345l\0054\3212`\336\212\002\271[(Ns\035\353\315\025\031\270\235!\246\273\024}\002 >\371\351\262\\\266\352Yjy\223\022\247\251(\341\353\305\030\343g\332\215dx$\260<\314xs|" > 
    2018-09-01 13:02:04.802 UTC [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 00a Chaincode invoke successful. result: status:200 
    2018-09-01 13:02:04.803 UTC [main] main -> INFO 00b Exiting.....

然后再查询a账户的余额

peer chaincode query -C mychannel -n mycc -c '\{"Args":\["query","a"\]\}'

root@4506e3c2130d:/opt/gopath/src/github.com/hyperledger/fabric/peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
    2018-09-01 13:03:29.804 UTC [msp] GetLocalMSP -> DEBU 001 Returning existing local MSP
    2018-09-01 13:03:29.804 UTC [msp] GetDefaultSigningIdentity -> DEBU 002 Obtaining default signing identity
    2018-09-01 13:03:29.804 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 003 Using default escc
    2018-09-01 13:03:29.804 UTC [chaincodeCmd] checkChaincodeCmdParams -> INFO 004 Using default vscc
    2018-09-01 13:03:29.805 UTC [msp/identity] Sign -> DEBU 005 Sign: plaintext: 0A95070A6708031A0C08A19CAADC0510...6D7963631A0A0A0571756572790A0161 
    2018-09-01 13:03:29.805 UTC [msp/identity] Sign -> DEBU 006 Sign: digest: AB2C610D2D0D2525E24FCBEAE91ECEC317AA4B6A226D9C56F370705FC1F89BB4 
    Query Result: 70
    2018-09-01 13:03:29.814 UTC [main] main -> INFO 007 Exiting.....

可以看到a的余额现在是70 a已经像b账户转了20元，通过exit来退出该容器。

至此，例子和环境都成功了。最后执行bash network\_setup.sh down， 进行网络的关闭和清理。

我写这个的时候刚刚学习fabric，写的也许很乱，等我再深入的了解以后也许会再梳理一遍，感谢网上大神的资料。

[https_blog.csdn.net_qq_36956154_article_details_82225429]: https://blog.csdn.net/qq_36956154/article/details/82225429
[https_blog.csdn.net_qq_36956154_article_details_81095465]: https://blog.csdn.net/qq_36956154/article/details/81095465
[https_blog.csdn.net_qq_36956154_article_details_82223950]: https://blog.csdn.net/qq_36956154/article/details/82223950
[frist_network]: https://blog.csdn.net/qq_36956154/article/details/82317514
[outside_default.png]: /images/20220514/ebcd5f69b93448c89894b57b427a5908.png