Hyperledger Fabric多VM部署配置及core配置缺失报错排查

基础部署疑问 #

• Peer节点不需要和独立VM一一对应。Peer本质是Fabric的节点进程，单台VM只要CPU、内存、端口资源足够，可以同时运行多个Peer、Orderer节点，测试环境通常用Docker做进程隔离在单台机器部署整套网络；生产环境为了避免单点故障、实现资源隔离，一般采用单VM部署单个Peer/Orderer节点的方案。
• 多VM分布式部署的配置文件修改核心围绕地址可达性做调整：
  • 修改crypto-config.yaml、configtx.yaml中所有Peer、Orderer、锚节点的地址，替换为对应VM的可访问IP或全网唯一主机名，不要使用127.0.0.1这类本地回环地址
  • 修改Docker Compose编排文件，调整各节点的端口绑定规则，将服务端口绑定到VM的对外网卡而非本地回环地址；同步修改volumes挂载路径，匹配当前VM上存储的证书、创世块、通道配置文件的实际路径
  • 确认configtx.yaml中各组织锚节点地址配置为跨VM可访问的地址，保证跨组织节点能正常发现彼此。
• 单VM单节点部署模式下的跨VM通信配置步骤：
  1. 先打通网络层：在云平台防火墙规则中开放Fabric节点的通信端口（Peer默认7051、7053，Orderer默认7050，状态数据库如果用CouchDB则开放5984），放通所有部署节点VM所属网段的访问权限，避免安全组拦截流量
  2. 地址解析配置：编辑/etc/hosts不是必须操作。如果部署环境有内部DNS服务，直接在DNS上添加所有节点的主机名与IP对应解析记录即可；没有内部DNS的场景下，需要在每台VM的/etc/hosts中添加所有节点的IP与主机名映射，同时要在Docker Compose的extra_hosts配置段同步添加这些映射，保证容器内部也能正常解析其他节点地址
  3. 证书一致性校验：生成节点证书时填写的主机名/域名，必须和实际跨节点通信时使用的地址完全一致，否则会触发TLS证书校验失败，无法建立连接
  4. 按顺序启动网络：先启动所有Orderer节点确认集群共识正常，再逐个启动各组织Peer节点，更新锚节点配置，最后将节点加入通道完成网络组建。

启动报错修复 #

报错信息 #

Fatal error when initializing core config : error when reading core config file: Config File "core" Not Found in "[/etc/hyperledger/peercfg]"

报错原因 #

Peer进程启动时默认会到容器内/etc/hyperledger/peercfg路径下读取core.yaml核心配置文件，当前部署存在两个配置错误：

1. 全局FABRIC_CFG_PATH环境变量配置错误：脚本中将该变量全局指向${PWD}/configtx目录，这个目录仅存放configtxgen工具生成创世块、通道交易所需的配置，不包含Peer启动需要的core.yaml
2. Compose挂载配置缺失：没有将本地存储的core.yaml文件正确挂载到Peer容器内的指定配置路径，导致容器内找不到对应文件。

修复步骤 #

1. 调整环境变量配置：删除脚本中全局的export FABRIC_CFG_PATH=${PWD}/configtx配置，不要全局设置该变量，在执行不同命令时单独指定对应配置路径即可，示例：

   # 生成组织证书时指定cryptogen配置路径
   FABRIC_CFG_PATH=${PWD}/organizations/cryptogen cryptogen generate --config=./organizations/cryptogen/crypto-config-org1.yaml --output="organizations"
   
   # 生成创世块、通道配置交易时指定configtx配置路径
   FABRIC_CFG_PATH=${PWD}/configtx configtxgen -profile TwoOrgsApplicationGenesis -outputBlock ./system-genesis-block/genesis.block
   

2. 修正Compose文件挂载规则：打开compose/compose-test-net.yaml，找到Peer节点的volumes配置段，添加core.yaml的挂载规则，将本地存放core.yaml的路径（默认Fabric样例中为config目录下的core.yaml）映射到容器内的目标路径，示例配置：

   services:
     peer0.org1.example.com:
       container_name: peer0.org1.example.com
       image: hyperledger/fabric-peer:latest
       # 其他配置省略
       volumes:
         - ../config/core.yaml:/etc/hyperledger/peercfg/core.yaml
         - ../organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/msp:/etc/hyperledger/fabric/msp
         - ../organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls:/etc/hyperledger/fabric/tls
         - ../system-genesis-block:/etc/hyperledger/fabric/config
   

3. 清理残留资源后重启：执行以下命令清理之前启动失败的残留容器和卷，再重新运行启动脚本：

   docker rm -f $(docker ps -aq)
   docker volume prune -f
   

内容的提问来源于stack exchange，提问作者Tim Chiang