ubuntu搭建fabric1.0环境

本是古典何须时尚 2023-06-25 02:26 8阅读 0赞

### 本文转载至[博客园深蓝居][Link 1]，原文见：http://www.cnblogs.com/studyzy/p/7437157.html ###

本人在Ubuntu 14.04.5 测试也能正确搭建fabric1.0 环境。

### 1. 使用VirtualBox并在其中安装好Ubuntu ###

这一步其实没啥好说的，下载好最新版的VirtualBox，下载Ubuntu Server，我用的是Ubuntu16.04.2 X64 Server。在安装完Ubuntu后，需要保证apt source是国内的，不然如果是国外的话会很慢很慢的。具体做法是

sudo vi /etc/apt/sources.list

打开这个apt源列表，如果其中看到是http://us.xxxxxx之类的，那么就是外国的，如果看到是[http://cn.xxxxx][http_cn.xxxxx]之类的，那么就不用换的。我的是美国的源，所以需要做一下批量的替换。在命令模式下，输入：

:%s/us./cn./g

就可以把所有的us.改为cn.了。然后输入:wq即可保存退出。

sudo apt-get update

更新一下源。

然后安装ssh，这样接下来就可以用putty或者SecureCRT之类的客户端远程连接Ubuntu了。

sudo apt-get install ssh

### 2. Go的安装 ###

