搭建Fabric 1.0开发环境和Fabric-sample e2e_cli（一）

参考了面料，搬运工，去官方文档和深蓝居的博客园

作者：ethanlu（ethanlu@mail.ustc.edu.cn）

创建于：2018年7月17日

最后修改：2018年7月18日

一，安装的Linux的的的的环境

安装虚拟机没什么好说的，工作站，虚拟盒，VMware Fusion都可以，下载最新版本，ubuntu16.04镜像建议科大镜像，稳定且快。

镜像地址：https：//mirrors.ustc.edu.cn/

在安装完的Ubuntu的的的后，需要保证易源是国内的，不然如果是国外的话会很慢具体做法是：

如图1所示，打开的的的ubuntu的的系统设置

2，源更新为科大​​的

 

2.Go的安装

1，Ubuntu的的的的的的易于得到的虽然提供了围棋的安装，但是版本比较旧会报错，最好的办法如下：

wget https://storage.googleapis.com/golang/go1.10.3.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.10.3.linux-amd64.tar.gz

2，解压到/ usr / local文件夹下，设置GO环境变量。

vi ~/.profile

3，在文档最后添加以下内容：（GOPATH为去的工作文档，GOROOT为走的安装目录，这个地方设置错了后面会报错）

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

4，编辑保存并退出VI后，记得把这些环境载入：

source ~/.profile

5，我们把去的目录GOPATH设置为当前用户的文件夹下，所以记得创建去文件夹：

cd ~
mkdir go

如图6所示，这个时候看下去的环境变量设置是否正确，环境变量的设置会影响到后期织物是否能跑通：

go env

 7，检查路径是否正确：

3. Docker安装

建议安装Docker CE，CE是社区免费版，推荐按照官方文档安装，之前试过阿里云，大刀云都会报错无法解决。推荐根据官方安装靠谱。官网链接：https：//docs.docker.com/ 安装/ Linux的/泊坞窗-CE / Ubuntu的/＃支持存储司机

1，更新apt：

$ sudo apt-get update

2，安装包以网网求允许是什么意思？apt通过HTTPS使用存储库：

    sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

3，添加泊坞的官方GPG密钥：

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88通过搜索最后8个字符，验证密钥：

    sudo apt-key fingerprint 0EBFCD88

pub   4096R/0EBFCD88 2017-02-22
      Key fingerprint = 9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid                  Docker Release (CE deb) <docker@docker.com>
sub   4096R/F273FCD8 2017-02-22

5，安装最新版本的Docker CE（若使用最新则会报错，此步忽略直接直接第六步用18.03版本），或转到下一步安装特定版本：

sudo apt-get install docker-ce

6，安装特定版本的Docker CE，请列出repo中的可用版本，然后选择并安装一个。列出仓库中可用的版本：

apt-cache madison docker-ce

docker-ce | 18.03.0~ce-0~ubuntu | https://download.docker.com/linux/ubuntu xenial/stable amd64 Packages

 按其完全限定的包名称安装特定版本，如，包名称（docker-ce）“=”版本字符串（第2列）docker-ce=18.03.0~ce-0~ubuntu：

sudo apt-get install docker-ce=<VERSION>

7，通过运行hello-world 映像验证是否正确安装了Docker CE：

 sudo docker run hello-world

如图8所示，此命令下载测试映像并在容器中运行它当容器运行时，它会打印一条如下信息性消息并退出。：

 

4. Docker-compose安装

泊坞窗，撰写也是推荐根据官方文档安装,,不会出错

官网链接：https：//docs.docker.com/compose/install/

1，下载最新版本的泊坞撰写：

sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

2，对二进制文件应用可执行权限：

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

3，若安装成功，则显示下方信息：

 docker-compose --version
docker-compose version 1.21.2, build 1719ceb

5. Fabric源码下载

1，我们可以使用GIT中命令下载源码，首先需要建立对应的目录，然后进入该目录，GIT中源码下来：

mkdir -p ~/go/src/github.com/hyperledger 
cd ~/go/src/github.com/hyperledger 
git clone https://github.com/hyperledger/fabric.git

2，由于织物一直在更新，所有我们并不需要最新最新的源码，需要切换到V1.0.0版本的源码即可，一定要都是1.0否则后期会报错： 

cd ~/go/src/github.com/hyperledger/fabric
git checkout release-1.0

3，如果没有1.0.0就gir branch根据提示git checkout -bv按住TAB出新的分支版本。

6. Fabric Docker镜像的下载

1，这个其实很简单，因为我们已经设置了Docker Hub镜像地址，所以下载也会很快。官方文件也提供了批量下载的脚本。我们直接运行：

cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
source download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0

这样就可以下载所有需要的Fabric Docker镜像了。由于我们设置了国内的镜像，所以下载应该是比较快的。

2，下载完毕后，我们运行以下命令检查下载的镜像列表：

docker images

3，会出现如下信息 

7.启动光纤网络并完成ChainCode的测试

