经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » 其他 » 区块链 » 查看文章
Hyperledger Fabric相关文件解析
来源:cnblogs  作者:触不可及`  时间:2019/7/9 9:23:09  对本文有异议

1相关文件说明

这一部分涉及相关配置文件的解析,
网络的启动涉及到多个文件,本文按以下顺序进行分析:

  1. .
  2. ├── base
  3. │?? ├── docker-compose-base.yaml #1
  4. │?? └── peer-base.yaml #2
  5. ├── channel-artifacts
  6. ├── configtx.yaml #5
  7. ├── crypto-config.yaml
  8. ├── docker-compose-cli.yaml #3
  9. ├── docker-compose-couch.yaml #4
  10. ├── docker-compose-e2e-template.yaml 该文件中定义了fabric-ca的配置信息。我们这里用不到,会在讲解Fabric-Ca的文章中说明

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

先看一下文件内容:

  1. version: '2' #docker版本
  2. services: #服务,可以包括若干个容器实例
  3. orderer.example.com: #定义一个名称为orderer.example.com的服务
  4. container_name: orderer.example.com #当前容器名称
  5. extends: #扩展,代表需要加载的文件或服务
  6. file: peer-base.yaml
  7. service: orderer-base
  8. volumes: #挂载的卷 [本机路径下的文件或目录]:[容器中所映射到的地址]
  9. #比如本机下的channel-artifacts/genesis.block文件可以在容器中/var/hyperledger/orderer/orderer.genesis.block访问
  10. - ../channel-artifacts/genesis.block:/var/hyperledger/orderer/orderer.genesis.block
  11. - ../crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/msp:/var/hyperledger/orderer/msp
  12. - ../crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/tls/:/var/hyperledger/orderer/tls
  13. - orderer.example.com:/var/hyperledger/production/orderer
  14. ports: #所映射的端口 [本机端口]:[容器端口]
  15. - 7050:7050
  16. peer0.org1.example.com: #定义一个名称为peer0.org1.example.com的服务
  17. container_name: peer0.org1.example.com #当前容器名称
  18. extends: #同上
  19. file: peer-base.yaml
  20. service: peer-base
  21. environment: #定义环境变量
  22. - CORE_PEER_ID=peer0.org1.example.com #peer节点的id
  23. - CORE_PEER_ADDRESS=peer0.org1.example.com:7051 #peer节点的访问地址
  24. - CORE_PEER_LISTENADDRESS=0.0.0.0:7051 #peer节点的监听地址
  25. - CORE_PEER_CHAINCODEADDRESS=peer0.org1.example.com:7052 #peer节点的链码访问地址
  26. - CORE_PEER_CHAINCODELISTENADDRESS=0.0.0.0:7052 #peer节点的链码监听地址 指定为0.0.0.0则自动进行探测
  27. - CORE_PEER_GOSSIP_BOOTSTRAP=peer1.org1.example.com:8051 #gossip为共识机制
  28. - CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer0.org1.example.com:7051 #gossip外部节点,表明为锚节点
  29. - CORE_PEER_LOCALMSPID=Org1MSP
  30. volumes: #同上,挂载卷
  31. - /var/run/:/host/var/run/
  32. - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/msp:/etc/hyperledger/fabric/msp
  33. - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls:/etc/hyperledger/fabric/tls
  34. - peer0.org1.example.com:/var/hyperledger/production
  35. ports: #同上,端口
  36. - 7051:7051
  37. peer1.org1.example.com:
  38. container_name: peer1.org1.example.com
  39. extends:
  40. file: peer-base.yaml
  41. service: peer-base
  42. ...
  43. ...

3.2 peer-base.yaml文件详解

  1. version: '2'
  2. services:
  3. peer-base: #定义一个名称为peer-base的服务
  4. image: hyperledger/fabric-peer:$IMAGE_TAG #该服务所依赖的镜像
  5. environment: #定义环境变量
  6. - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
  7. - CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=${COMPOSE_PROJECT_NAME}_byfn #定义网络工作模式,这里使用的是bridge方式
  8. - FABRIC_LOGGING_SPEC=INFO #定义日志级别为INFO
  9. #- FABRIC_LOGGING_SPEC=DEBUG
  10. - CORE_PEER_TLS_ENABLED=true #使用TLS
  11. - CORE_PEER_GOSSIP_USELEADERELECTION=true #使用选举LEADER的方式
  12. - CORE_PEER_GOSSIP_ORGLEADER=false #不指定LEADER
  13. - CORE_PEER_PROFILE_ENABLED=true #使用profile
  14. - CORE_PEER_TLS_CERT_FILE=/etc/hyperledger/fabric/tls/server.crt #TLS证书路径
  15. - CORE_PEER_TLS_KEY_FILE=/etc/hyperledger/fabric/tls/server.key #TLS密钥路径
  16. - CORE_PEER_TLS_ROOTCERT_FILE=/etc/hyperledger/fabric/tls/ca.crt #TLS根证书路径
  17. working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer #工作目录,即进入容器所在的默认位置
  18. command: peer node start #启动容器后所运行的第一条命令:启动Peer节点
  19. orderer-base: #定义一个名称为orderer-base的服务
  20. image: hyperledger/fabric-orderer:$IMAGE_TAG #该服务所依赖的镜像
  21. environment: #环境变量
  22. - FABRIC_LOGGING_SPEC=INFO #日志级别
  23. - ORDERER_GENERAL_LISTENADDRESS=0.0.0.0 #orderer的监听地址
  24. - ORDERER_GENERAL_GENESISMETHOD=file # 创世区块文件的类型为file
  25. - ORDERER_GENERAL_GENESISFILE=/var/hyperledger/orderer/orderer.genesis.block #创世区块在容器中的路径
  26. - ORDERER_GENERAL_LOCALMSPID=OrdererMSP #Orderer的本地MSPid
  27. - ORDERER_GENERAL_LOCALMSPDIR=/var/hyperledger/orderer/msp #本地Msp文件夹
  28. # enabled TLS
  29. - ORDERER_GENERAL_TLS_ENABLED=true #使用TLS
  30. - ORDERER_GENERAL_TLS_PRIVATEKEY=/var/hyperledger/orderer/tls/server.key #TLS私钥路径
  31. - ORDERER_GENERAL_TLS_CERTIFICATE=/var/hyperledger/orderer/tls/server.crt #TLS证书路径
  32. - ORDERER_GENERAL_TLS_ROOTCAS=[/var/hyperledger/orderer/tls/ca.crt] #TLS根证书路径
  33. - ORDERER_KAFKA_TOPIC_REPLICATIONFACTOR=1 #以下为kafka集群的配置,本文中没有使用到
  34. - ORDERER_KAFKA_VERBOSE=true
  35. - ORDERER_GENERAL_CLUSTER_CLIENTCERTIFICATE=/var/hyperledger/orderer/tls/server.crt
  36. - ORDERER_GENERAL_CLUSTER_CLIENTPRIVATEKEY=/var/hyperledger/orderer/tls/server.key
  37. - ORDERER_GENERAL_CLUSTER_ROOTCAS=[/var/hyperledger/orderer/tls/ca.crt]
  38. working_dir: /opt/gopath/src/github.com/hyperledger/fabric #工作目录,即进入容器所在的默认位置
  39. command: orderer #启动容器后所运行的第一条命令:启动orderer

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

  1. version: '2'
  2. volumes: #声明挂载的卷
  3. orderer.example.com:
  4. peer0.org1.example.com:
  5. peer1.org1.example.com:
  6. peer0.org2.example.com:
  7. peer1.org2.example.com:
  8. networks: #声明一个名称为byfn的网络
  9. byfn:
  10. services:
  11. orderer.example.com: #定义一个名称为orderer.example.com的服务
  12. extends: #扩展,代表需要加载的文件或服务 即使用了其中的配置信息
  13. file: base/docker-compose-base.yaml
  14. service: orderer.example.com
  15. container_name: orderer.example.com #当前容器名称
  16. networks: #指定当前容器所加入的网络,如果需要加入多个网络,可以定义多个
  17. - byfn
  18. #以下同上
  19. peer0.org1.example.com:
  20. container_name: peer0.org1.example.com
  21. extends:
  22. file: base/docker-compose-base.yaml
  23. service: peer0.org1.example.com
  24. networks:
  25. - byfn
  26. peer1.org1.example.com:
  27. container_name: peer1.org1.example.com
  28. extends:
  29. file: base/docker-compose-base.yaml
  30. service: peer1.org1.example.com
  31. networks:
  32. - byfn
  33. peer0.org2.example.com:
  34. container_name: peer0.org2.example.com
  35. extends:
  36. file: base/docker-compose-base.yaml
  37. service: peer0.org2.example.com
  38. networks:
  39. - byfn
  40. peer1.org2.example.com:
  41. container_name: peer1.org2.example.com
  42. extends:
  43. file: base/docker-compose-base.yaml
  44. service: peer1.org2.example.com
  45. networks:
  46. - byfn
  47. cli: #定义一个客户端容器,方便与各节点进行交互
  48. container_name: cli #客户端容器名称
  49. image: hyperledger/fabric-tools:$IMAGE_TAG #该服务所依赖的镜像
  50. tty: true #使用伪终端
  51. stdin_open: true #标准输入
  52. environment: #环境变量
  53. - GOPATH=/opt/gopath #指定go的路径
  54. - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
  55. #- FABRIC_LOGGING_SPEC=DEBUG
  56. - FABRIC_LOGGING_SPEC=INFO #日志级别
  57. - CORE_PEER_ID=cli #当前节点的Id
  58. - CORE_PEER_ADDRESS=peer0.org1.example.com:7051 #以下与peer-base.yaml相同,表示当前客户端容器默认与peer0.org1.example.com进行交互
  59. - CORE_PEER_LOCALMSPID=Org1MSP
  60. - CORE_PEER_TLS_ENABLED=true
  61. - 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的证书路径
  62. - 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的密钥路径
  63. - 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的根证书路径
  64. - CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp @#TLS-组织1AdminMSP路径
  65. working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer #工作目录,即进入容器所在的默认位置
  66. command: /bin/bash #启动容器后所运行的第一条命令:使用bash
  67. volumes: #挂载卷
  68. - /var/run/:/host/var/run/
  69. - ./../chaincode/:/opt/gopath/src/github.com/chaincode
  70. - ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/
  71. - ./scripts:/opt/gopath/src/github.com/hyperledger/fabric/peer/scripts/
  72. - ./channel-artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts
  73. depends_on: #依赖,需要首先按顺序启动以下容器,但是不会等待以下容器完全启动才启动当前容器
  74. - orderer.example.com
  75. - peer0.org1.example.com
  76. - peer1.org1.example.com
  77. - peer0.org2.example.com
  78. - peer1.org2.example.com
  79. networks: #指定当前容器所加入的网络
  80. - byfn

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

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

  1. version: '2'
  2. networks: #声明一个名称为byfn的网络
  3. byfn:
  4. services:
  5. couchdb0: #定义一个couchdb0的服务
  6. container_name: couchdb0 #指定该容器名称为couchdb0
  7. image: hyperledger/fabric-couchdb #该容器所依赖的镜像
  8. environment: #环境变量
  9. - COUCHDB_USER= #couchdb0的用户名,这里设置为空,表明任何人都可登陆
  10. - COUCHDB_PASSWORD= #couchdb0的登陆密码,这里设置为空
  11. ports: #所映射的端口
  12. - "5984:5984"
  13. networks: #使用的网络
  14. - byfn
  15. peer0.org1.example.com: #定义一个peer0.org1.example.com的服务
  16. environment:
  17. - CORE_LEDGER_STATE_STATEDATABASE=CouchDB #指定该服务使用的标准数据库为CouchDB
  18. - CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS=couchdb0:5984 #指定该服务使用的数据库访问地址
  19. - CORE_LEDGER_STATE_COUCHDBCONFIG_USERNAME= #配置数据库用户名
  20. - CORE_LEDGER_STATE_COUCHDBCONFIG_PASSWORD=#配置数据库密码
  21. depends_on: #表明该服务依赖于couchdb0
  22. - couchdb0
  23. couchdb1: #以下同上
  24. container_name: couchdb1
  25. image: hyperledger/fabric-couchdb
  26. ...
  27. ...

3.5 configtx.yaml文件详解

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

  1. Organizations: #组织信息
  2. - &OrdererOrg #配置orderer的信息
  3. Name: OrdererOrg #定义名称
  4. ID: OrdererMSP #定义ID
  5. MSPDir: crypto-config/ordererOrganizations/example.com/msp #指定MSP的文件目录
  6. Policies: #定义相关策略
  7. Readers: #可读
  8. Type: Signature
  9. Rule: "OR('OrdererMSP.member')" #具体策略:允许OrdererMSP中所有member读操作
  10. Writers: #可写
  11. Type: Signature
  12. Rule: "OR('OrdererMSP.member')"
  13. Admins: #admin
  14. Type: Signature
  15. Rule: "OR('OrdererMSP.admin')"
  16. - &Org1 #配置组织一的信息
  17. Name: Org1MSP #定义组织一的名称
  18. ID: Org1MSP #定义组织一的ID
  19. MSPDir: crypto-config/peerOrganizations/org1.example.com/msp #指定MSP的文件目录
  20. Policies: #定义相关策略
  21. Readers: #可读
  22. Type: Signature
  23. Rule: "OR('Org1MSP.admin', 'Org1MSP.peer', 'Org1MSP.client')" #Org1MSP中的admin,peer,client均可进行读操作
  24. Writers: #可写
  25. Type: Signature
  26. Rule: "OR('Org1MSP.admin', 'Org1MSP.client')" #Org1MSP中的admin,client均可进行读操作
  27. Admins: #同上
  28. Type: Signature
  29. Rule: "OR('Org1MSP.admin')"
  30. AnchorPeers: #指定Org1的锚节点,只有锚节点可以与另一个组织进行通信
  31. - Host: peer0.org1.example.com #指定Org1的锚节点的地址
  32. Port: 7051 #指定Org1的锚节点的端口
  33. - &Org2 #同上
  34. Name: Org2MSP
  35. ID: Org2MSP
  36. MSPDir: crypto-config/peerOrganizations/org2.example.com/msp
  37. Policies:
  38. Readers:
  39. Type: Signature
  40. Rule: "OR('Org2MSP.admin', 'Org2MSP.peer', 'Org2MSP.client')"
  41. Writers:
  42. Type: Signature
  43. Rule: "OR('Org2MSP.admin', 'Org2MSP.client')"
  44. Admins:
  45. Type: Signature
  46. Rule: "OR('Org2MSP.admin')"
  47. AnchorPeers:
  48. - Host: peer0.org2.example.com
  49. Port: 9051
  50. Capabilities: #这一区域主要是定义版本的兼容情况
  51. Channel: &ChannelCapabilities
  52. V1_3: true
  53. Orderer: &OrdererCapabilities
  54. V1_1: true
  55. Application: &ApplicationCapabilities
  56. V1_3: true
  57. V1_2: false
  58. V1_1: false
  59. Application: &ApplicationDefaults #同上,定义具体的策略
  60. Organizations:
  61. Policies:
  62. Readers:
  63. Type: ImplicitMeta
  64. Rule: "ANY Readers"
  65. Writers:
  66. Type: ImplicitMeta
  67. Rule: "ANY Writers"
  68. Admins:
  69. Type: ImplicitMeta
  70. Rule: "MAJORITY Admins"
  71. Capabilities:
  72. <<: *ApplicationCapabilities
  73. ################################################################################
  74. #
  75. Orderer: &OrdererDefaults
  76. OrdererType: solo #定义网络类型为solo
  77. Addresses: #定义orderer的地址
  78. - orderer.example.com:7050
  79. BatchTimeout: 2s #定义创建一个区块的超时时间
  80. BatchSize:
  81. MaxMessageCount: 10 #区块内最大消息数
  82. AbsoluteMaxBytes: 99 MB #区块内消息所占的最大空间
  83. PreferredMaxBytes: 512 KB
  84. Organizations:
  85. Policies:
  86. Readers:
  87. Type: ImplicitMeta
  88. Rule: "ANY Readers"
  89. Writers:
  90. Type: ImplicitMeta
  91. Rule: "ANY Writers"
  92. Admins:
  93. Type: ImplicitMeta
  94. Rule: "MAJORITY Admins"
  95. BlockValidation: #区块的验证策略
  96. Type: ImplicitMeta
  97. Rule: "ANY Writers"
  98. ################################################################################
  99. Channel: &ChannelDefaults
  100. Policies:
  101. Readers: #定义谁可以调用交付区块的API
  102. Type: ImplicitMeta
  103. Rule: "ANY Readers"
  104. Writers: #定义谁可以调用广播区块的API
  105. Type: ImplicitMeta
  106. Rule: "ANY Writers"
  107. Admins: #定义谁可以修改配置信息
  108. Type: ImplicitMeta
  109. Rule: "MAJORITY Admins"
  110. Capabilities:
  111. <<: *ChannelCapabilities
  112. Profiles:
  113. TwoOrgsOrdererGenesis:
  114. <<: *ChannelDefaults
  115. Orderer:
  116. <<: *OrdererDefaults
  117. Organizations:
  118. - *OrdererOrg
  119. Capabilities:
  120. <<: *OrdererCapabilities
  121. Consortiums:
  122. SampleConsortium:
  123. Organizations:
  124. - *Org1
  125. - *Org2
  126. TwoOrgsChannel:
  127. Consortium: SampleConsortium
  128. <<: *ChannelDefaults
  129. Application:
  130. <<: *ApplicationDefaults
  131. Organizations:
  132. - *Org1
  133. - *Org2
  134. Capabilities:
  135. <<: *ApplicationCapabilities

原文链接:http://www.cnblogs.com/cbkj-xd/p/11153080.html

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号