Hyperledger 学习（一）：基础环境安装以及一键部署脚本

环境清单

• 操作系统 : Ubuntu 21.04 amd64
• Golang : Version 1.16.5
• Docker : Version 20.10.7
• Docker Compose : Version 1.29.2
• Hyperledger Fabric : Github - hyperledger/fabric

基础工具安装

Ubuntu 操作系统默认不带git、curl等常用工具，需要自己安装，可使用apt-get install直接安装，执行下面两条指令分别安装

sudo apt-get install git
sudo apt-get install curl

环境部署

1、安装Golang环境

1.1 安装

方法一：使用apt-get install直接安装

sudo apt-get install golang-1.16

方法二：下载安装步骤

• 1、下载安装包骤

  mkdir -p ~/tools/golang/
  wget https://studygolang.com/dl/golang/go1.16.5.linux-amd64.tar.gz -O ~/tools/golang/go1.16.5.linux-amd64.tar.gz
  

• 2、删除旧版并安装骤

  sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf /home/fabric/tools/golang/go1.16.5.linux-amd64.tar.gz
  

• 3、添加go到系统环境变量
  在/etc/profile文件最末尾新增一行，添加下面内容

  export PATH=$PATH:/usr/local/go/bin
  

• 4、刷新环境变量

  source
  

• 5、使用查看版本命令测试安装是否完成

  go version
  

1.2 配置参数

Golang 需要配置默认的开发环境文件夹，此处可以一次性配置，后续无需再进行配置，在/etc/profile添加下面3行内容

export GOPATH=/home/fabric/code/go
export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin
export GO111MODULE=auto

其中 GOPATH 表示工作区目录的绝对路径
其它环境变量的含义 参考此链接

1.3 Hello world测试

我们新建一个go语言的hello world程序编译运行测试，程序代码如下

package main

import (
    "fmt"
)

func main() {
    fmt.Printf("Hello world\n")
}

保存文件到 /home/fabric/code/go/src/fabric/go_test/main.go，执行编译安装命令后会在/home/fabric/code/go/bin/目录下生成 go_test 可执行文件。因为上一步配置了$PATH环境变量，所以可以直接执行go_test，不需要进入安装目录执行

go install fabric/go_test

测试运行

Fabric@ubuntu:~/code/go$ go_test
Hello world
Fabric@ubuntu:~/code/go$

2、安装Docker

方式一：参考官网

官网安装教程：Install Docker Engine on Ubuntu

方式二：使用官方脚本安装

• 1、执行官方安装脚本

  curl -sSl https://get.docker.com | sh
  

• 2、添加当前用户到docker组

  sudo usermod -aG docker $USER
  

• 3、增加Docker的socket绑定
  在 /etc/default/docker 文件中添加下面内容到最后一行

  DOCKER_OPTS="-s=aufs -r=true ——api-cors-header='*' -H tcp：//0.0.0.0：2375 -H unix：///var/run/docker.sock "
  

• 4、重启docker服务，让配置生效

  sudo service docker start
  

3、安装Docker Compose

Docker Compose 能够在一台主机上创建出相互隔离的网络，便于我们进行测试

方式一：pip安装（未安装成功，此处仅贴代码，有兴趣刚一下的同学自行解决）

sudo apt-get install python3-pip
sudo pip install docker-compose

方式二：直接下载安装

• 1、下载Docker compose

  sudo wget https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Linux-x86_64 -O /usr/local/bin/docker-compose
  

• 2、加可执行权限

  sudo chmod +x /usr/local/bin/docker-compose
  

• 3、查看版本号测试安装结果

  Fabric@ubuntu:~$ docker-compose version
  docker-compose version 1.29.2, build 5becea4c
  docker-py version: 5.0.0
  CPython version: 3.7.10
  OpenSSL version: OpenSSL 1.1.0l  10 Sep 2019
  Fabric@ubuntu:~$
  

4、下载Hyperledger

方式一：使用git clone

mkdir -p ~/code/go/github.com/hyperledger
cd ~/code/go/github.com/hyperledger
git clone https://github.com/hyperledger/fabric

方式二（推荐）：使用go get

为了方便后续使用go开发，我直接使用go get下载

go get github.com/hyperledger/fabric

一键部署脚本

上面的步骤全部整理并编写了一个简单的一键部署脚本，代码已经上传到Github和Gitee仓库，目前只针对Ubuntu 21.04版本的系统进行了测试，其它系统没有测试，但步骤都是一样的，使用其他版本系统的同学可以参考修改。
具体代码细节不过多阐述，欢迎大家留言交流讨论

• Github - HyperledgerStudy/fabric/tools/onekey4fabric.sh
• Gitee - hyperledger-study/fabric/tools/onekey4fabric.sh