我们仍然停留在e2e_cli文件夹，这里提供了启动，关闭Fabric网络的自动化脚本。我们要启动Fabric网络，并自动运行Example02 ChainCode的测试，执行一个命令:( 不提sudo权限会报错）

sudo ./network_setup.sh up

这个做了以下操作：

7.1编译生成织物公私，证书的程序，程序在目录：织物/释放/ Linux的AMD64 / bin中

7.2基于configtx.yaml生成创世区块和通道相关信息，并保存在信道的工件文件夹。

7.3基于加密config.yaml生成公私钥和证书信息，并保存在加密的配置文件夹中。

7.4基于搬运工 - 构成-cli.yaml启动1Orderer + 4Peer + 1CLI的织物容器。

7.5在CLI启动的时候，会运行脚本/ script.sh文件，这个脚本文件包含了创建通道，加入通道，安装Example02，运行Example02等功能。

运行成功，我们可以看到这样的界面（这一步会遇到很多问题报错）：

 如果看到这个界面，这说明我们整个单机部署光纤网络已经搭建成功了。

8.手动测试一下布网络

1，我们仍然是以现在安装好的e2e_cli为例，在官方例子中，信道名字默认是mychannel，链码的名字是mycc我们首先进入CLI，我们重新打开一个命令行窗口，输入：

docker exec -it cli bash

2，运行以下命令可以查询一个账户的余额：

3，然后，我们试一试把一个账户的余额再转20元给b账户，运行命令：

peer chaincode invoke -o orderer.example.com:7050  --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem  -C mychannel -n mycc -c '{"Args":["invoke","a","b","20"]}'

运行结果为：

如图4所示，现在转账完毕，我们试一试再查询一下一个账户的余额，没问题的话，应该是只剩下70了我们看看实际情况：

5，果然，一切正常最后我们要关闭布网络，首先需要运行退出命令退出CLI容器关闭织物的命令与启动类似，命令为。：

cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli

./network_setup.sh down

测试用例分析

1，network_setup.sh分析：

network_setup.sh其中包括两个部分，一个是利用generateArtifacts.sh脚本文件配置组织关系和颁发证书，另一个是搬运工-构成-cli.yaml用于根据配置启动集群并测试chaincode的示例代码。 
具体流程如下：

2，generateArtifacts.sh脚本文件

generateArtifacts.sh包含三个函数：

3，搬运工-撰写-cli.yaml文件

  • generateCerts：使用cryptogen工具根据加密config.yaml来生成证书。 
  • replacePrivateKey： 。将搬运工-撰写-E2E-template.yaml文档中的CA私钥替换成具体的私钥（本例中未使用） 
  • generateChannelArtifacts：使用configtxgen工具根据configtx.yaml文件来生成orderer，genesis块，通道配置事务，锚点对等更新。

docker-compose-cli.yaml文件根据组织关系启动docker集群，并在cli容器中执行命令命令运行./scripts/script.sh脚本文件 
./scripts/script.sh脚本包含以下函数：

  • createChannel：创建频道.joinChannel：将每个节点加入频道。 
  • updateAnchorPeers installChaincode：部署链码。 
  • 我nstantiateChaincode：初始化chaincode，并设置背书策略chaincodeQuery chaincodeInvoke。

 4，configtxgen文件

configtxgen工具生成两个内容：Orderer的bootstrap block和Fabric的通道配置事务。

orderer block是订购服务的创世区块;渠道交易文件在创建渠道时会被广播给orderer。

configtx.yaml包含网络的定义，并给出了网络组件的拓扑结构-2个成员（Org0和ORG1）分别管理维护2个对等体。还指出每个网络实体的加密材料的存储位置。crypto目录包含每个实体的管理员证书，CA证书，签名证书和私钥。

为了方便使用，我们提供了一个脚本generateCfgTrx.sh，脚本该整合性了configtxgen的执行过程，执行后会生成两个配置结果：orderer.block和channel.tx。如果运行你过上边的network_setup.sh则这两个配置查询查询结果已生成，到要先crypto/orderer目录将之删除。

5，在启动的过程中，是先启动configtxgen的二进制文件，包含密钥，启动顺序是

mychannel;

ORG1，peer0; 

ORG1，方1;

ORG2，peer0;

ORG2，方1;

遇到的问题

1，出现这种

或者这种

或者

原因是分支版本，镜像版本，configtxgen版本都应是1.0.0。没有安装mycc合约。报错的内容好多个文件都不存在。英文的应该之前的环节出了问题
方法的英文版本通过Ë月刊下载状语从句：它的镜像就是时指定版本使三者保持一致（还有更好的办法，重装:)）

2，安装去环境变量遇到报错，在最前面加上须藤以根用户的身份运行。运行后，在在/ usr /本地/下就可以看到进入目录了。如果是自己用软件解压的，可以拷贝到在/ usr /本地/去下，但是要保证你的去文件夹下是垃圾桶，SRC，DOC等目录，不要去文件夹下又是一个去文件夹，这样就双重嵌套了。

然后就要配置环境变量了，LINUX下又两个文件可以配置，其中的/ etc / profile文件是针对所有用户都有效的; $ HOME / .profile文件是针对当前用户有效的，可以根据自己的情况选择。

针对所有用户的需要重启电脑才可以生效;针对当前用户的，在终端里使用源命令加载这个$ HOME / .profile中即可生效。

3，最常见也是最容易忽视的问题，每次当解决完一个问题，其实已经设置好了，但是还是和之前一样报错，这个时候是权限问题，只要加一个须藤，或者苏进入根模式即可，这个能让很多人困惑，明明我已经解决了问题，为什么还是报同样的错？

 

4、
 

原因是：

e2e_cli目录是固定的，启动后会创建一个docker network以此为名字，这里是e2e_cli。如果修改该目录，要修改/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/base目录下的peer-base.yaml

将网络名改成如下名称即可

- CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=e2e_cli_default



 

 

阅读更多

更多精彩内容