前言
本人参考连接搭建Fabric网络，遇到了一些坑，故此有了本篇文章。
准备好机器环境
我的系统版本：Ubuntu 18.04.1 LTS
安装GO语言环境
$ cd ~
$ mkdir go
对于新手来说，不推荐使用apt的方式安装GO。
$ wget https://dl.google.com/go/go1.10.2.linux-amd64.tar.gz
$ sudo tar -C usr/local -xzf go1.10.2.linux-amd64.tar.gz
$ vim ~/.profile
添加如下内容：
export PATH=$PATH:/usr/local/go/bin
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$HOME/go/bin
用:wq保存后使用如下命令将立即刷新
$ source ~/.profile
$ go version
go version go1.10 linux/amd64
安装Docker
这里使用的Docker的官方文档来安装docker
- 如果系统中有旧版本的
Docker,需要先使用如下命令卸载 - 更新
apt包索引 - 安装软件包以允许
apt通过HTTPS使用远程库 - 添加
Docker的官方GPG密钥 - 通过搜索指纹的最后8个字符，确认您现在拥有指纹识别码
9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 - 置稳定版本的远程库
- 再次更新
apt包索引 - 使用
apt安装docker-ce
$ sudo apt-get remove docker docker-engine docker.io
$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
$ curl -fsSL [https://download.docker.com/linux/ubuntu/gpg](https://download.docker.com/linux/ubuntu/gpg) | sudo apt-key add -
$ sudo apt-key fingerprint 0EBFCD88
pub rsa4096 2017-02-22 [SCEA]
9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid [ unknown] Docker Release (CE deb) <docker@docker.com>
sub rsa4096 2017-02-22 [S]
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
$ sudo apt-get update
$ sudo apt-get install docker-ce
- 查看docker版本，测试环境配置是否成功
$ docker version
Client:
Version: 18.06.1-ce
API version: 1.38
Go version: go1.10.3
Git commit: e68fc7a
Built: Tue Aug 21 17:24:56 2018
OS/Arch: linux/amd64
Experimental: false
Server:
Engine:
Version: 18.06.1-ce
API version: 1.38 (minimum version 1.12)
Go version: go1.10.3
Git commit: e68fc7a
Built: Tue Aug 21 17:23:21 2018
OS/Arch: linux/amd64
Experimental: false
- 安装完成之后，需要将当前用户添加到
docker用户组，然后为该用户添加sudo权限， - 若没有创建
docker用户组，可以使用如下命令创建一个GID为999，组名为docker的用户组 - 将当前用户(ubuntu)添加到
docker用户组并分配sudo权限
$ sudo groupadd –g 999 docker
$ sudo usermod -aG docker ubuntu
安装Docker-Compose
-
Docker-Compose是支持通过模板脚本批量创建的一个组件 - 在安装
Docker-Compose之前，需要安装python-pip - 下载
Docker-Compose，这里使用的是国内的DaoClound加速器进行下载 - 将
Docker-Compose文件夹移动到/usr/local/bin目录下 - 为
Docker-Compose附上可执行权限
$ sudo apt-get python-pip
$ curl -L https://get.daocloud.io/docker/compose/releases/download/1.12.0/docker-compose-`uname -s`-`uname -m` > ~/docker-compose
$ sudo mv ~/docker-compose /usr/local/bin/docker-compose
$ chmod +x /usr/local/bin/docker-compose
下载Fabric源码
- 先在
GOPATH下创建对应的目录 - 切换到对应目录
- 使用
Git命令将fabric的源码从github上克隆下来 - 由于Fabric一直在更新，而我们并不需要使用最新的源码，所有将版本切换到
v1.0.0
$ mkdir -p ~/go/src/github.com/hyperledger
$ cd ~/go/src/github.com/hyperledger
$ git clone [https://github.com/hyperledger/fabric.git](https://github.com/hyperledger/fabric.git)
$ cd ~/go/src/github.com/hyperledger/fabric
$ git checkout -b v1.0.0
下载Fabric Docker镜像
由于刚才设置了Docker Hub镜像的地址，并且官方文件中也提供了批量下载的脚本，所有我们只需运行下面命令即可
$ cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
$ source download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0
由于刚才设置的是国内的镜像站，在本地网速还不错的情况下下载数度还是很快的。当下载完成后，使用如下命令检查镜像列表
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
dev-peer0.org1.example.com-marbles-v4 latest 089d43e100c9 5 hours ago 173MB
dev-peer0.org1.example.com-fabcar-1.0 latest 6047921ee993 7 hours ago 173MB
hyperledger/fabric-tools latest 0403fd1c72c7 10 months ago 1.32GB
hyperledger/fabric-tools x86_64-1.0.0 0403fd1c72c7 10 months ago 1.32GB
hyperledger/fabric-couchdb latest 2fbdbf3ab945 10 months ago 1.48GB
hyperledger/fabric-couchdb x86_64-1.0.0 2fbdbf3ab945 10 months ago 1.48GB
hyperledger/fabric-kafka latest dbd3f94de4b5 10 months ago 1.3GB
hyperledger/fabric-kafka x86_64-1.0.0 dbd3f94de4b5 10 months ago 1.3GB
hyperledger/fabric-zookeeper latest e545dbf1c6af 10 months ago 1.31GB
hyperledger/fabric-zookeeper x86_64-1.0.0 e545dbf1c6af 10 months ago 1.31GB
hyperledger/fabric-orderer latest e317ca5638ba 10 months ago 179MB
hyperledger/fabric-orderer x86_64-1.0.0 e317ca5638ba 10 months ago 179MB
hyperledger/fabric-peer latest 6830dcd7b9b5 10 months ago 182MB
hyperledger/fabric-peer x86_64-1.0.0 6830dcd7b9b5 10 months ago 182MB
hyperledger/fabric-javaenv latest 8948126f0935 10 months ago 1.42GB
hyperledger/fabric-javaenv x86_64-1.0.0 8948126f0935 10 months ago 1.42GB
hyperledger/fabric-ccenv latest 7182c260a5ca 10 months ago 1.29GB
hyperledger/fabric-ccenv x86_64-1.0.0 7182c260a5ca 10 months ago 1.29GB
hyperledger/fabric-ca latest a15c59ecda5b 10 months ago 238MB
hyperledger/fabric-ca x86_64-1.0.0 a15c59ecda5b 10 months ago 238MB
hyperledger/fabric-baseos x86_64-0.3.1 4b0cab202084 12 months ago 157MB
出现以上结果说明镜像已经下载成功
启动Fabric网络并运行e2e_cli项目
- 进入
e2e_cli目录，并执行启动命令
$ cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
$ ./network_setup.sh up
这个过程做了如下操作：
- 编译生成Fabric公私钥，证书的程序，程序在目录：fabric/release/linux-amd64/bin下
- 基于configtx.yaml生成创世区块和通道相关信息，并保存到channel-artifacts文件夹中
- 基于crypto-config.yaml生成公私钥和证书信息，并保存在crypto-config文件夹中
- 基于docker-compose-cli.yaml启动1 Orderer + 4 Peer + 1 CLI的Fabric容器
- 在CLI启动的时候，会运行srcipt/script.sh文件，这个脚本文件包含了创建Channel,加入Channel，安装Example02,运行Example02等功能
mark
HYPERLEDGER FABRIC网络搭建之network e2ecli_default not found
原因是：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
手动测试一下Fabric网络
我们以安装好的Example02进行测试,在官方例子中，channel的名字是mychannel,链码的名字是mycc,我们首先重新打开一个命令行，然后进入CLI，
- 输入以下命令即可
- 运行命令查询
a账户的余额，可以看到a账户的余额现在是90 - 运行命令查询
b账户的余额，可以看到b账户的余额现在是210 - 现在将
b账户的余额转100给a账户 - 再次查询
a账户的余额，可以看到a账户的余额现在是190,比之前多了100 - 再次查询
b账户的余额，可以看到b账户的余额现在是110,比之前少了100
root@60dc5766fa4d:/opt/gopath/src/github.com/hyperledger/fabric/peer# 简写为 root***peer#
$ docker exec -it cli bash
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","b"]}'
root***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","b","a","100"]}'
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'
root***peer# peer chaincode query -C mychannel -n mycc -c '{"Args":["query","b"]}'
mark
mark
mark
mark
mark
关闭区块链网络
- 退出
CLI容器 - 关闭Fabric网络
root@60dc5766fa4d:/opt/gopath/src/github.com/hyperledger/fabric/peer# exit
$ cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli
$ ./network_setup.sh down
mark
