1相关文件说明

这一部分涉及相关配置文件的解析，

网络的启动涉及到多个文件，本文按以下顺序进行分析：

.

├── base

│   ├── docker-compose-base.yaml   #1

│   └── peer-base.yaml    #2

├── channel-artifacts

├── configtx.yaml      #5

├── crypto-config.yaml

├── docker-compose-cli.yaml   #3

├── docker-compose-couch.yaml  #4

├── docker-compose-e2e-template.yaml    该文件中定义了fabric-ca的配置信息。我们这里用不到，会在讲解Fabric-Ca的文章中说明

3.1 docker-compose-base.yaml文件详解

先看一下文件内容:

version: '2'     #docker版本

services:        #服务，可以包括若干个容器实例

  orderer.example.com:     #定义一个名称为orderer.example.com的服务

    container_name: orderer.example.com    #当前容器名称

    extends:     #扩展，代表需要加载的文件或服务

      file: peer-base.yaml

      service: orderer-base

    volumes:     #挂载的卷     [本机路径下的文件或目录]:[容器中所映射到的地址]

        #比如本机下的channel-artifacts/genesis.block文件可以在容器中/var/hyperledger/orderer/orderer.genesis.block访问

        - ../channel-artifacts/genesis.block:/var/hyperledger/orderer/orderer.genesis.block

        - ../crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/msp:/var/hyperledger/orderer/msp

        - ../crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/tls/:/var/hyperledger/orderer/tls

        - orderer.example.com:/var/hyperledger/production/orderer

    ports:  #所映射的端口  [本机端口]:[容器端口]

      - 7050:7050

  peer0.org1.example.com:        #定义一个名称为peer0.org1.example.com的服务

    container_name: peer0.org1.example.com    #当前容器名称

    extends:   #同上

      file: peer-base.yaml

      service: peer-base

    environment:         #定义环境变量

      - CORE_PEER_ID=peer0.org1.example.com    #peer节点的id

      - CORE_PEER_ADDRESS=peer0.org1.example.com:7051    #peer节点的访问地址

      - CORE_PEER_LISTENADDRESS=0.0.0.0:7051     #peer节点的监听地址

      - CORE_PEER_CHAINCODEADDRESS=peer0.org1.example.com:7052   #peer节点的链码访问地址

      - CORE_PEER_CHAINCODELISTENADDRESS=0.0.0.0:7052  #peer节点的链码监听地址 指定为0.0.0.0则自动进行探测

      - CORE_PEER_GOSSIP_BOOTSTRAP=peer1.org1.example.com:8051 #gossip为共识机制

      - CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer0.org1.example.com:7051  #gossip外部节点，表明为锚节点

      - CORE_PEER_LOCALMSPID=Org1MSP

    volumes:   #同上，挂载卷

        - /var/run/:/host/var/run/

        - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/msp:/etc/hyperledger/fabric/msp

        - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls:/etc/hyperledger/fabric/tls

        - peer0.org1.example.com:/var/hyperledger/production

    ports:   #同上，端口

      - 7051:7051

  peer1.org1.example.com:

    container_name: peer1.org1.example.com

    extends:

      file: peer-base.yaml

      service: peer-base

      ...

      ...

3.2 peer-base.yaml文件详解

version: '2'

