Ubuntu 部署 Hyperledger Fabric 1.4.2
1 前言
Hyperledger fabric的fabric-sample运行需要三样东西：
1 fabric-sample工程
2 fabric网络的docker images
主要有八个：hyperledger/fabric-javaenv、hyperledger/fabric-ca、hyperledger/fabric-tools、hyperledger/fabric-ccenv、hyperledger/fabric-orderer、hyperledger/fabric-peer、hyperledger/fabric-zookeeper、hyperledger/fabric-kafka
3 可执行二进制文件
主要是两个：hyperledger-fabric-ca-linux-amd64-1.4.2.tar.gz、
hyperledger-fabric-linux-amd64-1.4.2.tar.gz
从fabric1.4.1版本开始，fabric支持raft共识，1.4.0版本以前是kafka共识，其实在0.6版本以前fabric是支持BFT共识的。
从kafka共识向raft共识演进主要原因有两点：
1 kafka运维不方便
0.6版本fabric是基于BFT的共识，但是遇到了一些性能问题，后面采用了kafka共识。fabric前期基于kafka，是一种简单粗暴实现方法，主要考虑的是快速实现，没有考虑运维部署、易用的成本
[if !supportLists]l [endif]需要同时维护zk集群和kafka集群，其中zk集群需要至少需要3个节点，kafka至少需要4个节点
[if !supportLists]l [endif]zk集群和kafka集群，会保存日志几个小时(可配置)，集群异常重启，每个节点的日志有所不同，有时会造成 排序节点异常
[if !supportLists]l [endif]排序节点同时需要一批组织维护，需要构建一个 order集群网络，并持久化账本
[if !supportLists]l [endif]整个排序集群，部署起来参数非常多，不易维护
[if !supportLists]l [endif]kafka和zookeeper的设计不适用于大型网络
[if !supportLists]l [endif]在kafka共识模式中，orderer与orderer之间不会互相直接建立连接，而是与kafka连接
2 raft为未来平滑演进fabric
BFT共识做准备
raft 和 bft是未来的趋势，raft和bft都会部署在orderer节点上，两者网络架构一样，可以支持未来平滑演进
[if !supportLists]l [endif]在可信的环境下，基于性能的考虑，大家乐于考虑使用raft
[if !supportLists]l [endif]kafka缺乏信任的基础，选择使用bft，联盟链的节点有限，性能也不会是大的问题
2 前期准备
系统软件源改为 aliyun
方法：进入system setting 然后点击software and update，修改download from
[if !vml]
[endif]
安装vim sudo apt-get install vim
安装git sudo apt-get install git
安装curl sudo apt-get install curl
安装wget sudo apt-get install wget
安装 ssh
sudo apt-get
update
sudo apt-get
install ssh
3 环境准备
[if !supportLists]· [endif]安装go1.11 以及以上版本
[if !supportLists]· [endif]安装docker
17.06.2-ce 以及以上版本
[if !supportLists]· [endif]安装docker-compose 1.14.0以及以上版本
[if !supportLists]· [endif]git 拉下fabric-sample 项目
[if !supportLists]· [endif]下载docker
image镜像
3.1 GO安装
3.1.1下载压缩包
无法翻墙 可以去这个网站,
https://studygolang.com/dl
cd ~
wget https://studygolang.com/dl/golang/go1.12.1.linux-amd64.tar.gz //下载安装go 1.12.1
tar -zxvf go1.12.1.linux-amd64.tar.gz -C/usr/local //解压
3.1.2 配置环境变量
sudo gedit /etc/profile, 追加以下配置到环境变量
export GOROOT=/usr/local/go
export PATH=$PATH:/usr/local/go/bin
export GOPATH=/opt/go
export PATH=$PATH:/opt/go/bin
source /etc/profile //立即适应新环境
测试
输入 go version，成功查看版本信息杂表示配置成功。
3.2 安装Docker-CE
1 如果已经安装docker，但是没有docker 17.06.2-ce 以及以上版本
sudo apt-getremove docker docker-engine docker.io //先卸载
2 前置工作
sudo apt-get
updatesudo apt-get
install apt-transport-https ca-certificates curl software-properties-commoncurl -fsSL
https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –
3 加入apt仓库中
sudo
add-apt-repository \
"deb [arch=amd64]https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"sudo apt-get
update
4 安装 Docker-ce
sudo apt-get
install docker-ce
5 添加阿里云的docker hub镜像
sudo mkdir
-p /etc/docker
sudo gedit /etc/docker/daemon.json
6 将下列内容写入deamon.json文件中，并保存退出
{
"registry-mirrors":["https://obou6wyb.mirror.aliyuncs.com"]
}
7 接下来执行
sudo
systemctl daemon-reload
sudo
systemctl restart docker
8 将当前用户添加到 Docker
Group（支持不使用 sudo 执行 docker 命令）
sudo usermod-aG docker xxx (xxx为当前用户名)
sudo chmod
-R 777 /var/run/docker.sock
9 测试
docker version
3.3 安装Docker-Compose
1 安装
sudo apt-get
install python-pip
sudo pip
install docker-compose
2 测试
docker-compose
version
4下载 fabric 及其镜像
4.1 创建并进入工作目录
mkdir -p
$GOPATH/src/github.com/hyperledger/
cd
$GOPATH/src/github.com/hyperledger/
4.2 克隆源码
git clone
https://github.com/hyperledger/fabric.git
cd fabric
git checkout
v1.4.2
4.3 下载镜像和fabric-samples和二进制文件
cd $GOPATH/src/github.com/hyperledger/fabric/scripts/
执行scripts目录中的bootstrap.sh脚本会自动下载fabric-samples和fabric镜像
./bootstrap.sh1.4.2 1.4.2 0.4.15 //脚本的使用方法：bootstrap.sh [Fabric版本 [CA版本 [第三方版本]]] [选项]
由于镜像较大，此过程需要较长时间完成。脚本完成后会发现当前目录有了fabric-samples目录，之后执行：
docker
images
当出现下列内容时说明镜像部署成功：
hyperledger/fabric-javaenv 1.4.2 1cd707531ce7 4 weeks ago 1.76GB
hyperledger/fabric-javaenv latest 1cd707531ce7 4 weeks ago 1.76GB
hyperledger/fabric-ca 1.4.2 f289675c9874 4 weeks ago 253MB
hyperledger/fabric-ca latest f289675c9874 4 weeks ago 253MB
hyperledger/fabric-tools 1.4.2 0abc124a9400 4 weeks ago 1.55GB
hyperledger/fabric-tools latest 0abc124a9400 4 weeks ago 1.55GB
hyperledger/fabric-ccenv 1.4.2 fc0f502399a6 4 weeks ago 1.43GB
hyperledger/fabric-ccenv latest fc0f502399a6 4 weeks ago 1.43GB
hyperledger/fabric-orderer 1.4.2 362021998003 4 weeks ago 173MB
hyperledger/fabric-orderer latest 362021998003 4 weeks ago 173MB
hyperledger/fabric-peer 1.4.2 d79f2f4f3257 4 weeks ago 178MB
hyperledger/fabric-peer latest d79f2f4f3257 4 weeks ago 178MB
hyperledger/fabric-zookeeper 0.4.15 20c6045930c8 5 months ago 1.43GB
hyperledger/fabric-zookeeper latest 20c6045930c8 5 months ago 1.43GB
hyperledger/fabric-kafka 0.4.15 b4ab82bbaf2f 5 months ago 1.44GB
hyperledger/fabric-kafka latest b4ab82bbaf2f 5 months ago 1.44GB
5 快速部署网络
5.1 复制二进制文件
将二进制文件复制到 usr/local/bin 目录
cd $GOPATH/src/github.com/hyperledger/fabric/scripts/fabric-samples/bin
sudo cp -r .
/usr/local/bin
这样就可以到处使用这些可执行二进制文件了。可以看到8个二进制文件
configtxgen cryptogen fabric-ca-client orderer
configtxlator discover idemixgen peer
[if !vml]
[endif]
这几个二进制文件主要是从hyperledger-fabric-ca-linux-amd64-1.4.2.tar.gz和hyperledger-fabric-linux-amd64-1.4.2.tar.gz解压后得到的
如果下载缓慢，可以在百度云盘下载
https://pan.baidu.com/s/1YfSwjrEybfozhqFYw7yCPA
5.2 启动和测试网络
cd $GOPATH/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network
./byfn.sh -mgenerate -o etcdraft //使用raft共识
./byfn.sh up-o etcdraft //使用raft共识
启动和测试日志：
[if !vml]
[endif]
5.3 关闭网络
./byfn.sh down
6 解释bootstrap.sh
6.1 脚本的使用方法
bootstrap.sh [Fabric版本 [CA版本 [第三方版本]]] [选项]
6.2 bootstrap.sh做了什么
bootstrap主要是安装sample ，fabric 网络的二进制文件，以及 docker 镜像（Install Samples, Binaries and Docker Images）
打开 bootstrap.sh 文件 大致查看以下内容
[if !supportLists]· [endif]dockerFabricPull: 下载 fabric-peer fabric-orderer
fabric-ccenv fabric-javaenv fabric-tools 镜像
[if !supportLists]· [endif]dockerThirdPartyImagesPull: 下载 couchdb kafka zookeeper 镜像
[if !supportLists]· [endif]dockerCaPull: 下载 fabric-ca 镜像
[if !supportLists]· [endif]samplesInstall: git clone -b master https://github.com/hyperledger/fabric-samples.git
[if !supportLists]· [endif]binariesInstall: 安装 hyperledger-fabric
hyperledger-fabric-ca 二进制
总结：
if [ "$SAMPLES" == "true" ]; then
echo
echo "Installing hyperledger/fabric-samples
repo"
echo
samplesInstall
fi
if [ "$BINARIES" == "true" ]; then
echo
echo "Installing Hyperledger Fabric
binaries"
echo
binariesInstall
fi
if [ "$DOCKER" == "true" ]; then
echo
echo "Installing Hyperledger Fabric docker
images"
echo
dockerInstall
fi
1. 安装hyplerledger fabric-sample
2. 安装hyplerledger fabric binaries
文件介绍类型依赖
peer账本（对等）节点程序，负责维护账本数据，执行链码服务core.yaml
orderer共识服务程序，负责打包交易，使用通道订阅给其他账本节点服务orderer.yaml
cryptogen生成 x509标准的证书以及密钥工具crypto-config.yaml
configtxgen生成共识服务启动以及通道创建所需配置数据工具configtx.yaml
configtxlator用来将通道配置信息转换为可读形式工具
discoverfabric discovery 服务的命令行客户端服务
fabric-ca-clienthyperledger fabric 证书认证客户端工具
idemixgenHyperledger Fabric 生成关键材料时被用于身份混淆MSP的工具工具
3. 安装hyplerledger fabric dockerimages
打开 fabric-samples/bin/get-docker-images.sh 可以发现，总共下载的镜像包括如下：
镜像介绍
fabric-peer账本（对等）节点的镜像
fabric-orderer共识服务节点的镜像
fabric-ccenv链码环境镜像
fabric-tools工具库镜像
fabric-kafka分布式消息队列镜像
fabric-zookeeper分布式协调服务镜像
fabric-couchdb状态存储库镜像
fabric-javaenv
6.3 有多种方法可以运行bootstrap.sh脚本
1 在hyperledger/fabric/scripts下可以找到
$GOPATH/src/github.com/hyperledger/fabric/scripts
2 通过https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh
自动安装脚本的url为https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh，缩略后的url为http://bit.ly/2ysbOFE，如果后面缩略的网址打不开，请使用前者代替。
curl -sSL
https://bit.ly/2ysbOFE | bash -s -- 1.4.2 1.4.2 0.4.15
3 将https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh复制到本地使用
curl -sS
https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh
-o ./scripts/bootstrap.sh
# Change file mode to executable
chmod +x ./scripts/bootstrap.sh
# Download binaries and docker images
./scripts/bootstrap.sh
1.4.2 1.4.2 0.4.15
7 二进制可执行文件
7.1 通过bootstrap.sh安装
Bootstrap.sh首先会从github上将fabric-samples下载下来，然后会从https://nexus.hyperledger.org下载可执行二进制文件。如下图，并解压到fabric-samples/bin目录下
[if !vml]
[endif]
https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/linux-amd64-1.4.2/hyperledger-fabric-linux-amd64-1.4.2.tar.gz
这两个文件不是很好下载，可以通过windows代理下载，下载后手动放入$GOPATH/src/hyperledger/fabric/scripts/fabric-samples目录下，然后回到scripts目录下继续执行bootstrap.sh脚本
7.2 编译安装
进入hyperledger/fabric目录，自行编译这些工具：make cryptogen configtxgen configtxlator peer orderer peer-docker
orderer-docker tools-docker，在.build/bin/目录下就是我们需要的工具，编译也会生成docker images
参考：
1https://hyperledgercn.github.io/hyperledgerDocs/build_network_zh/
2https://hyperledger-fabric.readthedocs.io/en/latest/prereqs.html
3 https://hyperledger-fabric.readthedocs.io/en/release-1.4/prereqs.html
4 https://blog.csdn.net/smallone233/article/details/86569536
5 https://www.cnblogs.com/llongst/p/9482038.html
6 一个动画演示raft算法
http://thesecretlivesofdata.com/raft/
7 https://blog.csdn.net/sinat_36742186/article/details/88390019
8 https://blog.csdn.net/sinat_36742186/article/details/80809954
9 https://blog.csdn.net/diligent_lee/article/details/79098302
10 https://blog.csdn.net/so5418418/article/details/78355868
11https://www.cnblogs.com/informatics/p/8276172.html
12 https://www.jianshu.com/p/e5ec0b4e8075
