Centos8部署超级账本(Fabric v2.2)

Hyperledger Fabric 在Centos8部署

--for Java

1. 环境准备

1.1. 虚拟机

下载镜像http://isoredirect.centos.org/centos/8/isos/x86_64/

这里下载的是CentOS-8.2.2004-x86_64-minimal，虚拟机安装过程略。

1) 网络配置

网络适配器采用的是NAT模式（N）：用于共享主机的IP地址。

进入虚拟机以后需要手动启动下网络 命令：vi /etc/sysconfig/network-scripts/ifcfg-ens33

将文件中ONBOOT=no改为ONBOOT=yes，保存并退出.

重启网卡 命令 nmcli c reload

查看虚拟机IP地址：ifconfig

这里IP地址为192.168.162.132

2) 安装wget工具

命令：yum install wget

3) 更改成国内（阿里）yum源（这步不是必须要做的，是为了解决yum安装软件时速度慢的问题）

备份原有yum源文件 命令：mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.back

下载阿里的yum源 命令：wget -O /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-8.repo 替换配置命令：sed -i -e '/mirrors.cloud.aliyuncs.com/d' -e '/mirrors.aliyuncs.com/d' /etc/yum.repos.d/CentOS-Base.repo

生成缓存 命令： yum makecache

1.2. 安装Curl

当前Centos8已经安装Curl。如果 curl 报错命令找不到，那么执行yum install curl安装即可。

1.3. Git

Git用于拉 hyperledger/fabric 代码

安装git命令：yum install git

查看版本命令：git version -> git version 2.18.4

1.4. Go

Frbric使用go语言写的，用go语言开发智能合约也比较方便，这里使用java方式来实现，也不要过度执着于go。

安装go命令:yum install go

查看go版本命令：go version -> go version go1.13.4 linux/amd64

设置代理：

go env -w GO111MODULE=on

go env -w GOPROXY=https://goproxy.cn,direct

1.5. Jdk

安装jdk命令：yum install java-11-openjdk.x86_64

查看版本命令:java -version

openjdk version "11.0.8" 2020-07-14 LTS

OpenJDK Runtime Environment 18.9 (build 11.0.8+10-LTS)

OpenJDK 64-Bit Server VM 18.9 (build 11.0.8+10-LTS, mixed mode, sharing)

1.6. 安装maven

安装maven的原因是，最终使用java与其交互，这里面要安装java程序的依赖包。

命令：yum install maven

系统安装目录在：/usr/share/maven

1.7. 拉取Fabric

这里使用的是 v2.2.0版本 (20200821时是最新的版本)

1) 创建源码存放目录

/root/go/src/github.com/hyperledger 并进入。

命令：mkdir -p /root/go/src/github.com/hyperledger;cd /root/go/src/github.com/hyperledger

2) 下载源码(这个过程会有点慢,可以同步做下面的安装)

手动下载（相对快）

地址https://github.com/hyperledger/fabric/tree/v2.2.0

可以用git下载或者直接下载成zip上传到服务器上，下载完文件fabric-2.2.0.zip

Git拉取（相对慢）

git clone -b v2.2.0 https://github.com/hyperledger/fabric.git

1.8. 安装docker

1) 删除历史版本

命令： sudo yum remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine

2) 采用docker官网推荐的方式安装

执行命令1：sudo yum install -y yum-utils
执行命令2：sudo yum-config-manager \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repo
执行命令3：sudo yum-config-manager --enable docker-ce-nightly
执行命令4：sudo yum-config-manager --enable docker-ce-test
执行命令5：sudo yum install docker-ce docker-ce-cli containerd.io

这时会报错如下图：

解决方法：进入阿里云镜像地址https://mirrors.aliyun.com/docker-ce/linux/centos/7/x86_64/edge/Packages/找到你想要的或者最新的包，。

命令：yum install -y https://mirrors.aliyun.com/docker-ce/linux/centos/7/x86_64/edge/Packages/containerd.io-1.2.13-3.2.el7.x86_64.rpm

重新执行命令5.

查看docker版本：命令docker version

下载完成会在/root/go/src/github.com/hyperledger目录下多一个fabric文件夹，如下图：

3) 配置阿里云镜像加速（这是为了后续安装test-network提速准备的）

针对Docker客户端版本大于 1.10.0 的用户，您可以通过修改daemon配置文件/etc/docker/daemon.json来使用加速器。

sudo mkdir -p /etc/docker

sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://9bhhisho.mirror.aliyuncs.com"]
}
EOF

sudo systemctl daemon-reload

sudo systemctl restart docker

到此docker安装完毕。

1.9. 安装docker-compose

1) 安装

sudo curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

2) 赋权

sudo chmod +x /usr/local/bin/docker-compose

3) 查看版本

命令：docker-compose --version

docker-compose version 1.26.2, build eefe0d31

docker-py version: 4.2.2

CPython version: 3.7.7

OpenSSL version: OpenSSL 1.1.0l 10 Sep 2019

2. Fabric开始搭建

2.1. 下载官方例子及其Docker镜像

进入 /root/go/src/github.com/hyperledger/fabric/scripts目录，执行命令：./bootstrap.sh

这个脚本会花费很长时间，如果中间卡主的话，可以重新执行。

脚本主要做了3件事：

下载官方例子：https://github.com/hyperledger/fabric-samples.git

下载Docker镜像：peer orderer ccenv tools

所以之前必须安装后好git和docker

安装完成后输出如下图：

2.2. 设置环境变量

命令：vi ~/.bash_profile

在最后添加（前提是您按照此目录接口进行安装，否则请修改对应目录结构也就是替换“/root/go”）：

