目錄
1 安裝依賴工具
1.1 安裝 git
[root@localhost opt]# yum install git
1.2 安裝curl
[root@localhost opt]# yum install curl
1.3 安裝 Docker
查看系統(tǒng)是否已經(jīng)安裝 Docker:
[root@localhost opt]# docker --version
未安裝,使用如下命令安裝最新版本的 Docker:
[root@localhost opt]# yum install docker
安裝完之后,查看版本,出現(xiàn)如下字樣則安裝成功:
[root@localhost opt]# docker --version
Docker version 19.03.4, build 9013bf583a
設(shè)置成非 root 用戶也能執(zhí)行 docker,需要將普通用戶加入 docker 組:
[root@localhost opt]#usermod -aG docker 你的用戶名
重啟生效
1.4 安裝 docker-compose
查看系統(tǒng)是否已經(jīng)安裝 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
允許其他用戶執(zhí)行 compose 相關(guān)命令:
[root@localhost opt]# sudo chmod +x /usr/share/doc/docker-compose
1.5 安裝 Golang
1) 下載 Golang
可以直接從 https://studygolang.com/dl 下載相應(yīng)的 Golang 版本壓縮包,拷貝到虛擬機(jī)。
2) 解壓文件
下載完 Golang 壓縮包之后,壓縮包解壓到指定的 /usr/local/ 路徑下:
[root@localhost opt]# sudo tar -zxvf go1.11.11.linux-amd64.tar.gz -C /usr/local/
3) 配置環(huán)境變量
[root@localhost opt]# vi /etc/profile
在 profile 文件最后添加如下內(nèi)容:
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 命令驗(yàn)證是否安裝成功(沒(méi)有成功,重啟下虛擬機(jī)):
2. 獲取 fabric 源碼
創(chuàng)建 hyperledger 目錄并進(jìn)入該目錄:
[root@localhost opt]# mkdir hyperledger
[root@localhost opt]# cd hyperledger
獲取 fabric 的源碼,通過(guò)以下命令:
[root@localhost hyperledger]# git clone https://github.com/hyperledger/fabric.git
查看并切換當(dāng)前分支為 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
輸入如下內(nèi)容:
{
"registry-mirrors": ["https://阿里加速器.mirror.aliyuncs.com"]
}
EOF
說(shuō)明:https://阿里加速器.mirror.aliyuncs.com 是注冊(cè)是阿里云后得到的阿里docker下載鏡像地址
重新加載 docker配置文件
[root@localhost fabric]# systemctl daemon-reload
[root@localhost fabric]# systemctl restart docker
3.2 獲取Fabric依賴
可以在 fabric/scripts 目錄下找到 bootstrap.sh 腳本,復(fù)制到與 fabric 同級(jí)目錄下,執(zhí)行腳本:
[root@localhost fabric]# cp scripts/bootstrap.sh ./
[root@localhost fabric]# ./bootstrap.sh 1.4.3 1.4.3 0.4.15
該腳本會(huì)幫你干很多事情:
- 如果當(dāng)前目錄沒(méi)有 hyperledger/fabric-samples,會(huì)從 github.com 克隆 hyperledger/fabric-samples 存儲(chǔ)庫(kù);
- 使用 checkout 簽出對(duì)應(yīng)指定的版本標(biāo)簽;
- 將指定版本的 Hyperledger Fabric 平臺(tái)特定的二進(jìn)制文件和配置文件安裝到 fabric-samples 存儲(chǔ)庫(kù)的根目錄中;
- 載指定版本的 Hyperledger Fabric Docker 鏡像文件;
- 將下載的 Docker 鏡像文件標(biāo)記為 “l(fā)astest"。
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
但是因?yàn)榫W(wǎng)絡(luò)問(wèn)題,一般會(huì)卡在 binariesInstall 步驟,我們可以修改 bootstrap.sh 腳本跳過(guò)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
版本必須保持一致,要不然會(huì)出錯(cuò)。
[root@localhost fabric]# tar xvf fabric-samples-1.4.3.tar.gz
2) 下載可執(zhí)行二進(jìn)制文件
下載指定版本的 Hyperledger Fabric 平臺(tái)特定的二進(jìn)制文件和配置文件,查看 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
}
該腳本從下面兩個(gè)鏈接中下載二進(jìn)制文件,這個(gè)網(wǎng)絡(luò)貌似不能用,可以直接使用下面鏈接下載:
- 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 文件夾內(nèi):
[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)執(zhí)行 bootstrap.sh 腳本:
[root@localhost fabric-samples]# cd ..
[root@localhost fabric]# ./bootstrap.sh 1.4.3 1.4.3 0.4.15
腳本將只下載Docker鏡像 ,執(zhí)行 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 設(shè)置環(huán)境變量
啟動(dòng) fabric-samples/first-network 網(wǎng)絡(luò)所需二進(jìn)制文件的默認(rèn)路徑為 fabric-samples/bin,可以將該路徑添加入環(huán)境變量中:
[root@localhost fabric]# vi /etc/profile
在 profile 文件最后添加:
export PATH=$PATH:/opt/hyperledger/fabric/fabric-samples/bin
使用 source 命令使文件生效:
[root@localhost fabric]# source /etc/profile
檢驗(yàn)環(huán)境變量是否成功(沒(méi)有成功,重啟下虛擬機(jī)):
[root@localhost fabric]# fabric-ca-client version
fabric-ca-client:
Version: 1.4.3
Go version: go1.11.5
OS/Arch: linux/amd64
4 測(cè)試網(wǎng)絡(luò)
4.1 創(chuàng)建網(wǎng)絡(luò)
第1步:執(zhí)行 ./byfn.sh generate 命令生成相應(yīng)的文件
[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為啟動(dòng)這個(gè)網(wǎng)絡(luò)的啟動(dòng)腳本,啟動(dòng)腳本中除建立一個(gè)包含4個(gè)節(jié)點(diǎn)和1個(gè)Order service的網(wǎng)絡(luò)外,還會(huì)啟動(dòng)一個(gè)容器用來(lái)執(zhí)行腳本在channel中加入節(jié)點(diǎn),部署和初始化chaincode,以及在部署的chaincode上執(zhí)行交易。默認(rèn)channel名稱為mychannel,腳本程序會(huì)給網(wǎng)絡(luò)實(shí)例生成數(shù)字證書(shū)和密鑰;生成genesis block用來(lái)啟動(dòng)ordering service;一些用來(lái)配置channel的配置交易
啟動(dòng)網(wǎng)絡(luò)
[root@localhost first-network]# ./byfn.sh up
通過(guò) docker ps 命令可以查看到節(jié)點(diǎn)的啟動(dòng)情況。
4.2 關(guān)閉網(wǎng)絡(luò)
[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 ...
*腳本將刪除調(diào)用 docker-compose down 刪除所有容器 *