Hyperledger-fabric是区块链中联盟链的优秀实现,所以从今天开始也想学习下fabric，顺便用一个系列将我学习的点滴记录下来。

准备环境

注：本fabric实战系列基于MacOS。

1.git

brew install git

2.curl

下载安装最新版本的curl，macOS 本身已经安装了curl

3.Docker

下载Docker-CE for Mac,安装好后可以确认Docker和Docker Compose的版本:

➜  go docker --version
Docker version 18.03.1-ce, build 9ee9f40
➜  go docker-compose --version
docker-compose version 1.21.1, build 5a3f1a3

4.go

brew安装go开发包，或者前往官网下载安装包

brew install go

并在./bash_profile配置go环境变量：

// go安装路径
export GOROOT=/usr/local/go
// go工作路径
export GOPATH=/Users/chaors/go
export GOBIN=$GOPATH/bin

建立fabric源码路径

// 进入go工作目录创建hyperledger牡蛎
cd $GOPATH
mkdir -p src/github.com/hyperledger
// 进入该目录，拉取fabric源代码
cd $GOPATH/src/github.com/hyperledger
git clone https://github.com/hyperledger/fabric.git

5.Node & npm

// 安装node
brew install node
// 查看node版本
➜  go node -v
v8.11.1
// 查看npm版本
➜  go npm -v
5.6.0

fabric Sample

上面我们就已经安装了fabric需要的一些依赖环境，并将fabric拉取到了本地，进入fabric项目：

查看fabric版本，选择稳定版本1.2.0

➜  go cd src/github.com/hyperledger/fabric
➜  fabric git:(cae2ad445) ✗ git tag
baseimage-v0.0.11
v0.6.0-preview
v0.6.1-preview
v1.0.0
v1.0.0-alpha
v1.0.0-alpha2
v1.0.0-beta
v1.0.0-rc1
v1.0.1
v1.0.2
v1.0.3
v1.0.4
v1.0.5
v1.0.6
v1.1.0
v1.1.0-alpha
v1.1.0-preview
v1.1.0-rc1
v1.1.1
v1.2.0
v1.2.0-rc1

➜  fabric git:(cae2ad445) ✗ git checkout v1.2.0
M   examples/e2e_cli/docker-compose-e2e.yaml
M   examples/e2e_cli/download-dockerimages.sh
HEAD is now at cae2ad445 Merge "Prepare release-1.2 branch for release" into release-1.2
➜  fabric git:(cae2ad445) ✗ git branch
* (HEAD detached at v1.2.0)
  release-1.2

我们新建一个目录，用于子存放下载的fabric Sample。

// 新建fabric_Sample目录
➜  mkdir fabric_Sample
➜  cd fabric_Sample
➜  ls
// 拷贝fabric/scripts下的bootstrap.sh脚本
➜  cp ../fabric/scripts/bootstrap.sh bootstrap.sh
// 赋予脚本拷贝的可执行属性
➜  chmod +x bootstrap.sh

在执行脚本前，为了使下载过程更快，我们需要配置下Docker加速器，我们可以利用DaoClound平台来获取Docker加速器。

首先，打开网址注册一个账号，然后登录选择加速器：

Docker加速器_0.png Docker加速器_1.png

按上图方式重启Docker服务后执行脚本：

// 执行脚本
➜  sudo ./bootstrap.sh

成功执行后，会列出所有安装的镜像：

bootstrap.sh执行成功.png

最后一步，添加环境变量：

export PATH=$Home/go/src/github.com/hyperledger/fabric_Sample/fabric-samples/bin:$PATH

fabric-samples目录分析

目录	作用
chaincode	fabric示例链码目录
chaincode-docker-devmode	链码开发测试模式 测试模式下链码存放目录
config	关于orderer和peer配置信息
config/configtx.yaml	初始区块及应用通道交易配置文件的参考
config/core.yaml	peer配置信息的参考
config/ orderer.yaml	orderer配置信息的参考
fabcar	测试Node环境所在目录，有一个小汽车的测试用例
fabric-ca	fabric基础环境提供的一个简单ca
first-network	与网络相关的所有内容

fabric三大核心工具

1.根据指定的配置文件生成组织结构及身份证书的工具。

fabric-samples/bin/cryptogen

2.配置交易的一个工具，主要生成三种配置文件：
1)生成orderer初始区块
2)生成应用通道交易配置文件
3)锚节点更新配置文件

fabric-samples/bin/cryptogen/configtxgen

3.在正在运行的网络联盟链中添加一个新的组织

fabric-samples/bin/cryptogen/configtxlator

网络环境的启动