services:

  peer-base:    #定义一个名称为peer-base的服务

    image: hyperledger/fabric-peer:$IMAGE_TAG    #该服务所依赖的镜像

    environment:       #定义环境变量

      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock

      - CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=${COMPOSE_PROJECT_NAME}_byfn     #定义网络工作模式,这里使用的是bridge方式

      - FABRIC_LOGGING_SPEC=INFO     #定义日志级别为INFO

      #- FABRIC_LOGGING_SPEC=DEBUG

      - CORE_PEER_TLS_ENABLED=true   #使用TLS

      - CORE_PEER_GOSSIP_USELEADERELECTION=true    #使用选举LEADER的方式

      - CORE_PEER_GOSSIP_ORGLEADER=false    #不指定LEADER

      - CORE_PEER_PROFILE_ENABLED=true     #使用profile

      - CORE_PEER_TLS_CERT_FILE=/etc/hyperledger/fabric/tls/server.crt   #TLS证书路径

      - CORE_PEER_TLS_KEY_FILE=/etc/hyperledger/fabric/tls/server.key  #TLS密钥路径

      - CORE_PEER_TLS_ROOTCERT_FILE=/etc/hyperledger/fabric/tls/ca.crt #TLS根证书路径

    working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer   #工作目录，即进入容器所在的默认位置

    command: peer node start   #启动容器后所运行的第一条命令：启动Peer节点 

  orderer-base:      #定义一个名称为orderer-base的服务

    image: hyperledger/fabric-orderer:$IMAGE_TAG    #该服务所依赖的镜像

    environment:    #环境变量

      - FABRIC_LOGGING_SPEC=INFO  #日志级别

      - ORDERER_GENERAL_LISTENADDRESS=0.0.0.0    #orderer的监听地址

      - ORDERER_GENERAL_GENESISMETHOD=file   # 创世区块文件的类型为file

      - ORDERER_GENERAL_GENESISFILE=/var/hyperledger/orderer/orderer.genesis.block   #创世区块在容器中的路径

      - ORDERER_GENERAL_LOCALMSPID=OrdererMSP   #Orderer的本地MSPid

      - ORDERER_GENERAL_LOCALMSPDIR=/var/hyperledger/orderer/msp  #本地Msp文件夹

      # enabled TLS

      - ORDERER_GENERAL_TLS_ENABLED=true   #使用TLS

      - ORDERER_GENERAL_TLS_PRIVATEKEY=/var/hyperledger/orderer/tls/server.key   #TLS私钥路径

      - ORDERER_GENERAL_TLS_CERTIFICATE=/var/hyperledger/orderer/tls/server.crt      #TLS证书路径

      - ORDERER_GENERAL_TLS_ROOTCAS=[/var/hyperledger/orderer/tls/ca.crt]      #TLS根证书路径

      - ORDERER_KAFKA_TOPIC_REPLICATIONFACTOR=1   #以下为kafka集群的配置，本文中没有使用到

      - ORDERER_KAFKA_VERBOSE=true

      - ORDERER_GENERAL_CLUSTER_CLIENTCERTIFICATE=/var/hyperledger/orderer/tls/server.crt

      - ORDERER_GENERAL_CLUSTER_CLIENTPRIVATEKEY=/var/hyperledger/orderer/tls/server.key

      - ORDERER_GENERAL_CLUSTER_ROOTCAS=[/var/hyperledger/orderer/tls/ca.crt]

    working_dir: /opt/gopath/src/github.com/hyperledger/fabric    #工作目录，即进入容器所在的默认位置

    command: orderer  #启动容器后所运行的第一条命令：启动orderer

3.3 docker-compose-cli.yaml文件详解

version: '2'

volumes:   #声明挂载的卷

  orderer.example.com:

  peer0.org1.example.com:

  peer1.org1.example.com:

  peer0.org2.example.com:

  peer1.org2.example.com:

networks:   #声明一个名称为byfn的网络

  byfn:

services:

  orderer.example.com:   #定义一个名称为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:     #环境变量

      - GOPATH=/opt/gopath        #指定go的路径

      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock

      #- FABRIC_LOGGING_SPEC=DEBUG

      - FABRIC_LOGGING_SPEC=INFO   #日志级别

      - CORE_PEER_ID=cli      #当前节点的Id

      - CORE_PEER_ADDRESS=peer0.org1.example.com:7051   #以下与peer-base.yaml相同，表示当前客户端容器默认与peer0.org1.example.com进行交互

      - 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    #TLS-peer0.org1.example.com的证书路径

      - 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  #TLS-peer0.org1.example.com的密钥路径

      - 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    #TLS-peer0.org1.example.com的根证书路径

      - CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp  @#TLS-组织1中Admin的MSP路径

    working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer      #工作目录，即进入容器所在的默认位置

    command: /bin/bash     #启动容器后所运行的第一条命令：使用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

3.4 docker-compose-couch.yaml文件详解

