HyperLedger Fabric实战（一）：基础环境构建

1. 简介

本文档说明了HyperLedger Fabric 1.4.0版本的区块链网络搭建所需的基本环境组件以及安装流程，最后再记录了安装过程中可能会遇到的一些问题，采用的操作系统为ubuntu 18.04。
具有参考价值的网站：

1. Hyperledger Fabric的官方文档：https://hyperledger-fabric.readthedocs.io/en/latest/；
2. HyperLedger的官网，里面还有其他的配套组件：https://www.hyperledger.org/。

2. 基础环境构建

2.1 组件清单

HyperLedger Fabric的依赖环境较多，且对版本有一定的要求，本次安装使用了如下的组件：

名称	版本	描述
操作系统	Ubuntu 18.04	基础环境
docker	17.06.2-ce或更高	Docker 可以让开发者打包他们的应用以及依赖包到一个轻量级、可移植的容器中，然后发布到任何流行的 Linux 机器上，也可以实现虚拟化。
Docker-compose	1.1.14或更高	Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose，您可以使用 YML 文件来配置应用程序需要的所有服务。然后，使用一个命令，就可以从 YML 文件配置中创建并启动所有服务。
Go	1.13.x	运行的基本SDK
NodeJS	8.9或更高（Version 9全部不支持），Version10从10.15.3后继续支持	运行的基本SDK
npm	5.x	npm 是 JavaScript 世界的包管理工具,并且是 Node.js 平台的默认包管理工具。通过 npm 可以安装、共享、分发代码,管理项目依赖关系。
python	2.7.x	运行的基本SDK
curl	latest	远程获取资源，通常系统自带
ssh	latest	远程控制服务器

2.2 组件安装过程

基于上述的内容，我们开始安装这些组件：

2.2.1 SSH

SSH 为 Secure Shell 的缩写，由 IETF 的网络小组（Network Working Group）所制定；SSH 为建立在应用层基础上的安全协议。SSH 是较可靠，专为远程登录会话和其他网络服务提供安全性的协议。

# 安装SSH服务器
sudo apt install openssh-server

# 安装SSH客户端
sudo apt install openssh-client

# 配置SSH
sudo vim /etc/ssh/ssh_config

# 在配置文件中，把如下的内容的注释删除掉
PasswordAuthentication yes
PermitRootLogin yes

# 重启ssh服务
sudo /etc/init.d/ssh restart

2.2.2 安装docker

docker作为整个超级账本运行的基础环境，其安装是重中之重，也是问题最多的步骤。如果你之前安装了docker且版本不适用，卸载的过程参考如下的教程：https://www.cnblogs.com/shiningrise/p/14775654.html。

# 更新安装包
sudo apt-get update

# 安装apt依赖包
sudo apt-get install \
   apt-transport-https \
   ca-certificates \
   curl \
   gnupg-agent \
   software-properties-common
   
# 添加Docker的官方GPG秘钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 设置稳定版仓库
sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) \
  stable"
  
# 安装docker-ce
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

# 查看docker版本
docker -v

# 设置开机启动docker
sudo systemctl enable docker

#运行docker自带的helloworld程序
sudo docker run hello-world

# 添加当前用户到docker组，这样当前用户就可以直接操作docker命令
# 列出自己的用户组，确认自己在不在 docker 组中
sudo groups
# 没有则新增docker组
sudo groupadd docker
# 把当前用户加入到docker组中
sudo gpasswd -a ${USER} docker
# 重启docker服务
sudo service docker restart

2.2.3 安装docker-compose

docker compose它使用单个YAML文件来编排所有Docker容器和配置，使用docker compose我们可以快速构建多个容器，部署网络等。

# 安装docker-compose到/usr/local/bin/docker-compose，其中-o是指定的输出文件位置
sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

# 为docker-compose启动设置权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证docker-compose版本
sudo docker-compose --version

2.2.4 安装go

Go是Fabric运行的基本环境之一。

# 准备go语言安装位置
cd /opt
sudo mkdir golang
cd golang
# 使用wget下载go语言，不推荐使用高版本的
sudo wget https://dl.google.com/go/go1.10.3.linux-amd64.tar.gz
# 安装gzip
sudo apt-get install gzip

# 解压缩，如果没有安装gzip需要提前安装
sudo tar -zvxf go1.10.3.linux-amd64.tar.gz

# 配置go的环境变量
sudo vim /etc/profile
# 添加如下内容：
export GOPATH=/opt/gopath
export GOROOT=/opt/golang/go
export PATH=$GOROOT/bin:$PATH

# 使配置文件生效
source /etc/profile

# 查看go是否安装成功
go version
# 结果如下
go version go1.10.3 linux/amd64

2.2.5 git安装

git是一个分布式的版本控制工具，我们可以使用git管理一个项目，并在不同的版本之间进行切换，同时，还可以使用git在远程的仓库中拉取需要的文件。

sudo apt-get install git

2.2.6 安装npm与NodeJS

Node.js简单的说 Node.js 就是运行在服务端的 JavaScript，是一个基于Chrome JavaScript 运行时建立的一个平台。Node.js是一个事件驱动I/O服务端JavaScript环境，基于Google的V8引擎，V8引擎执行Javascript的速度非常快，性能非常好。在本项目中，它也是HyperLedger Fabric的基本环境之一。

NPM是随同Node.js一起安装的包管理工具，能解决Node.js代码部署上的很多问题，常见的使用场景有以下几种：

• 允许用户从NPM服务器下载别人编写的第三方包到本地使用。
• 允许用户从NPM服务器下载并安装别人编写的命令行程序到本地使用。
• 允许用户将自己编写的包或命令行程序上传到NPM服务器供别人使用。

# 更新安装包
sudo apt update

# 安装npm
sudo apt-get install npm

此时，安装的Node.js并不是我们指定的版本，可能存在冲突的情况。此时我们可以使用Node.js提供的工具来切换不同版本的Node.js。

# 利用n来管理NodeJS版本
sudo npm install -g n

# n来下载node版本
sudo n lts 长期支持
sudo n stable 稳定版
sudo n latest 最新版
sudo n 8.9.4 直接指定版本下载

# 切换版本
sudo n 8.9.4

# 重新打开一个终端查看版本
node -v
#此时版本为：
v8.9.4

2.2.7 安装Python

Python 是一个高层次的结合了解释性、编译性、互动性和面向对象的脚本语言。 Python 的设计具有很强的可读性，相比其他语言经常使用英文关键字，其他语言的一些标点符号，它具有比其他语言更有特色语法结构。Python也是Fabric的基本支撑环境之一。注意：Fabric支持的Python版本为python2。

# 更新安装包
sudo apt update

#安装python2.7
sudo apt install python2.7

#检查python版本
python
#显示结果：
Python 2.7.17