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版本的系统进行了测试，其它系统没有测试，但步骤都是一样的，使用其他版本系统的同学可以参考修改。

具体代码细节不过多阐述，欢迎大家留言交流讨论

- HyperledgerStudy/fabric/tools/onekey4fabric.sh
- hyperledger-study/fabric/tools/onekey4fabric.sh