在fabric网络中，可以使用默认的levelDb数据库，或者使用CouchDb，该文件主要是对CouchDb进行相关设置。

version: '2'

networks:  #声明一个名称为byfn的网络

  byfn:

services:

  couchdb0:    #定义一个couchdb0的服务

    container_name: couchdb0    #指定该容器名称为couchdb0

    image: hyperledger/fabric-couchdb    #该容器所依赖的镜像

    environment:    #环境变量

      - COUCHDB_USER=        #couchdb0的用户名，这里设置为空,表明任何人都可登陆

      - COUCHDB_PASSWORD=     #couchdb0的登陆密码，这里设置为空

    ports:    #所映射的端口

      - "5984:5984"

    networks:    #使用的网络

      - byfn

  peer0.org1.example.com:    #定义一个peer0.org1.example.com的服务

    environment:

      - CORE_LEDGER_STATE_STATEDATABASE=CouchDB   #指定该服务使用的标准数据库为CouchDB

      - CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS=couchdb0:5984      #指定该服务使用的数据库访问地址

      - CORE_LEDGER_STATE_COUCHDBCONFIG_USERNAME= #配置数据库用户名

      - CORE_LEDGER_STATE_COUCHDBCONFIG_PASSWORD=#配置数据库密码

    depends_on:      #表明该服务依赖于couchdb0

      - couchdb0

  couchdb1:      #以下同上

    container_name: couchdb1

    image: hyperledger/fabric-couchdb

   ...

   ...

3.5 configtx.yaml文件详解

该文件中定义了fabric网络中的相关策略信息,内容相对比较多，这里只讲解所用到的部分。

Organizations:    #组织信息

    - &OrdererOrg   #配置orderer的信息

        Name: OrdererOrg    #定义名称

        ID: OrdererMSP        #定义ID

        MSPDir: crypto-config/ordererOrganizations/example.com/msp   #指定MSP的文件目录

        Policies:   #定义相关策略

            Readers:    #可读

                Type: Signature

                Rule: "OR('OrdererMSP.member')"   #具体策略：允许OrdererMSP中所有member读操作

            Writers:    #可写

                Type: Signature

                Rule: "OR('OrdererMSP.member')"

            Admins:    #admin

                Type: Signature

                Rule: "OR('OrdererMSP.admin')"

    - &Org1       #配置组织一的信息

        Name: Org1MSP    #定义组织一的名称

        ID: Org1MSP      #定义组织一的ID

        MSPDir: crypto-config/peerOrganizations/org1.example.com/msp  #指定MSP的文件目录

        Policies:    #定义相关策略

            Readers:    #可读

                Type: Signature

                Rule: "OR('Org1MSP.admin', 'Org1MSP.peer', 'Org1MSP.client')"  #Org1MSP中的admin，peer，client均可进行读操作

            Writers:  #可写

                Type: Signature

                Rule: "OR('Org1MSP.admin', 'Org1MSP.client')"    #Org1MSP中的admin，client均可进行读操作

            Admins:    #同上

                Type: Signature

                Rule: "OR('Org1MSP.admin')"

        AnchorPeers:    #指定Org1的锚节点，只有锚节点可以与另一个组织进行通信

            - Host: peer0.org1.example.com      #指定Org1的锚节点的地址

              Port: 7051      #指定Org1的锚节点的端口

    - &Org2      #同上

        Name: Org2MSP

        ID: Org2MSP

        MSPDir: crypto-config/peerOrganizations/org2.example.com/msp

        Policies:

            Readers:

                Type: Signature

                Rule: "OR('Org2MSP.admin', 'Org2MSP.peer', 'Org2MSP.client')"

            Writers:

                Type: Signature

                Rule: "OR('Org2MSP.admin', 'Org2MSP.client')"

            Admins:

                Type: Signature

                Rule: "OR('Org2MSP.admin')"

        AnchorPeers:

            - Host: peer0.org2.example.com

              Port: 9051

Capabilities:      #这一区域主要是定义版本的兼容情况

    Channel: &ChannelCapabilities

        V1_3: true

    Orderer: &OrdererCapabilities

        V1_1: true

    Application: &ApplicationCapabilities

        V1_3: true

        V1_2: false

        V1_1: false

