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

后端

2023-10-12 00:53:16

Fabric 网络配置：深入剖析通道配置文件和容器环境变量

通道配置文件：Fabric 网络的心脏

Hyperledger Fabric 通道配置文件是定义和管理 Fabric 通道及其组件的核心配置文件。它位于 <fabric-root-directory>/configtx 目录下，包含了网络的蓝图，规定了其行为和特性。

核心配置部分

通道配置文件由多个部分组成，每个部分负责特定类型的配置：

网络配置： 定义了网络的基本属性，如共识算法、区块大小和链码部署策略。
节点配置： 定义了 Fabric 网络中各个节点的属性，如节点名称、类型、地址和组织隶属关系。
服务配置： 定义了 Fabric 网络中各个服务的属性，如账本服务、共识服务和背书服务。
隐私配置： 定义了网络中数据隐私保护的规则和机制。
安全配置： 定义了网络的安全相关配置，如证书颁发机构、加密算法和访问控制策略。

容器环境变量：补充配置文件

容器环境变量是通过 docker-compose.yaml 文件设置的配置参数，补充了通道配置文件中的配置。这些变量用于定义和管理 Fabric 容器环境。

关键容器环境变量

一些关键的容器环境变量包括：

FABRIC_LOGGING_SPEC： 控制 Fabric 日志记录的级别。
FABRIC_LOGGING_FORMAT： 控制 Fabric 日志记录的格式。
FABRIC_CFG_PATH： 指定通道配置文件的路径。
CORE_PEER_ID： 指定节点名称。
CORE_PEER_ADDRESS： 指定节点地址。
CORE_PEER_LOCALMSPID： 指定节点的组织隶属关系。

配置 Fabric 网络：逐步指南

要配置 Fabric 网络，请遵循以下步骤：

创建通道配置文件： 使用 configtxgen 工具生成通道配置文件。
修改容器环境变量： 编辑 docker-compose.yaml 文件以定义容器环境变量。
启动 Fabric 网络： 使用 docker-compose 命令启动 Fabric 网络。

示例代码：配置通道

下面是一个示例通道配置文件中配置通道部分的代码：

# 配置部分
Channel: samplechannel

# 定义组织的 MSP 配置
Organizations:
  - &OrdererOrg
    # 定义组织 MSP 的根证书
    MSPDir: ordererOrganizations/example.com/msp
    # 定义组织的 MSP ID
    ID: OrdererMSP
    AnchorPeers:
      # 定义锚定对等节点的地址和端口
      - Host: orderer.example.com
        Port: 7050
  - &Org1
    MSPDir: peerOrganizations/org1.example.com/msp
    ID: Org1MSP
    AnchorPeers:
      - Host: peer0.org1.example.com
        Port: 7051
  - &Org2
    MSPDir: peerOrganizations/org2.example.com/msp
    ID: Org2MSP
    AnchorPeers:
      - Host: peer0.org2.example.com
        Port: 9051

# 定义应用链码策略
Application: &ApplicationDefaults
    Policies:
        Readers:
            Type: ImplicitMetaPolicy
            Rule: "ANY Readers"
        Writers:
            Type: ImplicitMetaPolicy
            Rule: "ANY Writers"
        Admins:
            Type: ImplicitMetaPolicy
            Rule: "MAJORITY Admins"
# 定义背书策略
EndorsementPolicy: &EndorsementPolicyDefaults
    # 要求所有组织的至少一半背书
    EndorsementPolicy:
        Type: SignaturePolicyEnvelope
        Rule: "NOutOf(2, OrdererMSP, Org1MSP, Org2MSP)"

# 定义链码定义
Capabilities:
    # 定义链码定义的通道能力
    Channel: &ChannelCapabilities
        # 定义背书策略能力
        V1_1: true
        # 定义 V2_0 通道能力
        V2_0: false

# 定义链码部署策略
Policies: &Policies
    Readers: &Readers
        Type: ImplicitMetaPolicy
        Rule: "ANY Readers"
    Writers: &Writers
        Type: ImplicitMetaPolicy
        Rule: "ANY Writers"
    Admins: &Admins
        Type: ImplicitMetaPolicy
        Rule: "MAJORITY Admins"

# 定义通道策略
ChannelPolicy: &ChannelPolicy
    # 定义通道策略
    Type: ImplicitMetaPolicy
    Rule: "ANY ChannelPolicy"