1、git安装

apt-get install git

查看当前安装git的版本:

git version

验证git是否安装好。

2、golang环境搭建

(1)安装

apt-get install golang

(2)查看go的安装路径

go env

(3)配置Go环境变量,对应有{GOROOT,GOPATH,PATH}:

对应修改路径:

mkdir /opt/gopath/src/github.com/hyperledger/ -p
vi /etc/profile
  export GOROOT=/usr/lib/go-1.7
  export GOPATH=/opt/gopath
  export PATH=$GOROOT/bin:$GOPATH/bin:$PATH
source /etc/profile

3、docker安装

apt install docker docker.io 
systemctl start docker  
systemctl enable docker

4、安装docker-compose

首先,安装 python-pip 软件包:

apt install python-pip

安装docker-compose版本不低于1.7.0:

pip install docker-compose

5、安装相关依赖包

apt install libtool libltdl-dev -y

6、获取fabric

cd /opt/gopath/src/github.com/hyperledger/
git clone https://github.com/hyperledger/fabric.git

7、构建configtxgen工具

cd /opt/gopath/src/github.com/hyperledger/fabric/
chmod 755 ./scripts/goListFiles.sh
make configtxgen
结果将输出以下内容
root@ubuntu-virtual-machine:/opt/gopath/src/github.com/hyperledger/fabric# make configtxgen
build/bin/configtxgen
CGO_CFLAGS=" " GOBIN=/opt/gopath/src/github.com/hyperledger/fabric/build/bin go install -tags "nopkcs11" -ldflags "-X github.com/hyperledger/fabric/common/metadata.Version=1.0.0-alpha3-snapshot-010dcf62 -X github.com/hyperledger/fabric/common/metadata.BaseVersion=0.3.1 -X github.com/hyperledger/fabric/common/metadata.BaseDockerLabel=org.hyperledger.fabric -X github.com/hyperledger/fabric/common/metadata.DockerNamespace=hyperledger -X github.com/hyperledger/fabric/common/metadata.BaseDockerNamespace=hyperledger" github.com/hyperledger/fabric/common/configtx/tool/configtxgen
Binary available as build/bin/configtxgen

8、下载fabric镜像

cd /opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli
chmod +x download-dockerp_w_picpaths.sh
./download-dockerp_w_picpaths.sh

确认镜像

docker p_w_picpaths

9、手动执行交易过程

9.1、配置交易生成器

确保你有配置文件制品(orderer.block 和channel.tx,文件位于 /fabric/examples/e2e_cli/crypto/orderer 目录),如果没有,通过以下命令生成:

cd /opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli

generateCfgTrx.sh 脚本接收一个通道ID 参数(channel-ID)。如果没有提供这个参数, 生成的通道会取默认的通道名mychannel。 命令如下:

./generateCfgTrx.sh mychannel

这个脚本执行后,会生成2 个文件orderer.block 和channel.tx。文件位于/fabric/examples/e2e_cli/crypto/orderer 目录。
Orderer.block 文件是排序服务的创世区块,
channel.tx 文件包含了新的通道的配置信息。

正如先前描述的,这两个文件都是根据configtx.yaml 文件的配置内容生成,并且包含像加密证书资料和网络节点信息的数据。

9.2、修改docker-compose 文件

打开docker-compose.yaml 文件,添加注释到script.sh 文件前面,目的是不让它自动执行交易脚本。

working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
# command: /bin/bash -c './scripts/script.sh ${CHANNEL_NAME}'

保存文件。

9.3、启动网络

这里使用前面生成配置文件一样的通道名:

CHANNEL_NAME=mychannel docker-compose up -d

9.4、创建通道

执行下列命令进入cli 容器,

docker exec -it cli bash

成功执行命令后,你会看到如下信息:

root@db1538155f54:/opt/gopath/src/github.com/hyperledger/fabric/peer#

运行如下创建通道命令,通过-c 指定通道名,-f 指定通道配置交易文件,这里的我们是crypto/orderer/channel.tx,你也可以你自己的不同名字的配置交易文件。

因为channel create 命令是针对orderer 容器运行,因此我们需要覆盖先前设置的环境变量,完整的命令如下:

CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig 
CORE_PEER_LOCALMSPID="OrdererMSP" 
peer channel create -o orderer0:7050 -c mychannel -f crypto/orderer/channel.tx --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem

注意:下面的其他命令依然在cli 容器中执行,而且要记住命令里每个peer 对应的环境变量。

9.5、加入通道

通过命令channel join 加入特定的peer 到通道中,命令如下:

CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer0/localMspConfig 
CORE_PEER_ADDRESS=peer0:7051 
CORE_PEER_LOCALMSPID="Org0MSP" 
CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer0/localMspConfig/cacerts/peerOrg0.pem 
peer channel join -b mychannel.block