Application: &ApplicationDefaults      #同上，定义具体的策略

    Organizations:

    Policies:

        Readers:

            Type: ImplicitMeta

            Rule: "ANY Readers"

        Writers:

            Type: ImplicitMeta

            Rule: "ANY Writers"

        Admins:

            Type: ImplicitMeta

            Rule: "MAJORITY Admins"

    Capabilities:

        <<: *ApplicationCapabilities

################################################################################

#

Orderer: &OrdererDefaults

    OrdererType: solo      #定义网络类型为solo

    Addresses:      #定义orderer的地址

        - orderer.example.com:7050

    BatchTimeout: 2s    #定义创建一个区块的超时时间

    BatchSize:

        MaxMessageCount: 10   #区块内最大消息数

        AbsoluteMaxBytes: 99 MB   #区块内消息所占的最大空间

        PreferredMaxBytes: 512 KB

    Organizations:

    Policies:

        Readers:

            Type: ImplicitMeta

            Rule: "ANY Readers"

        Writers:

            Type: ImplicitMeta

            Rule: "ANY Writers"

        Admins:

            Type: ImplicitMeta

            Rule: "MAJORITY Admins"

        BlockValidation:    #区块的验证策略

            Type: ImplicitMeta

            Rule: "ANY Writers"

################################################################################

Channel: &ChannelDefaults

    Policies:

        Readers:   #定义谁可以调用交付区块的API

            Type: ImplicitMeta

            Rule: "ANY Readers"

        Writers:   #定义谁可以调用广播区块的API

            Type: ImplicitMeta

            Rule: "ANY Writers"

        Admins:  #定义谁可以修改配置信息

            Type: ImplicitMeta

            Rule: "MAJORITY Admins"

    Capabilities:

        <<: *ChannelCapabilities

Profiles:

    TwoOrgsOrdererGenesis:

        <<: *ChannelDefaults

        Orderer:

            <<: *OrdererDefaults

            Organizations:

                - *OrdererOrg

            Capabilities:

                <<: *OrdererCapabilities

        Consortiums:

            SampleConsortium:

                Organizations:

                    - *Org1

                    - *Org2

    TwoOrgsChannel:

        Consortium: SampleConsortium

        <<: *ChannelDefaults

        Application:

            <<: *ApplicationDefaults

            Organizations:

                - *Org1

                - *Org2

            Capabilities:

                <<: *ApplicationCapabilities

Hyperledger Fabric相关文件解析的更多相关文章

  1. Hyperledger Fabric 账本结构解析

    前言 现在很多人都在从事区块链方面的研究,作者也一直在基于Hyperledger Fabric做一些开发工作.为了方便后来人更快的入门,本着“开源”的精神,在本文中向大家讲解一下Hyperledger ...

  2. Hyperledger Fabric源码解析

    Hyperledger Fabric开源于2015年12月,截至2018年2月初有185个公司/组织成员加入.最初由IBM和DAH的工程师贡献,现在约有70名的代码贡献者,4000+代码提交,代码行数 ...

  3. hyperledger fabric相关记录

    打开对接监控软件(statsd或者prometheus)开关 每个peer上 CORE_OPERATIONS_LISTENADDRESS=peer0.orgxxxxxxxxx:9443 CORE_ME ...

  4. Hyperledger Fabric 通道配置文件和容器环境变量详解

    摘要 Fabric 网络启动的过程中需要进行大量配置,新学时对各个配置的作用一无所知,这导致我曾在网络出问题时先对配置文件的内容进行排列组合后再祈祷它能在某个时刻顺利运行,因此掌握 fabric 各个 ...

  5. hyperledger fabric 1.0.5 分布式部署 （九）

    linux 使用vim.ctags 配置fabric 源码阅读环境 首先需要安装 ctags,作者使用apt-get 来安装的,安装的版本是5.9 apt-get install ctags 5.9 ...

  6. Hyperledger Fabric 1.0 从零开始（四）——Fabric源码及镜像文件处理

    2:Fabric源码及镜像文件处理 2.1下载Fabric源码 下载Fabric源码是因为要用到源码中提到的列子和工具,工具编译需要用到go语言环境,因此需要把源码目录放到$GOPATH下.通过1.3 ...

  7. Hyperledger Fabric 中channel配置相关数据结构

    channel Configuration Transaction Hyperledger Fabric区块链网络中的配置存储在一个configuration-transaction的集合中,每个ch ...

  8. Hyperledger Fabric 1.0 学习搭建 （二）--- 源码及镜像文件处理

    2.1下载Fabric源码下载Fabric源码是因为要用到源码中提到的列子和工具, 工具编译需要用到go语言环境, 因此需要把源码目录放到$GOPATH下. 通过1.3中go的安装配置, $GOPAT ...

  9. 深入解析Hyperledger Fabric启动的全过程

    在这篇文章中,使用fabric-samples/first-network中的文件进行fabric网络(solo类型的网络)启动全过程的解析.如有错误欢迎批评指正. 至于Fabric网络的搭建这里不再 ...

