链客,专为开发者而生,有问必答!
此文章来自区块链技术社区,未经允许拒绝转载。
一、编译
1、环境准备
需要提前在linux或者mac机器上安装如下软件
1)Go,注意设置好gopath(笔者安装的是go1.8.3,对应的源码是v1.0.0这个tag,版本不对可能会出现编译不过或者运行出现问题)
2)Docker
3)一些依赖包(笔者当时没有装特殊的依赖包,所以这里不写了)
2、源码下载
首先先创建源码目录(注意这里必须是gopath下的这个目录,否则编译不过)
$ mkdir -p $GOPATH/src/github.com/hyperledger
$ cd $GOPATH/src/github.com/hyperledger
然后在该目录下复制仓库
$ git clone http://gerrit.hyperledger.org/r/fabric
笔者用的是v1.0.0的tag所以还需要
$ git checkout v1.0.0
3、编译
在源码目录中make
不过这样要求比较高,耗时比较长,会从网上下载一些docker镜像等等,读者如果嫌费时间或者由于网络原因搞不定,可以一个一个make
比如make native是编译一些bin比如order,peer等
而make order和make peer是编译两个关键程序
由于编译不是本文的重点所以简单提一下,如果有疑问欢迎给笔者留言交流
二、运行
自己配置联盟比较麻烦,比较建议是下载一个开源项目使用docker运行,以下是简单的方式
1、环境要求:
安装docker-compose
2、下载开源项目
$ git clone https://github.com/yeasy/docker-compose-files
$ cd docker-compose-files/hyperledger_fabric/v1.0.0
3、下载镜像
$ sudo bash scripts/ download_images.sh
4、启动
$ make start
后面的具体方式可以看Makefile,有运行、停止、初始化、测试链码等命令
三、架构
联盟链的概念比较多,从比特币转过来的同学可能刚开始会晕(因为我当时研究的时候看各种文章就很晕),所以我这里尽量把我的理解路径写出来
1、主程序
联盟链真正运行时只有两个主程序
1)peer,这个程序是参与实体的运行终端,也是命令行的终端(客户端),可以理解为比特币中的主程序。
2)order,一个排序服务,类比到比特币,暂时简单理解为主程序中的挖矿部分,因为联盟链把这部分功能单独隔离了出来。随着代码的深入了解,可以发掘其其他功能。
2、讲解模型
其中order服务是一个单独的服务,可以理解为一个专门各个组织公认的权威服务器(也可以是服务集群),主要用来对交易进行排序,然后生成区块(挖矿)
Org代表组织,讲解的模型中有两个组织,org1和org2,可以对应的是清华大学和北京大学
而peer一般代表的是组织内的子部门,比如org1.peer1代表清华大学的计算机学院,org2.peer2代表北京大学的计算机学院。
3、启动命令行
对应上图中的讲解模型每一个节点中的运行的命令行如下
1)order服务:order start
2)org1.peer1 : peer node start
3)org2.peer1 : peer node start
4)org1.peer2:peer node start
5)org2.peer2:peer node start
这里除了order运行是order start以外其他的全部是peer node start,那怎么区分他们的功能呢?
答案是通过msp和tls两个目录(这个后续再继续讲)
在各个节点运行过后,网络是这样的
也就是网络其实还没有互联起来
4、网络互联
要完成网络需要三步
1)创建通道
创建通道,可以单独在一个机器上运行
peer channel create \
-o orderer.example.com:7050 \
-c testchannel\
-f ./ testchannel.tx
ps:为了简单,这里省略了一些证书信息的配置(后文会讲解)
其中当前需要理解的参数是-o orderer.example.com:7050 代表了order的url,-c testchannel代表了通道的名字
这个命令其实就是通过连接到orderer.example.com:7050服务上,让服务器增加了一个通道的配置(配置文件是testchannel.tx),这个配置中包括了一些信息,比如证书信息,机构信息,以及一些权限设置等等。然后order会返回一个testchannel.block的文件(也是一些配置信息),加入通道时候会用到。
这一步并没有构建网络,网络模型依然如下
只是order服务中多了一个叫testchannel的通道
2)加入通道
命令为
CORE_PEER_ADDRESS=peer1.org1.example.com:7051 \
peer channel join \
-b testchannel.block
ps:这里省略了msp配置的信息
主要参数列出来
1、CORE_PEER_ADDRESS表明要加入通道的地址(因为实际操作时候是用的cli在另外的机器上操作要加入通道的peer)
2、testchannel.block 创建通道时候的返回文件
该命令执行完以后,网络模型变成了
可以看到org1的peer1和order连接陈功了,依次执行
CORE_PEER_ADDRESS=peer2.org1.example.com:7051 \
peer channel join \
-b testchannel.block
CORE_PEER_ADDRESS=peer1.org2.example.com:7051 \
peer channel join \
-b testchannel.block
CORE_PEER_ADDRESS=peer2.org2.example.com:7051 \
peer channel join \
-b testchannel.block
最后网络模型变成了
3)设置锚节点
各个节点都加入网络后,细心的读者可能会发现,和我们要达到的网络模型还少了几条线,也就是各个节点的互通线没有连接。而这个的完成需要gossip协议,而gossip协议是一个节点相互发现的协议,其中有一项就是需要一些锚点,fabric中一般每一个组织一到多个锚点。这个概念在讲解gossip协议的时候会进一步说明,在这里就只需要知道锚点的设置是为了网络互通就可以了,实在要理解,暂时理解为p2p协议中的初始域名服务器。命令如下:
peer channel update \
-o orderer.example.com:7050 \
-c testchannel \
-f ./Org1MSPanchors.tx
其中-c代表了通道名称,-f表示了锚点信息(里边会包含锚点的url比如peer1)-o指定了order节点。
在org1和org2中中分别生成锚点配置文件,然后执行以上命令就能把锚点信息更新到通道的配置中,这样各个节点就可以通过从order中更新配置,知道锚点,然后通过gossip协议进行全网互联,互联后网络模型如下