export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_LOCALMSPID="Org1MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/organizations/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
export CORE_PEER_ADDRESS=localhost:7051
export FABRIC_CFG_PATH=/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/../config/
export PATH=/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/../bin:$PATH

保存并退出，执行source ~/.bash_profile 使其生效。

2.3. 启动网络

进入目录：/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network

执行命令：./network.sh up

出现上图代表启动成功。

2.4. 创建通道

执行命令：./network.sh createChannel

这里使用默认管道名称“mychannel”。

管道创建完毕

2.5. 启动链码

启动之前切记关闭系统的防火墙，systemctl stop firewalld.service;systemctl disable firewalld.service, c8默认是开启的，如果不关闭执行该命令会失败，会报一个timeout的错误。

Go 方式：./network.sh deployCC （需要先设置go env -w GO111MODULE=on

go env -w GOPROXY=https://goproxy.cn,direct）否则会因为依赖无法下载而失败。

Java方式：./network.sh deployCC -ccl java //-ccl指定语言 这里采用Java方式。

Javascript方式：./network.sh deployCC -ccl javascript //js方式

最后主线上图时代表启动成功。

2.6. 启动startFabric.sh

这里有个点，该脚本如果默认不加参数的话是执行go程序，如果你要指定用java代码添加智能合约的话，可以执行./startFabric.sh java,这里需要先编译当前java目录下的代码。这里编译很简单就mvn test就可以了，这里有个拉取maven依赖效率的问题，我们可以换成阿里的仓库。在pom.xml文件中添加如下代码红色部分（黑色部分是原有的），然后在java文件夹下执行，mvn test：

<repositories>

<repository>

<id>nexus-aliyun</id>

<name>Nexus aliyun</name>

<url>http://maven.aliyun.com/nexus/content/groups/public</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>false</enabled>

</snapshots>

</repository>

<repository>

<id>oss-sonatype</id>

<name>OSS Sonatype</name>

<url>https://oss.sonatype.org/content/repositories/snapshots</url>

</repository>

</repositories>

<pluginRepositories>

<pluginRepository>

<id>nexus-aliyun</id>

<name>Nexus aliyun</name>

<url>http://maven.aliyun.com/nexus/content/groups/public</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>false</enabled>

</snapshots>

</pluginRepository>

</pluginRepositories>

有些教程在执行完2.5就建议直接测试 执行peer chaincode query -C mychannel -n fabcar -c '{"Args":["queryAllCars"]}'，这是错误的。

需要进入/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/fabcar目录下执行命令：./startFabric.sh

输出上图内容代表启动成功，然后执行测试查询全部命令：

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

输出下图代表成功：

DEMO接口：

1) 查看全部车辆信息“queryAllCars”：

命令：peer chaincode query -C mychannel -n fabcar -c '{"Args":["queryAllCars"]}'

输出：[{"Key":"CAR0","Record":{"make":"Toyota","model":"Prius","colour":"blue","owner":"Tomoko"}},{"Key":"CAR1","Record":{"make":"Ford","model":"Mustang","colour":"red","owner":"Brad"}},{"Key":"CAR2","Record":{"make":"Hyundai","model":"Tucson","colour":"green","owner":"Jin Soo"}},{"Key":"CAR3","Record":{"make":"Volkswagen","model":"Passat","colour":"yellow","owner":"Max"}},{"Key":"CAR4","Record":{"make":"Tesla","model":"S","colour":"black","owner":"Adriana"}},{"Key":"CAR5","Record":{"make":"Peugeot","model":"205","colour":"purple","owner":"Michel"}},{"Key":"CAR6","Record":{"make":"Chery","model":"S22L","colour":"white","owner":"Aarav"}},{"Key":"CAR7","Record":{"make":"Fiat","model":"Punto","colour":"violet","owner":"Pari"}},{"Key":"CAR8","Record":{"make":"Tata","model":"Nano","colour":"indigo","owner":"Valeria"}},{"Key":"CAR9","Record":{"make":"Holden","model":"Barina","colour":"brown","owner":"Shotaro"}}]

{"make":"Ford","model":"Mustang","colour":"red","owner":"Brad"}

2) 查看某一辆车信息“queryCar”：

命令：peer chaincode query -C mychannel -n fabcar -c '{"Args":["queryCar","CAR1"]}'

输出：{"make":"Ford","model":"Mustang","colour":"red","owner":"Brad"}

3) 添加一辆车的信息“CreateCar”：

命令：peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile /root/go/src/github.com/hyperledger//fabric/scripts/fabric-samples/test-network/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n fabcar --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["CreateCar", "CAR11", "VW", "Polo", "Grey", "Mary"]}'

输出：Chaincode invoke successful. result: status:200

4) 修改车辆信息所属“ChangeCarOwner”：

命令：peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile /root/go/src/github.com/hyperledger//fabric/scripts/fabric-samples/test-network/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n fabcar --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles //root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["ChangeCarOwner","CAR11","牡羊座"]}'

输出：Chaincode invoke successful. result: status:200

再次调用“queryCar”接口，所属已经修改。

备注：对于demo中的接口大家想要更多了解的话，可以到服务器上下载直接拉取/root/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/fabcar/java 代码（如果你对go和javascript比较了解，那么在java同级目录下也可以找到对应的代码），其中ClientApp就是相应的接口。

3. 学习资料

3.1. https://hyperledger-fabric.readthedocs.io/en/release-2.2/test_network.html

3.2. https://github.com/hyperledger/fabric/blob/release-2.2/docs

3.3. https://github.com/chaozh/awesome-blockchain-cn 综合

3.4. http://ifeve.com/hyperledger-fabric-model/