【Hyperledger Fabric 开发学习1】 环境搭建

1. 概览

准备工作

1 系统环境准备 ：Ubuntu 20.02 LTC
2 apt 更换镜像源
3 辅助工具安装
4 安装go
5 安装容器docker和docker compose

Hyperledger Fabric安装

方法1： 以bootstrap.sh脚本方式进行环境的安装，优点是简单、方便，能够快速上手;需要虚拟机已配置科学上网工具

方法2：手动安装，以Fabric源码方式进行编译；较繁琐，但可以更加深入理解搭建过程
1. 下载并编译二进制文件（源码）
2. 下载fabric-samples
3. fabric-ca编译
4. Fabric docker镜像下载
5. 开发客户端安装golang-sdk

启动测试网络测试

2 准备工作

2.1 系统环境准备

系统环境：Ubuntu20.02 LTC
安装成功后输入刚才新建的用户和密码，进去即可，鼠标右键，选择Open in Terminal，即打开终端窗口：
输入命令sudo passwd
再次输入命令su root，便切换到root用户
接下来给用户添加sudo权限，依次输入下面的命令：
第一，先给 /etc/sudoers 文件赋予可写的权限：chmod u+w /etc/sudoers
第二，接着编写 /etc/sudoers文件：vi /etc/sudoers
第三，在root ALL=(ALL:ALL) ALL下面添加XXX(用户名) ALL=(ALL) ALL语句
第四、恢复 /etc/sudoers 原来只读的权限：chmod u-w /etc/sudoers

2.2 apt 更换镜像源

1. 备份一下之前的apt的资源配置文件，命令如下：

cp /etc/apt/sources.list /etc/apt/sources.list.bak

2. 编辑源列表文件（vim或gedit都可以；也可尝试用资源管理器打开修改）

sudo vim /etc/apt/sources.list

3. 进入界面

4. 使用清华镜像源全部替换

https://mirrors.tuna tsiinghua.edu.cn/help/obuntu/
复制粘贴

5. 替换与修改

HTTPS有时需要替换为http；# 后面为注释，可忽略

6. 修改后保存
   esc
:wq!

7. 运行 sudo apt-get upgrade
   作用：已经安装软件和软件列表对比，提示更新软件

2.3 辅助工具安装

工具	命令
vim	sudo apt-get install vim
git	sudo apt install git
cURL	sudo apt install curl
wget	sudo apt-get install wget
libtool libltdl-dev	sudo apt install libtool libltdl-dev
jq	apt install jq

1. vim
2. git
   git是一个非常优秀的开源版本管理控制工具，使用git工具可以方便地下载官方（Golang、Hyperledger Fabric等）在GitHub网站上发布的相关源代码或其他内容。
3. cURL
   curl:利用URL语法在命令行下工作的文件传输工具。支持文件上传和文件下载
4. wget
   wget：下载文件的工具，用在命令行下。经常要下载一些软件或从远程服务器恢复备份到本地服务器。
5. libtool libltdl-dev
   后面make编译fabric用到
6. jq
   后面fabric测试网络用到。
   Optional: Install the latest version of jq (only required for the tutorials related to channel configuration transactions).

2.4 go 安装

GO官网地址 Download and install - The Go Programming Language (google.cn)

2.4.1 下载Golang压缩包

进入到Download文件夹，下载Golang压缩包-注意需要下载的版本

cd ~
cd Download
wget https://storage.googleapis.com/golang/go1.20.5.linux-amd64.tar.gz

2.4.2 解压到指定文件夹

切换到root模式；移除先前的go文件，并将安装包解压到指定文件夹;删除原有安装包；

 rm -rf /usr/local/go && tar -C /usr/local -xzf go1.20.5.linux-amd64.tar.gz

2.4.3 配置环境变量

root下输入命令

vim ~/.bashrc

输入i,进入编辑模式，在文件后面添加

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

使文件生效

source ~/.bashrc

2.4.4. 配置用户环境变量

打开profile 文件

vim ~/.profile

文档末尾添加并保存

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

使修改后的profile文件立即生效

source ~/.profile

2.4.5 配置终端变量

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

2.4.6 go version验证

go version

2.4.7配置go代理

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

2.5 安装容器docker和docker compose

1. 查看系统中是否已经安装Docker

docker --version

卸载docker

sudo apt-get remove docker docker-engine docker.io

2. 安装Docker和docker compose环境

 sudo apt update
 sudo apt install docker
 sudo apt install docker-compose

3. 启动docker

