目录
-
1. 安装依赖工具
- 1.1 安装 git
- 1.2 安装 curl
- 1.3 安装 docker
- 1.4 安装 docker-compose
- 1.5 安装 Golang
- 获取 fabric 源码
-
- 获取 fabric-samples 源码
- 3.1 配置 docker 镜像地址
- 3.2 获取Fabric依赖
- 3.3 设置环境变量
-
- 创建和管理网络
- 4.1 创建网络
- 4.2 启动网络
- 4.3 关闭网络
1 安装依赖工具
1.1 安装 git
[root@localhost opt]# yum install git
1.2 安装curl
[root@localhost opt]# yum install curl
1.3 安装 Docker
查看系统是否已经安装 Docker:
[root@localhost opt]# docker --version
未安装,使用如下命令安装最新版本的 Docker:
[root@localhost opt]# yum install docker
安装完之后,查看版本,出现如下字样则安装成功:
[root@localhost opt]# docker --version
Docker version 19.03.4, build 9013bf583a
设置成非 root 用户也能执行 docker,需要将普通用户加入 docker 组:
[root@localhost opt]#usermod -aG docker 你的用户名
重启生效
1.4 安装 docker-compose
查看系统是否已经安装 docker-compose:
[root@localhost opt]# docker-compose --version
未安装,使用如下命令安装 docker-compose 工具:
[root@localhost opt]# yum install docker-compose
安装完之后,查看版本:
[root@localhost opt]# docker-compose --version
docker-compose version 1.17.1, build unknown
允许其他用户执行 compose 相关命令:
[root@localhost opt]# sudo chmod +x /usr/share/doc/docker-compose
1.5 安装 Golang
1) 下载 Golang
可以直接从 https://studygolang.com/dl 下载相应的 Golang 版本压缩包,拷贝到虚拟机。
2) 解压文件
下载完 Golang 压缩包之后,压缩包解压到指定的 /usr/local/ 路径下:
[root@localhost opt]# sudo tar -zxvf go1.11.11.linux-amd64.tar.gz -C /usr/local/
3) 配置环境变量
[root@localhost opt]# vi /etc/profile
在 profile 文件最后添加如下内容:
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
使用 source 命令,使刚刚添加的配置信息生效:
[root@localhost opt]# source /etc/profile
使用 go version 命令验证是否安装成功(没有成功,重启下虚拟机):
2. 获取 fabric 源码
创建 hyperledger 目录并进入该目录:
[root@localhost opt]# mkdir hyperledger
[root@localhost opt]# cd hyperledger
获取 fabric 的源码,通过以下命令:
[root@localhost hyperledger]# git clone https://github.com/hyperledger/fabric.git
查看并切换当前分支为 v1.4.3:
[root@localhost hyperledger]# cd ./fabric
[root@localhost fabric]# git branch -a
[root@localhost fabric]# git checkout v1.4.3
3 获取 fabric-samples 源码
3.1 配置 docker 镜像地址
不配 docker 置镜像下载地址,下载速度很慢,可以如下配置:
[root@localhost fabric]# mkdir -p /etc/docker
[root@localhost fabric]# vi /etc/docker/daemon.json
输入如下内容:
{
"registry-mirrors": ["https://阿里加速器.mirror.aliyuncs.com"]
}
EOF
说明:https://阿里加速器.mirror.aliyuncs.com 是注册是阿里云后得到的阿里docker下载镜像地址
重新加载 docker配置文件
[root@localhost fabric]# systemctl daemon-reload
[root@localhost fabric]# systemctl restart docker
3.2 获取Fabric依赖
方法一
可以在 fabric/scripts 目录下找到 bootstrap.sh 脚本,复制到与 fabric 同级目录下,执行脚本:
[root@localhost fabric]# cp scripts/bootstrap.sh ./
[root@localhost fabric]# ./bootstrap.sh 1.4.3 1.4.3 0.4.15
该脚本会帮你干很多事情:
- 如果当前目录没有 hyperledger/fabric-samples,会从 github.com 克隆 hyperledger/fabric-samples 存储库;
- 使用 checkout 签出对应指定的版本标签;
- 将指定版本的 Hyperledger Fabric 平台特定的二进制文件和配置文件安装到 fabric-samples 存储库的根目录中;
- 载指定版本的 Hyperledger Fabric Docker 镜像文件;
- 将下载的 Docker 镜像文件标记为 “lastest"。
bootstrap.sh 脚本,主要帮做如下三件事:
if [ "$SAMPLES" == "true" ]; then
echo
echo "Installing hyperledger/fabric-samples repo"
echo
samplesInstall
fi
if [ "$BINARIES" == "true" ]; then
echo
echo "Installing Hyperledger Fabric binaries"
echo
binariesInstall
fi
if [ "$DOCKER" == "true" ]; then
echo
echo "Installing Hyperledger Fabric docker images"
echo
dockerInstall
fi
但是因为网络问题,一般会卡在 binariesInstall 步骤,我们可以修改 bootstrap.sh 脚本跳过binariesInstall 步骤:
原 :
SAMPLES=true
BINARIES=true
改为:
SAMPLES=false
BINARIES=false
1)要手工下载fabric-samples 源码
samplesInstall() {
# clone (if needed) hyperledger/fabric-samples and checkout corresponding
# version to the binaries and docker images to be downloaded
if [ -d first-network ]; then
# if we are in the fabric-samples repo, checkout corresponding version
echo "===> Checking out v${VERSION} of hyperledger/fabric-samples"
git checkout v${VERSION}
elif [ -d fabric-samples ]; then
# if fabric-samples repo already cloned and in current directory,
# cd fabric-samples and checkout corresponding version
echo "===> Checking out v${VERSION} of hyperledger/fabric-samples"
cd fabric-samples && git checkout v${VERSION}
else
echo "===> Cloning hyperledger/fabric-samples repo and checkout v${VERSION}"
git clone -b master https://github.com/hyperledger/fabric-samples.git && cd fabric-samples && git checkout v${VERSION}
fi
}
可以取直接下载 fabric-samples 1.4.3版本源码 https://codeload.github.com/hyperledger/fabric-samples/tar.gz/v1.4.3
版本必须保持一致,要不然会出错。
[root@localhost fabric]# tar xvf fabric-samples-1.4.3.tar.gz
2) 下载可执行二进制文件
下载指定版本的 Hyperledger Fabric 平台特定的二进制文件和配置文件,查看 bootstrap.sh 脚本:
binariesInstall() {
echo "===> Downloading version ${FABRIC_TAG} platform specific fabric binaries"
binaryDownload "${BINARY_FILE}" "https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/${ARCH}-${VERSION}/${BINARY_FILE}"
if [ $? -eq 22 ]; then
echo
echo "------> ${FABRIC_TAG} platform specific fabric binary is not available to download <----"
echo
fi
echo "===> Downloading version ${CA_TAG} platform specific fabric-ca-client binary"
binaryDownload "${CA_BINARY_FILE}" "https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric-ca/hyperledger-fabric-ca/${ARCH}-${CA_VERSION}/${CA_BINARY_FILE}"
if [ $? -eq 22 ]; then
echo
echo "------> ${CA_TAG} fabric-ca-client binary is not available to download (Available from 1.1.0-rc1) <----"
echo
fi
}
该脚本从下面两个链接中下载二进制文件,这个网络貌似不能用,可以直接使用下面链接下载:
- https://github.com/hyperledger/fabric/releases/download/v1.4.3/hyperledger-fabric-linux-amd64-1.4.3.tar.gz
- https://github.com/hyperledger/fabric-ca/releases/download/v1.4.3/hyperledger-fabric-ca-linux-amd64-1.4.3.tar.gz
解压 yperledger-fabric-linux-amd64-1.4.3.tar 和 hyperledger-fabric-ca-linux-amd64-1.4.3.tar 到 fabric-samples 文件夹内:
[root@localhost fabric]# cd fabric-samples
[root@localhost fabric-samples]# tar xvf ../../hyperledger-fabric-linux-amd64-1.4.3.tar.gz
[root@localhost fabric-samples]# tar xvf ../../hyperledger-fabric-ca-linux-amd64-1.4.3.tar.gz
3)执行 bootstrap.sh 脚本:
[root@localhost fabric-samples]# cd ..
[root@localhost fabric]# ./bootstrap.sh 1.4.3 1.4.3 0.4.15
脚本将只下载Docker镜像 ,执行 docker images 命令查看下载的 images:
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hyperledger/fabric-tools 1.4.3 18ed4db0cd57 7 months ago 1.55GB
hyperledger/fabric-tools latest 18ed4db0cd57 7 months ago 1.55GB
hyperledger/fabric-ca 1.4.3 c18a0d3cc958 7 months ago 253MB
hyperledger/fabric-ca latest c18a0d3cc958 7 months ago 253MB
hyperledger/fabric-ccenv 1.4.3 3d31661a812a 7 months ago 1.45GB
hyperledger/fabric-ccenv latest 3d31661a812a 7 months ago 1.45GB
hyperledger/fabric-orderer 1.4.3 b666a6ebbe09 7 months ago 173MB
hyperledger/fabric-orderer latest b666a6ebbe09 7 months ago 173MB
hyperledger/fabric-peer 1.4.3 fa87ccaed0ef 7 months ago 179MB
hyperledger/fabric-peer latest fa87ccaed0ef 7 months ago 179MB
hyperledger/fabric-javaenv 1.4.3 5ba5ba09db8f 8 months ago 1.76GB
hyperledger/fabric-javaenv latest 5ba5ba09db8f 8 months ago 1.76GB
hyperledger/fabric-zookeeper 0.4.15 20c6045930c8 12 months ago 1.43GB
hyperledger/fabric-zookeeper latest 20c6045930c8 12 months ago 1.43GB
hyperledger/fabric-kafka 0.4.15 b4ab82bbaf2f 12 months ago 1.44GB
hyperledger/fabric-kafka latest b4ab82bbaf2f 12 months ago 1.44GB
hyperledger/fabric-couchdb 0.4.15 8de128a55539 12 months ago 1.5GB
hyperledger/fabric-couchdb latest 8de128a55539 12 months ago 1.5GB
3.3 设置环境变量
启动 fabric-samples/first-network 网络所需二进制文件的默认路径为 fabric-samples/bin,可以将该路径添加入环境变量中:
[root@localhost fabric]# vi /etc/profile
在 profile 文件最后添加:
export PATH=$PATH:/opt/hyperledger/fabric/fabric-samples/bin
使用 source 命令使文件生效:
[root@localhost fabric]# source /etc/profile
检验环境变量是否成功(没有成功,重启下虚拟机):
[root@localhost fabric]# fabric-ca-client version
fabric-ca-client:
Version: 1.4.3
Go version: go1.11.5
OS/Arch: linux/amd64
4 测试网络
4.1 创建网络
第1步:执行 ./byfn.sh generate 命令生成相应的文件
[root@localhost fabric]# cd ./fabric-samples/first-network/
[root@localhost first-network]# ./byfn.sh generate
Generating certs and genesis block for channel 'mychannel' with CLI timeout of '10' seconds and CLI delay of '3' seconds
Continue? [Y/n]
...
byfn.sh为启动这个网络的启动脚本,启动脚本中除建立一个包含4个节点和1个Order service的网络外,还会启动一个容器用来执行脚本在channel中加入节点,部署和初始化chaincode,以及在部署的chaincode上执行交易。默认channel名称为mychannel,脚本程序会给网络实例生成数字证书和密钥;生成genesis block用来启动ordering service;一些用来配置channel的配置交易
启动网络
[root@localhost first-network]# ./byfn.sh up
通过 docker ps 命令可以查看到节点的启动情况。
4.2 关闭网络
[root@localhost first-network]# ./byfn.sh down
Stopping for channel 'mychannel' with CLI timeout of '10' seconds and CLI delay of '3' seconds
Continue? [Y/n] y
proceeding ...
*脚本将删除调用 docker-compose down 删除所有容器 *
有疑问加站长微信联系(非本文作者)