成功执行命令后,可以通过命令docker exec -it peer0 bash 进入到peer0 容器中去验证是否成功加入了通道。切换到如下目录 /var/hyperledger/production/ledgersData/chains/chains 会发现生成了以通道名命名的目录,目录下生成一个名字为blockfile_000000 的文件。通过更改环境变量,可以根据需要加入其它peer 到通道中。 比如,加入peer2 到通道中的命令如下:

CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig 
CORE_PEER_ADDRESS=peer2:7051 
CORE_PEER_LOCALMSPID="Org1MSP" 
CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig/cacerts/peerOrg1.pem 
peer channel join -b mychannel.block

加入peer3 到通道中的命令如下:

/opt/gopath/src/github.com/hyperledger/fabric/peer# CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer3/localMspConfig 
CORE_PEER_ADDRESS=peer3:7051 
CORE_PEER_LOCALMSPID="Org1MSP" 
CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer3/localMspConfig/cacerts/peerOrg1.pem 
peer channel join -b mychannel.block

9.6、在远程peer 上安装chaincode

安装fabric 提供的例子chaincode 到peer2 上,命令为:

CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig CORE_PEER_ADDRESS=peer2:7051 
CORE_PEER_LOCALMSPID="Org1MSP" 
CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig/cacerts/peerOrg1.pem 
peer chaincode install -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02

在peer2 容器的/var/hyperledger/production/chaincodes 目录下发现生成了一个mycc.1.0 文件,这证明了chaincode mycc 安装成功。而在其它同一通道的peer(如peer0,peer3,注意,我们并没有把peer1 加入mychannel 通道)对应的容器里不会有此文件。

9.7、实例化chaincode 并定义背书策略

在特定peer 上实例化chaincode 会启动一个chaincode 容器,这个chaincode 容器专门为这个特定的peer 工作,然后为chaincode 设置背书策略。此例中定义的背书策略是只要来自Org0 或Org1 的任何一个peer 背书即可。命令如下:

# 执行命令前记得设置环境变量。
# 注意传递正确的-C 参数,也就是通道名,我们例子中使用的是mychannel.
CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig 
CORE_PEER_ADDRESS=peer2:7051 
CORE_PEER_LOCALMSPID="Org1MSP" 
CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig/cacerts/peerOrg1.pem 
peer chaincode instantiate -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02 -c '{"Args":["init","a", "100", "b","200"]}' -P "OR ('Org0MSP.member','Org1MSP.member')"

注意这里的的-P 参数的写法,这里的背书策略是:"OR ('Org0MSP.member','Org1MSP.member')"

9.8、调用chaincode

执行invoke 命令前记住设置全局环境变量

CORE_PEER_MSPCONFIGPATH=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig 
CORE_PEER_ADDRESS=peer2:7051 
CORE_PEER_LOCALMSPID="Org1MSP" CORE_PEER_TLS_ROOTCERT_FILE=$GOPATH/src/github.com/hyperledger/fabric/peer/crypto/peer/peer2/localMspConfig/cacerts/peerOrg1.pem

我们在peer2 上执行命令,所以环境变量设置为peer2,执行invoke 命令前,先执行query 命令: 先执行查询命令:

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

查询结果显示: Query Result: 100 然后执行invoke 命令:

peer chaincode invoke -o orderer0:7050 --tls $CORE_PEER_TLS_ENABLED --cafile $GOPATH/src/github.com/hyperledger/fabric/peer/crypto/orderer/localMspConfig/cacerts/ordererOrg0.pem -C mychannel -n mycc -c '{"Args":["invoke","a","b","10"]}'

注意,通道名不能错,如果这里写成-C mychannel,必须跟实际创建通道的名字一致。 通道名错误,会报如下错误: Error: Error endorsing invoke: rpc error: code = 2 desc = Failed to deserialize creator identity, err MSP Org1MSP is unknown 再次执行查询命令(查询a 的值):

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

查询结果显示: Query Result: 90 再次执行查询命令(查询b 的值):

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

查询结果显示: Query Result: 210 如果你细心,就会发现,我们实例化chaincode 的时候b 的值是200,现在是210,再次验证了我们的交易成功执行了。

10、常见问题:

(1)docker镜像下载慢问题

由于镜像源在国外,导致下载速度慢,源切换为阿里这边

(2)如何保存docker p_w_picpaths,方便下次或者别人搭建环境

docker save命令-打包p_w_picpath
打包:

docker save hyperledger/fabric-peer:latest> fabric-peer_latest.tar

导入:

docker load < fabric-peer_latest.tar

(3)、环境清理

用下列命令删除当前运行的容器

docker rm -f $(docker ps -aq)