sudo service docker start

4. 验证

docker --version && docker-compose  --version

5. 开机启动docker

sudo systemctl enable docker

7. 将当前用户加入docker组：

sudo groupadd docker
sudo usermod –a –G docker <username>

7. docker images 命令 列出本地镜像

docker images

8. 安装结果示例

9. 安装docker加速器（阿里云镜像）
   输入命令：cd /etc/docker，进入/etc/docker目录

10. 增加权限

sudo chmod -R 777 /var/run/docker.sock

查看docker状态

systemctl status docker

3 Hyperledger Fabric安装

3.1 下载并编译源码

3.1.1 下载fabric 源码

1. 先使用mkdir命令创建相应的目录，然后使用git clone命令将Hyperledger Fabric源码克隆至该目录中：

mkdir -p $GOPATH/src/github.com/hyperledger/
cd $GOPATH/src/github.com/hyperledger/
git clone https:// github.com/hyperledger/fabric.git

2. 查看fabric所有版本，并切换fabric版本：源码下载完成后使用git checkout命令切换至指定的分支：

cd $GOPATH/src/github.com/hyperledger/fabric/
git tag
git checkout -b v2.2.10 #根据需求选择版本号,建议使用LTC版本

3.1.2 编译fabric 源码（使用make release编译）

1. 安装make

sudo apt install make
sudo apt install make-guile

2. 使用make release编译

cd ~/go/src/github.com/hyperledger/fabric
make release

3. 其中discover是服务发现命令，只需要检查另外六个是否安装好，fabric目录下输入以下命令：能正常显示版本号等相关信息即可

./release/linux-amd64/bin/peer version
./release/linux-amd64/bin/orderer version
./release/linux-amd64/bin/configtxgen -version
./release/linux-amd64/bin/configtxlator version
./release/linux-amd64/bin/cryptogen version
./release/linux-amd64/bin/osnadmin version

4. 安装可执行文件

sudo cp $GOPATH/src/github.com/hyperledger/fabric/release/linux-amd64/bin/* /usr/local/bin
sudo chmod -R 775 /usr/local/bin/configtxgen
sudo chmod -R 775 /usr/local/bin/configtxlator
sudo chmod -R 775 /usr/local/bin/cryptogen
sudo chmod -R 775 /usr/local/bin/discover
sudo chmod -R 775 /usr/local/bin/ledgerutil
sudo chmod -R 775 /usr/local/bin/peer
sudo chmod -R 775 /usr/local/bin/orderer
sudo chmod -R 775 /usr/local/bin/osnadmin

3.2 下载fabric-samples

mkdir -p $GOPATH/src/github.com/hyperledger
cd $GOPATH/src/github.com/hyperledger
git clonehttps://github.com/hyperledger/fabric-samples.git

cd fabric-samples

切换版本号

sudo git checkout -b v2.2.10

查看当前版本

sudo git branch

3.3 fabric-ca编译

目录：回到hyperledger目录下

cd $GOPATH/src/github.com/hyperledger/  #目录：回到hyperledger目录下

下载fabric-ca源码

cd $GOPATH/src/github.com/hyperledger
git clone git@github.com:hyperledger/fabric-ca.git

fabric 与fabric-ca 对应版本号可在fabric/scripts/bootstrap.sh中查看
编译安装fabric-ca组件

cd $GOPATH/src/github.com/hyperledger/fabric-ca
make fabric-ca-server
make fabric-ca-client

安装编译好的可执行文件，输入以下命令：

cd $GOPATH/src/github.com/hyperledger/fabric-ca/bin
sudo cp * /usr/local/bin/
chmod -R 755 /usr/local/bin/fabric-ca-server
chmod -R 755 /usr/local/bin/fabric-ca-client

检查是否可执行：

fabric-ca-server version
fabric-ca-client version

3.4 Fabric docker镜像下载

cd $GOPATH/src/github.com/hyperledger/fabric/scripts
./bootstrap.sh

docker images  # 查看镜像信息

3.5 开发客户端安装golang-sdk

cd $GOPATH/src/github.com/hyperledger
git clone https://github.com/hyperledger/fabric-sdk-go
# github不行就换gitee

4 启动测试网络

官方文档： Using the Fabric test network — hyperledger-fabricdocs main documentation

cd $GOPATH/src/github.com/hyperledger/fabric/scripts/fabric-samples/test-network

启动测试网络

./network.sh up

创建通道

./network.sh createChannel

在通道上启动链码

./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go -ccl go