Hyperledger Fabric 2.4.9 环境搭建和 Caliper 0.5.0 测试工具部署教程(Ubuntu)

1. 环境准备

本教程基于 VMware 17 Ubuntu 20.04Fabric 2.4.9 环境搭建和 Hyperledger Caliper 0.5.0 部署测试。

1.1. VMware安装

由于 VMware 被 Broadcom 收购,原官网停用,下载 VMware 需要注册 Broadcom 账户,个人觉得比较麻烦,推荐下载链接:

VMware Workstation Pro 17.5.2

VMware 17 安装教程,参考如下链接:

vmware-17虚拟机安装教程(保姆级包含图文讲解,不需注册账户)_vmware17-CSDN博客

1.2. Ubuntu安装

使用清华源下载 ios 镜像文件, Ubuntu 20.04 镜像下载链接:

Ubuntu 20.04

Ubuntu 20.04 安装教程,参考如下链接:

【Linux】Ubuntu 20.04安装教程(图文详解)_ubuntu20.04安装教程-CSDN博客

1.3. 基础环境安装

1.3.1. Git

sudo apt install git -y

安装完成后,查看版本:

git --version

1.3.2. cURL

sudo apt install curl -y

1.3.3. vim

sudo apt install vim -y

1.3.4. jq

sudo apt install jq -y

1.3.5. Docker和Docker-compose

我安装的版本分别为:docker 24.0.7 docker-compose 1.25.0

直接使用 apt 命令安装 docker-compose (并自动安装 docker )即可:

sudo apt install docker-compose

赋予 docker-compose 可执行权限:

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

安装完成后,查看版本:

docker version
docker-compose version

设置 docker 自动启动:

sudo systemctl enable docker

查看 docker 启动状态:

systemctl status docker

安装 docker 时会添加名为 docker 的用户组,需要将当前的用户添加到用户组 docker 中:

sudo usermod -aG docker $USER

重启系统:

reboot

再次查看 docker 版本,确认 Server 已正常。

更换 docker 镜像源,创建目录 /etc/docker:

sudo mkdir -p /etc/docker

创建并修改 daemon.json 配置文件:

sudo vim /etc/docker/daemon.json

 添加如下内容:

{
    "registry-mirrors": [
    	"https://dockerproxy.cn",
    	"https://docker.1panel.dev",
	    "https://docker.fxxk.dedyn.io",
	    "https://docker.xn--6oq72ry9d5zx.cn",
	    "https://a.ussh.net",
	    "https://docker.zhai.cm",
	    "https://docker.m.daocloud.io",
        "https://docker.nju.edu.cn",
        "https://dockerproxy.com"
    ]
}

重启 docker:

sudo systemctl daemon-reload
sudo systemctl restart docker

查看镜像源是否配置成功:

docker info

1.3.6. Go

Fabric 2.4.9 要求 go 版本: Go 1.18.10 版本及以上

这里我安装的是 Go 1.22.4 ,安装命令:

wget https://dl.google.com/go/go1.22.4.linux-amd64.tar.gz
sudo tar -C /usr/local -zxvf go1.22.4.linux-amd64.tar.gz

配置环境变量,修改 ~/.bashrc 文件:

sudo vim ~/.bashrc

在文件开头添加如下内容:

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

使用 source 命令使之生效:

source ~/.bashrc

查看 go 版本信息:

go env

配置 Modules 和代理:

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

1.3.7. Node.js

为了方便安装和管理 Node.js 的版本,需要先在系统中安装 NVM(Node Version Manager),它是 Node.js 的版本管理软件,可以根据不同的需求在 Node.js 的各个版本之间进行切换。

在安装 Node.js 时, npm 也会跟着一起安装,它是 Node.js 的包管理工具,管理 Node.js 中的第三方依赖。

下载 NVM 的 Gitee 镜像:

git clone https://gitee.com/mirrors/nvm.git ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`

执行 install.sh:

./install.sh

创建并修改 .bash_profile 文件:

vim .bash_profile

添加如下内容:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

使用 source 命令使之生效:

source .bash_profile

验证 NVM 的安装是否成功:

nvm -v

Node.js 的版本要与 Fabric 的版本对应,参考如下图片: