Fabric之环境安装与网络启动流程

环境:
fabric v1.4.4
go version go1.13.5 darwin/amd64
node v12.10.0
npm v6.10.3
git version 2.17.2 (Apple Git-113)
Docker version 19.03.5, build 633a0ea
docker-compose version 1.24.1, build 4667896b

一、Hyperledger Fabric环境搭建

mkdir hyfa && cd hyfa
vim bootstrap.sh

把https://github.com/hyperledger/fabric/blob/v1.4.4/scripts/bootstrap.sh脚本内容copy到刚创建的bootstrap.sh文件里面去
然后执行

sh bootstrap.sh

这个脚本自动化的把所有的环境和文件编译都帮忙做了，执行完后也就是fabric环境安装完成，不过注意的是这个过程有点慢，需要vpn出去，也可以切换一下docker的镜像源。
这个脚本主要是做:

下载fabric-samples
下载相关的docker镜像文件
编译平台特定的二进制文件和配置文件安装到fabric-samples存储库的根目录中

脚本执行完后，执行docker images可以看到相关的镜像如下

REPOSITORY                     TAG                 IMAGE ID            CREATED             SIZE
hyperledger/fabric-javaenv     1.4.4               4648059d209e        5 weeks ago         1.7GB
hyperledger/fabric-javaenv     latest              4648059d209e        5 weeks ago         1.7GB
hyperledger/fabric-ca          1.4.4               62a60c5459ae        5 weeks ago         150MB
hyperledger/fabric-ca          latest              62a60c5459ae        5 weeks ago         150MB
hyperledger/fabric-tools       1.4.4               7552e1968c0b        5 weeks ago         1.49GB
hyperledger/fabric-tools       latest              7552e1968c0b        5 weeks ago         1.49GB
hyperledger/fabric-ccenv       1.4.4               ca4780293e4c        5 weeks ago         1.37GB
hyperledger/fabric-ccenv       latest              ca4780293e4c        5 weeks ago         1.37GB
hyperledger/fabric-orderer     1.4.4               dbc9f65443aa        5 weeks ago         120MB
hyperledger/fabric-orderer     latest              dbc9f65443aa        5 weeks ago         120MB
hyperledger/fabric-peer        1.4.4               9756aed98c6b        5 weeks ago         128MB
hyperledger/fabric-peer        latest              9756aed98c6b        5 weeks ago         128MB
hyperledger/fabric-zookeeper   0.4.18              ede9389347db        7 weeks ago         276MB
hyperledger/fabric-zookeeper   latest              ede9389347db        7 weeks ago         276MB
hyperledger/fabric-kafka       0.4.18              caaae0474ef2        7 weeks ago         270MB
hyperledger/fabric-kafka       latest              caaae0474ef2        7 weeks ago         270MB
hyperledger/fabric-couchdb     0.4.18              d369d4eaa0fd        7 weeks ago         261MB
hyperledger/fabric-couchdb     latest              d369d4eaa0fd        7 weeks ago         261MB

再进去fabric-samples/bin目录可以看到生成的执行文件:

configtxgen      cryptogen        fabric-ca-client orderer
configtxlator    discover         idemixgen        peer

如果看到以上结果，那就证明安装完成了

二、Hyperledger Fabric网络搭建

注意：下面涉及到的配置文件都可以在fabric-samples/first-network下找到
以下是操作可以明白整个网络的启动流程，如果想快速启动网络直接进去fabric-samples/first-network 执行sh byfn.sh -m up就搞定了

1、crypto-config.yaml配置文件

crypto-config.yaml 文件主要指定整个网络中相关组织的详细信息

# ---------------------------------------------------------------------------
# "OrdererOrgs" - Definition of organizations managing orderer nodes
# ---------------------------------------------------------------------------
OrdererOrgs:
  # ---------------------------------------------------------------------------
  # Orderer
  # ---------------------------------------------------------------------------
  - Name: Orderer               # Orderer组织的名称
    Domain: example.com         # 指定Orderer组织的域名
    EnableNodeOUs: true         # 指定是否生成config.yaml文件
    # ---------------------------------------------------------------------------
    # "Specs" - See PeerOrgs below for complete description
    # ---------------------------------------------------------------------------
    Specs:
      - Hostname: orderer       # Specs.Hostname属性值+Domain属性值构成了Orderer组织的完整域名。
      - Hostname: orderer2
      - Hostname: orderer3
      - Hostname: orderer4
      - Hostname: orderer5

# ---------------------------------------------------------------------------
# "PeerOrgs" - Definition of organizations managing peer nodes
# ---------------------------------------------------------------------------
PeerOrgs:
  # ---------------------------------------------------------------------------
  # Org1
  # ---------------------------------------------------------------------------
  - Name: Org1
    Domain: org1.example.com
    EnableNodeOUs: true
    Template:
      Count: 2
    Users:
      Count: 1
  # ---------------------------------------------------------------------------
  # Org2: See "Org1" for full specification
  # ---------------------------------------------------------------------------
  - Name: Org2
    Domain: org2.example.com
    EnableNodeOUs: true
    Template:
      Count: 2
    Users:
      Count: 1

该配置文件指定了OrdererOrgs及PeerOrgs两个组织信息。PeerOrgs配置信息指定创建了Org1与Org2两个组织。每个Org组织使用Template属性下的Count指定创建了两个Peer节点，Users属性下的Count指定了在各个Peer节点中创建一个用户。
Peer节点的域名名称组成结构为“peer+起始数字0+Domain属性的值”。例如，Org1组织中的Domain属性值为org1.example.com，Template.Count属性值为2，则两个Peer节点的完整域名为peer0.org1.example.com和peer1.org1.example.com。

2、生成组织结构与身份证书

Hyperledger Fabric提供一个工具cryptogen可以生成组织结构和身份证书信息

# 执行命令
cryptogen generate --config=./crypto-config.yaml

# 输出
org1.example.com
org2.example.com

证书和密钥（即MSP材料）将被输出到当前路径下的一个名为crypto-config的目录中，该目录下会根据crypto-config.yaml配置文件中指定的结构产生两个子目录.
·ordererOrganizations子目录下包括构成Orderer组织（1个Orderer节点）的身份信息。
·peerOrganizations子目录下为所有的Peer节点组织（2个Org组织，每个Org组织包含2个Peer节点）的相关身份信息。其中最关键的是MSP目录，代表了实体的身份信息。

3、configtx.yaml配置文件

生成组织结构与身份证书、密钥之后，需要为区块链创建一个GenesisBlock（初始区块或称之为创世区块）与Channel（通道），这些内容需要通过配置定义来指定相关的信息，如指定Orderer服务的相关配置，以及当前的联盟信息、联盟中所包含的组织信息，这些信息的配置被定义在configtx.yaml文件中。核心配置内容如下。

Organizations部分指定OrdererOrg与PeerOrg的组织信息，其核心目的是指定各组织的名称、唯一ID及MSP的目录所在路径。
Capabilities部分指定通道的权限信息。
Application部分指定初始加入通道的组织。
Orderer部分指定Orderer节点的信息。
具体文件可参考:
https://github.com/hyperledger/fabric-samples/blob/v1.4.4/first-network/configtx.yaml

4、Order服务创建创世区块文件

指定使用configtx.yaml文件中定义的TwoOrgsOrdererGenesis模板，生成Orderer服务系统通道的初始区块文件

export SYS_CHANNEL= byfn-sys-channel

configtxgen -profile TwoOrgsOrdererGenesis -channelID $SYS_CHANNEL -outputBlock ./channel-artifacts/genesis.block

3、创建应用通道交易配置文件

指定使用configtx.yaml配置文件中的TwoOrgsChannel模板来生成新建通道的配置交易文件（TwoOrgsChannel模板指定的Org1和Org2两个组织都属于应用通道中的成员）

export CHANNEL_NAME=mychannel

configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME

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

同样基于configtx.yaml配置文件的TwoOrgsChannel模板，为每个组织分别生成锚节点更新配置，且注意指定对应的组织名称。

export CHANNEL_NAME=mychannel

configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP

configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

5、docker-compose-cli.yaml配置文件

# Copyright IBM Corp. All Rights Reserved.
#
# SPDX-License-Identifier: Apache-2.0
#

version: '2'

volumes:
  orderer.example.com:
  peer0.org1.example.com:
  peer1.org1.example.com:
  peer0.org2.example.com:
  peer1.org2.example.com:

networks:
  byfn:

services:

  orderer.example.com:
    extends:
      file:   base/docker-compose-base.yaml
      service: orderer.example.com
    container_name: orderer.example.com
    networks:
      - byfn

  peer0.org1.example.com:
    container_name: peer0.org1.example.com
    extends:
      file:  base/docker-compose-base.yaml
      service: peer0.org1.example.com
    networks:
      - byfn

  peer1.org1.example.com:
    container_name: peer1.org1.example.com
    extends:
      file:  base/docker-compose-base.yaml
      service: peer1.org1.example.com
    networks:
      - byfn

  peer0.org2.example.com:
    container_name: peer0.org2.example.com
    extends:
      file:  base/docker-compose-base.yaml
      service: peer0.org2.example.com
    networks:
      - byfn

  peer1.org2.example.com:
    container_name: peer1.org2.example.com
    extends:
      file:  base/docker-compose-base.yaml
      service: peer1.org2.example.com
    networks:
      - byfn

  cli:
    container_name: cli
    image: hyperledger/fabric-tools:$IMAGE_TAG
    tty: true
    stdin_open: true
    environment:
      - SYS_CHANNEL=$SYS_CHANNEL
      - GOPATH=/opt/gopath
      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
      #- FABRIC_LOGGING_SPEC=DEBUG
      - FABRIC_LOGGING_SPEC=INFO
      - CORE_PEER_ID=cli
      - CORE_PEER_ADDRESS=peer0.org1.example.com:7051
      - CORE_PEER_LOCALMSPID=Org1MSP
      - CORE_PEER_TLS_ENABLED=true
      - CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.crt
      - CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/server.key
      - CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
      - CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
    working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
    command: /bin/bash
    volumes:
        - /var/run/:/host/var/run/
        - ./../chaincode/:/opt/gopath/src/github.com/chaincode
        - ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/
        - ./scripts:/opt/gopath/src/github.com/hyperledger/fabric/peer/scripts/
        - ./channel-artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts
    depends_on:
      - orderer.example.com
      - peer0.org1.example.com
      - peer1.org1.example.com
      - peer0.org2.example.com
      - peer1.org2.example.com
    networks:
      - byfn

由以上配置信息可以看出，该配置文件指定了网络中各个节点容器（共计6个容器，即1个Orderer、属于2个Orgs组织的4个Peer、1个CLI）的信息。仔细观察会发现，Orderer与各Peer容器都设置了container_name与networks信息；其他信息都由extends指向了base/docker-compose-base.yaml文件。
CLI容器指定了所代表的Peer节点（CORE_PEER_ADDRESS=peer0.org1.example.com：7051），通过volumes指定了将系统中的链码、组织结构及证书、生成的配置文件映射到容器中指定的目录下，且通过depends_on属性指定了所依赖的相关容器。
关联配置文件:
docker-compose-base.yaml
peer-base.yaml

6启动网络

docker-compose -f docker-compose-cli.yaml up -d

-f 指定启动容器时所使用的docker-compose配置文件
-d 指定是否显示网络启动过程中的实时日志信息，如果需要查看详细网络启动日志

启动成功后执行docker ps可以查看有6个容器在跑。
如果要关闭网络可以执行docker-compose -f docker-compose-cli.yaml down

5、创建应用通道

执行

docker exec -it cli bash

进入cli容器
创建环境变量:

export CHANNEL_NAME=mychannel

peer channel create -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/channel.tx --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

6、将节点加入应用通道

peer channel join -b mychannel.block

7、更新锚节点

使用Org1的管理员身份更新锚节点配置:

peer channel update -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/Org1MSPanchors.tx --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

使用Org2的管理员身份更新锚节点配置

peer channel update -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/Org2MSPanchors.tx --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

8、byfn.sh启动流程图

byfn.sh启动流程图

git地址

参考:
<<Hyperledger Fabric菜鸟进阶攻略>> 第一章、第三章
Hyperledger Fabric1.4安装
 Hyperledger中文文档
 Hyperledger Fabric工具cryptogen介绍

最后编辑于：2020.03.10 16:13:20

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 200,176评论 5赞 469
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 84,190评论 2赞 377
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 147,232评论 0赞 332
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 53,953评论 1赞 272
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 62,879评论 5赞 360
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,177评论 1赞 277
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,626评论 3赞 390
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,295评论 0赞 254
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,436评论 1赞 294
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,365评论 2赞 317
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,414评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,096评论 3赞 315
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,685评论 3赞 303
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,771评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 30,987评论 1赞 255
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,438评论 2赞 346
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,032评论 2赞 341