Hyperledger Fabric Orderer 配置解析

原创
02/23 17:56
阅读数 875

Hyperledger Fabric Orderer 配置解析

文中使用的 fabric 版本为 2.4.1

排序节点在Fabric网络中为Peer提供排序服务。与Peer节点类似,排序节点支持从命令行参数、环境变量或配置文件中读取配置信息。环境变量中配置需要以ORDERER_前缀开头,例如,配置文件中的general.ListenAddress项,对应到环境变量ORDERER_GENERAL_LISTENADDRESS。

排序节点默认的配置文件读取路径为 $FABRIC_CFG_PATH 中定义的路径;如果没找到,则尝试查找当前目录;如果还没有找到,则尝试查找默认的 /etc/hyperledger/fabric 路径。

在结构上,orderer.yaml 文件中一般包括 GeneralFileLedgerRAMLedgerKafkaDebugOperationsMetricsConsensus 八大部分.


General 部分

这一部分主要是一些通用配置,如账本类型、服务信息、配置路径等。这些配置影响到服务的主要功能,十分重要.

配置项 作用 默认值
ListenAddress 服务绑定的监听地址,一般需要指定为所服务的特定网络接口的地址或全网(0.0.0.0) 127.0.0.1
ListenPort 服务绑定的监听端口 7050
TLS.Enabled 启用TLS时的相关配置 false
TLS.PrivateKey Orderer 签名私钥 tls/server.key
TLS.Certificate Orderer 身份证书 tls/server.crt
TLS.RootCAs 信任的根证书 tls/ca.crt
TLS.ClientAuthRequired 是否对客户端也进行认证 false
TLS.ClientRootCAs 信任的客户端根证书列表 N/A
Keepalive.ServerMinInterval 允许其他客户端 ping 消息的最小间隔,超时则断开连接 60s
Keepalive.ServerInterval 到客户端的 ping 消息的间隔 7200s
Keepalive.ServerTimeout 关闭连接前等待响应的时间 20s
MaxRecvMsgSize GRPC服务器和客户端可以接收的最大消息大小(以字节为单位) 104857600
MaxSendMsgSize GRPC服务器和客户端可以发送的最大消息大小(以字节为单位) 104857600
Cluster raft 模式下的集群配置 N/A
Cluster.SendBufferSize 发送缓冲区的最大长度 10
Cluster.ClientCertificate 双向TLS认证时,作为客户端证书的文件路径,如果没设置会使用 TLS.Certificate N/A
Cluster.ClientPrivateKey 双向TLS认证时,作为客户端私钥的文件路径,如果没设置会使用 TLS.PrivateKey N/A
Cluster.ListenPort 监听端口默认使用gRPC相同的端口 N/A
Cluster.ListenAddress 监听地址默认使用gRPC相同的地址 N/A
Cluster.ServerCertificate 双向TLS认证时,作为服务端证书的文件路径 N/A
Cluster.ServerPrivateKey 双向TLS认证时,作为服务端私钥的文件路径 N/A
BootstrapMethod 获取引导块的方法,2.x版本中仅支持file或none file
BootstrapFile 系统通道初始区块或最新配置区块文件路径 N/A
LocalMSPDir 本地 MSP 文件路径 msp
LocalMSPID MSP ID SampleOrg
Profile 是否启用 Go profiling ,开启会影响性能 N/A
BCCSP 密码库机制等,可以为 SW(软件实现)或 PKCS11(硬件安全模块) SW
Authentication.TimeWindow 如果客户端和服务端时钟差异超过窗口指定值,则拒绝消息 15m

FileLedger 部分

配置项 作用 默认值
Location 指定存放区块文件的位置,一般为/var/hyperledger/production/orderer。该目录下面包括chains子目录,存放各个chain的区块;index目录,存放索引文件 /var/hyperledger/production/orderer

Kafka 部分

因为不推荐使用了,暂时不关注


Debug 部分

Debug部分主要用于对排序节点进行调试和差错时的追踪配置。

配置项 作用 默认值
BroadcastTraceDir 广播请求的追踪路径 N/A
DeliverTraceDir 交付请求的追踪路径 N/A

Operations 部分

Operations部分与Peer相关配置类似,主要设置运行时对外的RESTful管理服务,包括监听的地址和TLS安全配置.

配置项 作用 默认值
ListenAddress RESTful 管理服务的监听地址 127.0.0.1:8443
TLS.Enabled 是否启用 TLS 保护 false
TLS.Certificate 服务端使用证书文件路径 N/A
TLS.PrivateKey 服务端使用私钥文件路径 N/A
TLS.ClientAuthRequired 是否开启客户端验证以限定访问的客户端,默认关闭,推荐开启 false
TLS.ClientRootCAs 开启客户端验证时,信任的客户端根证书路径列表 []

Metrics 部分

Metrics部分与Peer相关配置类似,负责配置统计服务

配置项 作用 默认值
provider 统计服务类型,可以为statsd(推送模式),prometheus(拉取模式),disabled disabled
statsd.network 网络协议类型,tcp或udp udp
statsd.address 修改为外部 statsd 的服务地址 127.0.0.1:8125
statsd.writeInterval 推送统计汇报到 statsd 的时间间隔 10s
statsd.prefix 为所有统计推送添加前缀 N/A

注意 statsdprometheus 都是流行的开源监控数据收集软件。


Consensus 部分

共识为Raft模式时的日志存储配置

配置项 作用 默认值
WALDir 预写日志的存储位置,每个通道独占一个同名的子目录 /var/hyperledger/production/orderer/etcdraft/wal
SnapDir 快照文件的存储位置,每个通道独占一个同名的子目录 /var/hyperledger/production/orderer/etcdraft/snapshot
EvictionSuspicion 节点怀疑被从通道移除,触发从其他节点获取区块来确认的等待时间。隐藏参数 10m
展开阅读全文
加载中

作者的其它热门文章

打赏
0
0 收藏
分享
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部