Ubuntu的apt-get虽然提供了Go的安装，但是版本比较旧，最好的方法还是参考官方网站[ https://golang.org/dl/][https_golang.org_dl] ，下载最新版的Go。具体涉及到的命令包括：

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

【注意：不要使用apt方式安装go，apt的go版本太低了！】

接下来编辑当前用户的环境变量：

vi ~/.profile

添加以下内容：

1.  `export PATH=$PATH:/usr/local/go/bin`
2.  `export GOROOT=/usr/local/go`
3.  `export GOPATH=$HOME/go`
4.  `export PATH=$PATH:$HOME/go/bin`

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

source ~/.profile

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

1.  `cd ~`
2.  `mkdir go`

### 3. Docker安装 ###

我们可以使用阿里提供的镜像，安装也非常方便。通过以下命令来安装Docker

curl -sSL http://acs-public-mirror.oss-cn-hangzhou.aliyuncs.com/docker-engine/internet | sh -

安装完成后需要修改当前用户（我使用的用户叫fabric）权限：

sudo usermod -aG docker fabric

注销并重新登录，然后添加阿里云的Docker Hub镜像：

![复制代码][aHR0cDovL2NvbW1vbi5jbmJsb2dzLmNvbS9pbWFnZXMvY29weWNvZGUuZ2lm]

![复制代码][aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]

1.  `sudo mkdir -p /etc/docker`
2.  `sudo tee /etc/docker/daemon.json <<-'EOF'`
3.  `{`
4.  `"registry-mirrors": ["https://obou6wyb.mirror.aliyuncs.com"]`
5.  `}`
6.  `EOF`
7.  `sudo systemctl daemon-reload`
8.  `sudo systemctl restart docker`

![复制代码][aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]

![复制代码][aHR0cDovL2NvbW1vbi5jbmJsb2dzLmNvbS9pbWFnZXMvY29weWNvZGUuZ2lm]

不同的版本添加方法是不一样的，官方的文档如下：

[https://cr.console.aliyun.com/\#/accelerator][https_cr.console.aliyun.com_accelerator]

当然觉得阿里云镜像不好用，喜欢用DaoClound的也可以用DaoClound的镜像。DaoCloud的镜像设置文档为：[https://www.daocloud.io/mirror\#accelerator-doc][https_www.daocloud.io_mirror_accelerator-doc]

### 4. Docker-Compose的安装 ###

Docker-compose是支持通过模板脚本批量创建Docker容器的一个组件。在安装Docker-Compose之前，需要安装Python-pip，运行脚本：

sudo apt-get install python-pip

然后是安装docker-compose，我们从官方网站（[https://github.com/docker/compose/releases][https_github.com_docker_compose_releases]）下载也可以从国内的进行DaoClound下载，为了速度快接下来从DaoClound安装Docker-compose，运行脚本：

1.  ``curl -L https://get.daocloud.io/docker/compose/releases/download/1.12.0/docker-compose-`uname -s`-`uname -m` > ~/docker-compose``
2.  `sudo mv ~/docker-compose /usr/local/bin/docker-compose`
3.  `chmod +x /usr/local/bin/docker-compose`

### 5. Fabric源码下载 ###

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

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

由于Fabric一直在更新，所有我们并不需要最新最新的源码，需要切换到v1.0.0版本的源码即可：

1.  `cd ~/go/src/github.com/hyperledger/fabric`
2.  `git checkout v1.0.0`

### 6. Fabric Docker镜像的下载 ###

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

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

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

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

docker images

得到的结果如下：

[![image][]][image 1]

### 7.启动Fabric网络并完成ChainCode的测试 ###

我们仍然停留在e2e\_cli文件夹，这里提供了启动、关闭Fabric网络的自动化脚本。我们要启动Fabric网络，并自动运行Example02 ChainCode的测试，执行一个命令：

./network_setup.sh up

这个做了以下操作：

7.1编译生成Fabric公私钥、证书的程序，程序在目录：fabric/release/linux-amd64/bin

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

7.3基于crypto-config.yaml生成公私钥和证书信息，并保存在crypto-config文件夹中。

7.4基于docker-compose-cli.yaml启动1Orderer+4Peer+1CLI的Fabric容器。

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

最后运行完毕，我们可以看到这样的界面：

[![image][image 2]][image_image 2]

如果您看到这个界面，这说明我们整个Fabric网络已经通了。

E2E这个实例中，fabric做了如下操作，可通过查看启动时打印的日志对应每一步操作：

*  在CLI容器中执行了脚本`script.sh`。该脚本用默认的`mychannel`执行`createChannel`命令，这个命令用到了之前`configtxgen`工具生成的`channel.tx`。
 *  `createChannel`执行后会生成一个创世区块`mychannel.block`并保存到当前目录。
 *  对4个peer分别执行`joinChannel`命令，通过初始区块`mychannel.block`加入channel。至此，有一个channel包含4个peer和2个organization。
 *  `PEER0`和`PEER1`属于Org0，`PEER2`和`PEER3`属于Org1。这些关系的定义都在`configtx.yaml`中
 *  Chaincode `chaincode_example02`被install到`PEER0`和`PEER2`
 *  然后Chaincode在`PEER2`上instantiate。实例化是指启动容器和初始化与Chaincode相关的键值对，本例中的初始值是`[“a”,”100” “b”,”200”]`。实例化的结果是一个名为`dev-peer2-mycc-1.0`的容器启动，注意，这个容器仅是针对`PEER2`。***（译注：尤其注意这里仅仅是启动了一个container）***
 *  实例化时还会带有背书策略参数，本例中背书策略为\`-P “OR (‘Org0MSP.member’,’Org1MSP.member’)”，意思是任何交易必须由绑定到Org0或者Org1的peer背书。
 *  对于“a”的query请求发送到`PEER0`。在之前Chaincode被install到`PEER0`了，所以就可以启动一个名为`dev-peer0-mycc-1.0`的新容器，然后返回查询结果。由于没有write操作发生，所以“a”的值依然是“100”。
 *  从“a“转移”10“给”b”的invoke请求发送到`PEER0`
 *  Chaincode install到`PEER3`
 *  对“a”的query请求发送到`PEER3`。这启动了第三个名为`dev-peer3-mycc-1.0`的容器，并返回查询结果90，正确的反映了之前的交易。

### 8.手动测试一下Fabric网络 ###

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

docker exec -it cli bash

运行以下命令可以查询a账户的余额：

peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'

可以看到余额是90：

[![image][image 3]][image_image 3]

然后，我们试一试把a账户的余额再转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"]}'

运行结果为：

[![image][image 4]][image_image 4]

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

[![image][image 5]][image_image 5]

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

1.  `cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli`
2.   
3.  `./network_setup.sh down`

现在我们整个Fabric的环境已经测试完毕，恭喜，一切正常，接下来我们就是去做自己的区块链的开发。

[Link 1]: http://studyzy.cnblogs.com/
[http_cn.xxxxx]: http://cn.xxxxx/
[https_golang.org_dl]: https://golang.org/dl/
[aHR0cDovL2NvbW1vbi5jbmJsb2dzLmNvbS9pbWFnZXMvY29weWNvZGUuZ2lm]: https://imgconvert.csdnimg.cn/aHR0cDovL2NvbW1vbi5jbmJsb2dzLmNvbS9pbWFnZXMvY29weWNvZGUuZ2lm
[aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg
[https_cr.console.aliyun.com_accelerator]: https://cr.console.aliyun.com/#/accelerator
[https_www.daocloud.io_mirror_accelerator-doc]: https://www.daocloud.io/mirror#accelerator-doc
[https_github.com_docker_compose_releases]: https://github.com/docker/compose/releases
[image]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMyMDE3LmNuYmxvZ3MuY29tL2Jsb2cvMjYyNS8yMDE3MDgvMjYyNS0yMDE3MDgyNzAxMTY0MTAyNy0yMTA3Nzk4NTQxLnBuZw?x-oss-process=image/format,png
[image 1]: http://images2017.cnblogs.com/blog/2625/201708/2625-20170827011640246-1728691070.png
[image 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMyMDE3LmNuYmxvZ3MuY29tL2Jsb2cvMjYyNS8yMDE3MDgvMjYyNS0yMDE3MDgyNzAxMTY0MTY4My0xMjUyODE5MzU2LnBuZw?x-oss-process=image/format,png
[image_image 2]: http://images2017.cnblogs.com/blog/2625/201708/2625-20170827011641402-630275537.png
[image 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMyMDE3LmNuYmxvZ3MuY29tL2Jsb2cvMjYyNS8yMDE3MDgvMjYyNS0yMDE3MDgyNzAxMTY0MjYwNS0xMTgxNjkxMzcxLnBuZw?x-oss-process=image/format,png
[image_image 3]: http://images2017.cnblogs.com/blog/2625/201708/2625-20170827011642293-539000747.png
[image 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMyMDE3LmNuYmxvZ3MuY29tL2Jsb2cvMjYyNS8yMDE3MDgvMjYyNS0yMDE3MDgyNzAxMTY0MzgwOC02MTgwNzk0MTMucG5n?x-oss-process=image/format,png
[image_image 4]: http://images2017.cnblogs.com/blog/2625/201708/2625-20170827011643293-1007730667.png
[image 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMyMDE3LmNuYmxvZ3MuY29tL2Jsb2cvMjYyNS8yMDE3MDgvMjYyNS0yMDE3MDgyNzAxMTY0NDgwOC0xODg2NDMwOTYzLnBuZw?x-oss-process=image/format,png
[image_image 5]: http://images2017.cnblogs.com/blog/2625/201708/2625-20170827011644449-1112093661.png