[hyperledger fabric教程]ubuntu 安装 fabric并运行

首先这篇文章的目的是教会大家如何在ubuntu系统上安装hyperledger fabric并运行起来，因为目前网络上所有的教程都是之前的fabric版本，然而现在的fabric版本相较于之前版本已经改变了很多，如果使用之前的方法来安装fabric是不能成功运行的。

1.首先得有一台系统为ubuntu的服务器（centos其实操作原理差不多），推荐使用虚拟机安装ubuntu系统。

2.更换apt的下载源，官方下载源很慢，我们需要更换到国内的镜像站

2.1 进入 /etc/apt 目录

cd /etc/apt 

2.2 备份 sources.list 文件

sudo cp /etc/apt/sources.list /etc/apt/sources.list_backup

2.3 打开 sources.list 文件进行修改并添加阿里云镜像

#在文件最前面添加即可
sudo vi /etc/apt/sources.list  

#  阿里源
deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse

2.4 对 apt-get 进行更新

sudo apt-get update
sudo apt-get upgrade

3. 环境安装

我们需要安装的软件有 go docker docker-compose nodejs

3.1 安装 go

#进入根目录
cd ~

#下载压缩包
wget https://studygolang.com/dl/golang/go1.13.4.linux-amd64.tar.gz

#对压缩包解压
tar -xzf go1.13.4.linux-amd64.tar.gz

#删除压缩包
rm -rf go1.13.4.linux-amd64.tar.gz

#把根目录下的 go 文件夹移动到 /usr/local/ 目录下
mv go/ /usr/local/

#修改环境变量
vi ~/.bashrc

#GOROOT 路径是软件安装路径
export GOROOT=/usr/local/go

#GOPATH 路径是平时我们的工作路径，go项目放置在这个目录下
export GOPATH=$HOME/go

#添加到环境变量
export PATH=$PATH:/usr/local/go/bin

#退出 bashrc 文件然后更新环境变量
source ~/.bashrc

#使用 go version 可以查看go是否安装成功
go version

#go env 可以查看 go 的环境变量是否设置成功
go env

3.2 安装 docker

# 更新 apt 包索引
sudo apt-get update

# 下载安装工具
sudo apt-get install apt-transport-https ca-certificates software-properties-common

# 添加官方密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 加入 apt 仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 更新 apt 包索引
sudo apt-get update

# 安装 Docker-CE
sudo apt-get install docker-ce

# 验证版本
docker version

#将非root组加入 docker 组
sudo groupadd docker
sudo usermod -aG docker cigod

# 添加阿里云 Docker 镜像
sudo mkdir -p /etc/docker
sudo vi /etc/docker/daemon.json

#将下面内容添加到该文件中
{
 "registry-mirrors": ["https://obou6wyb.mirror.aliyuncs.com"]
}

# 重启 Docker
sudo systemctl daemon-reload
sudo systemctl restart docker

3.3 安装 docker-compose

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

# 允许其他用户执行compose相关命令
sudo chmod +x /usr/local/bin/docker-compose

# 验证版本
docker-compose -version

3.4 安装 nodejs

#请尽量避免在 Ubuntu 上使用 apt-get 来安装 node.js, 如果你已经这么做了，请手动移除
sudo apt-get purge nodejs && sudo apt-get autoremove && sudo apt-get autoclean

#使用 nvm 来安装
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

#查看 nvm 是否安装成功
nvm --version

#查看 nodejs 可以安装的所有版本
nvm ls-remote     

#目前 nodejs 最新的长期支持版为 12.18.2
nvm install 12.18.2

#查看 nodejs 版本
node -v

4. 获取 bootstrap.sh 文件

首先解决 git clone 速度慢的问题

在网站 https://www.ipaddress.com/ 分别搜索域名，然后得到他们的ip地址

github.global.ssl.fastly.net
github.com

以下截图为目前两个网址的 ip 地址，用户需根据自己查到的 ip 地址进行修改

image

image

#打开 hosts 文件
vi /etc/hosts

#修改 hosts 文件，在文件末尾添加以下内容
199.232.69.194 github.global-ssl.fastly.net
140.82.113.3 github.com

#退出文件，然后更新 DNS             
sudo /etc/init.d/networking restart

#创建目录
mkdir -p /root/go/src/github.com/hyperledger

#进入该目录
cd /root//go/src/github.com/hyperledger