随机推荐

  1. SpringBoot电商项目实战 — ElasticSearch接入实现

    如今在一些中大型网站中,搜索引擎已是必不可少的内容了.首先我们看看搜索引擎到底是什么呢?搜索引擎,就是根据用户需求与一定算法,运用特定策略从互联网检索出制定信息反馈给用户的一门检索技术.搜索引擎依托于 ...

  2. PDF提取表格的网页工具——Excalibur

      在之前的文章另类爬虫:从PDF文件中爬取表格数据中,我们知道如何利用Python的camelot模块,通过写Python程序来提取PDF中的表格数据.本文我们将学习如何用更便捷的工具从PDF中提取 ...

  3. Python爬虫实战：爬取腾讯视频的评论

    前言 本文的文字及图片来源于网络,仅供学习.交流使用,不具有任何商业用途,版权归原作者所有,如有问题请及时联系我们以作处理. 作者: 易某某 PS:如有需要Python学习资料的小伙伴可以加点击下方链 ...

  4. iOS编译自动升级版本号脚本

    版权申明: 本文原创首发于以下网站,您可以自由转载,但必须加入完整的版权声明 博客园:https://www.cnblogs.com/MogooStudio/ csdn博客:https://blog. ...

  5. unittest---unittest多种加载用例方法

    在做自动化测试我们对执行用例很有要求,因为每条用例可能就和上一条数据有关系,那么我想要批量执行一些用例呢?这个怎么去操作呢?unittest自带的功能可以帮助到我们,我们可以通过不同的场景运用不同的执 ...

  6. IT兄弟连 HTML5教程 CSS3属性特效 2D变换2

    3  scale() 方法 通过scale() 方法,元素的尺寸会增加或减少,根据给定的宽度(X轴)和高度(Y轴)参数.缩放scale()函数让元素根据中心原点对对象进行缩放.默认值是1,因此0.01 ...

  7. Centos7启动防火墙时报错Failed to start IPv4 firewall with iptables

    今天在虚拟机的Linux系统(centos7)里安装Redis,准备学习一下布隆过滤器呢,安装完后使用Windows本机访问不了虚拟机里的Redis,telnet不通能够ping通.于是就去看防火墙, ...

  8. Ant Design 错误记录

    Ant Design 错误记录 一: 标签页Tabs 1:设置activeKey或defaultActiveKey,绑定默认值不起作用: =>    需要同时设置activeKey和defaul ...

  9. MySql数据库之数据库基础命令

    继续上篇博客所说到的,使用命令玩转MySql数据库. 在连接数据库时,我们需要确定数据库所在的服务器IP,用户名以及密码.当然,我们一般练习都会使用本地数据库,那么本地数据库的连接命令如下: mysq ...

  10. Get提交数据过大，tomcat报错，信息: Error parsing HTTP request header Note: further occurrences of HTTP header parsing errors will be logged at DEBUG level

    原因 get提交的数据过大,超过了默认值. 解决办法 get提交配置 设置tomcat的server.xml.找到我们启动的端口,一般是8080,增加maxHttpHeaderSize= " ...