自动化脚本byfn.sh

fabric提供了一个脚本来自动初始化并启动网络

// 查看脚本命令使用方法
./byfn.sh --help

// 1.生成相应的组织结构和身份证书,orderer初始区块配置文件，应用通道交易配置文件，锚节点更新配置文件
./byfn.sh generate

// 2.启动网络
./byfn.sh up

// 2.关闭网络
./byfn.sh down

手动启动网络

1.生成相应的组织结构和身份证书

我们知道可以借助cryptogen工具来生成相应的组织结构和身份证书。

// 显示默认的配置文件模板
../bin/cryptogen showtemplate

我们查看默认的配置文件模板，主要内容有：

// Orderer组织节点的定义
OrdererOrgs:
  - Name: Orderer
    Domain: example.com
    Specs:
      - Hostname: orderer
// 对等组织节点的定义 
PeerOrgs:
 // 组织1
  - Name: Org1
    Domain: org1.example.com
    EnableNodeOUs: false
    Template:
       // 节点数
      Count: 1
    Users:
      // 用户数
      Count: 1
   // 组织2
  - Name: Org2
    Domain: org2.example.com
    EnableNodeOUs: false
    Template:
      Count: 1
    Users:
      Count: 1

我们需要修改该配置文件，来自定义实现我们的组织结构。由于网络是在first-network目录下启动网络的，我们发现该目录下的crypto-config.yaml内容和上面默认配置文件相同。因此，我们可以通过修改并指定该文件为配置文件来实现目的。

假设我们在默认基础上新增两个组织：组织3和组织4，其组织结构与组织2相同

// 编辑配置文件
vi vi crypto-config.yaml

// i
// 末尾添加
- Name: Org3
    Domain: org3.example.com
    EnableNodeOUs: false
    Template:
      Count: 1
    Users:
      Count: 1
- Name: Org4
    Domain: org4.example.com
    EnableNodeOUs: false
    Template:
      Count: 1
    Users:
      Count: 1
// esc,:,wq! 

然后指定该文件为配置文件生成组织结构。

➜  first-network git:(1745c99) ✗ ../bin/cryptogen generate --config crypto-config.yaml
org1.example.com
org2.example.com
org3.example.com
org4.example.com

这里，特别注意在编辑crypto-config.yaml文件时一定不要使用tab键缩进，必须用空格键。否则会报错：

➜  first-network git:(1745c99) ✗ ../bin/cryptogen generate --config crypto-config.yaml
Error reading config: Error Unmarshaling YAML: yaml: line 95: found a tab character that violates indentation%

2.生成orserer创世区块

使用configtxgen工具,同样使用--help命令查看工具使用方法。

../bin/configtxgen --help

-chanelID 指定的通道ID(必须指定)
-profile (TwoOrgsOrdererGenesis)configtx.yaml配置文件profiles
-outputBlock 输出的区块地址，一般在channel-artifacts目录下

完整的命令：

// 生成创世区块
../bin/configtxgen -profile TwoOrgsOrdererGenesis -channelID mychannel -outputBlock ./channel-artifacts/genesis.block

// 查看发现生成成功
➜  first-network git:(1745c99) ✗ ll ./channel-artifacts
total 32
-rw-r--r--  1 chaors  staff    12K  7 24 23:50 genesis.block

3.生成应用通道配置文件

依旧使用configtxgen工具。

// 生成应用通道配置文件
../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychanne

// 查看生成的文件
➜  first-network git:(1745c99) ✗ ll ./channel-artifacts
total 40
-rw-r--r--  1 chaors  staff   346B  7 25 00:05 channel.tx
-rw-r--r--  1 chaors  staff    12K  7 24 23:50 genesis.block

4.生成锚节点更新配置文件

../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/org1MSPanchors.tx -channelID mychannel

➜  first-network git:(1745c99) ✗ ll ./channel-artifacts
total 48
-rw-r--r--  1 chaors  staff   346B  7 25 00:05 channel.tx
-rw-r--r--  1 chaors  staff    12K  7 24 23:50 genesis.block
-rw-r--r--  1 chaors  staff   284B  7 25 00:12 org1MSPanchors.tx

5.启动网络

这里需要使用docker-compose工具。

// -f:启动网络时的配置文件，它描述了应该有哪些容器被启动
// -d:不显示详细的启动过程
// up:启动网络
docker-compose -f docker-compose-cli.yaml up -d

// 关闭网络
docker-compose -f docker-compose-cli.yaml down

.
.
.
.

互联网颠覆世界，区块链颠覆互联网!

---------------------------------------------20180725 20:21