#下载fabric，使用这个地址下载速度要快很多，我在虚拟机上能达到 2M/S，因为这个fabric的包挺大，
所以需要等一段时间
git clone https://github.com.cnpmjs.org/hyperledger/fabric.git

#下载完 fabric 后，bootstrap.sh 就在 fabric 目录下的 scripts 文件夹中

如果使用 git clone https://github.com.cnpmjs.org/hyperledger/fabric.git 这个命令后确实速度非常慢，那么可以使用下面的方法获取 bootstrap.sh 文件，已经下载好 fabric 的则不需要单独下载 bootstrap.sh

打开网站 https://www.ipaddress.com/ 搜索域名 raw.githubusercontent.com 的ip 地址,因为 ip 地址可能改变，所以用户需要将自己查到的 ip 地址放上去

#打开 hosts 文件
vi /etc/hosts

#修改 hosts 文件，在文件末尾添加以下内容，注意其中的 ip 地址应该改成用户所查到的 ip
199.232.68.133 raw.githubusercontent.com

#退出文件，然后更新 DNS             
sudo /etc/init.d/networking restart

#创建目录
mkdir -p /root/go/src/github.com/hyperledger/fabric

#进入该目录
cd /root//go/src/github.com/hyperledger/fabric

#手工下载 bootstrap.sh 
wget https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh

#修改权限
chmod u+x bootstrap.sh

5. 运行 bootstrap.sh 文件

因为这个文件中需要下载一些二进制的文件，但是这些文件又存放在国外的网站上，所以下载速度非常慢，所以不能通过直接运行 bootstrap.sh 文件来安装 fabric 所需的工具和镜像。通过查看该文件发现该文件主要做了三件事，1.下载 fabric-samples 到 fabric 目录下，2.下载相关的二进制文件，3.下载相关的 docker 镜像，所以我们可以手动来完成这三个步骤

5.1 下载 fabric-samples 到 fabric 目录下

#进入该目录
cd /root//go/src/github.com/hyperledger/fabric

#下载 fabric-samples
git clone https://github.com.cnpmjs.org/hyperledger/fabric-samples.git

5.2 下载相关的二进制文件

首先打开 bootstrap.sh 查看两个二进制文件的版本，目前最新的版本是 2.2.0 和 1.4.7.

image

两个二进制文件的下载地址为（注意：根据自己查看bootstrap.sh文件得到相应版本号，从而修改地址其中的版本号）：

https://github.com/hyperledger/fabric/releases/download/v2.2.0/hyperledger-fabric-linux-amd64-2.2.0.tar.gz

https://github.com/hyperledger/fabric-ca/releases/download/v1.4.7/hyperledger-fabric-ca-linux-amd64-1.4.7.tar.gz

我已经把这两个文件放在百度网盘中了，要的可以自取（地址，提取码：zn0v）

如果大家想自己下载最新的版本最好使用 IDM（Internet Download Manager） 下载。

然后大家可以通过 filezilla 软件或者其他软件把这两个文件放到 /root/go/src/github.com/hyperledger/fabric/fabric-samples/ 这个目录下面

#在该目录下面解压这两个压缩包
tar -xzf hyperledger-fabric-linux-amd64-2.2.0.tar.gz
tar -xzf hyperledger-fabric-ca-linux-amd64-1.4.7.tar.gz

解压完成之后会在这个目录下面生成一个 /bin 文件夹，bin目录下面存放的都是一些生成fabric网络所需的工具，到目前为止，bootstrap 文件中的第二个步骤已经弄完了，下面进行第三个步骤

image

5.3.下载docker镜像

回到放置 bootstrap.sh 文件的目录下面，然后执行下面的命令

#该命令会下载所需的 docker 镜像
./bootstrap.sh -s -b

下载完成后，会看到终端输出已安装的 docker 镜像

image

到目前为止，运行 fabric 网络所需的工具都已安装，下面进行第一次网络的运行。

6. 运行 fabric 网络

#进入下面这个目录
cd /root/go/src/github.com/hyperledger/fabric/fabric-samples/test-network

#使用该命令启动网络
./network.sh up

启动成功后，会输出正在运行的三个 docker 容器。

image

到这里，就已经完成了 fabric 的安装和第一次运行，后面还会继续推出关于 fabric 系列的文章，敬请期待！

#网络运行完成后，使用如下命令关闭网络
./network.sh down