Fabric 2.2 测试网络crypto-config-org1.yaml详解
# Copyright IBM Corp. All Rights Reserved.
#
# SPDX-License-Identifier: Apache-2.0
#
# ---------------------------------------------------------------------------
# "PeerOrgs" - Definition of organizations managing peer nodes
# ---------------------------------------------------------------------------
PeerOrgs:
# ---------------------------------------------------------------------------
# Org1
# ---------------------------------------------------------------------------
- Name: Org1
Domain: org1.example.com
EnableNodeOUs: true
# ---------------------------------------------------------------------------
# "Specs"
# ---------------------------------------------------------------------------
# Uncomment this section to enable the explicit definition of hosts in your
# configuration. Most users will want to use Template, below
#
# Specs is an array of Spec entries. Each Spec entry consists of two fields:
# - Hostname: (Required) The desired hostname, sans the domain.
# - CommonName: (Optional) Specifies the template or explicit override for
# the CN. By default, this is the template:
#
# "{{.Hostname}}.{{.Domain}}"
#
# which obtains its values from the Spec.Hostname and
# Org.Domain, respectively.
# ---------------------------------------------------------------------------
# - Hostname: foo # implicitly "foo.org1.example.com"
# CommonName: foo27.org5.example.com # overrides Hostname-based FQDN set above
# - Hostname: bar
# - Hostname: baz
# ---------------------------------------------------------------------------
# "Template"
# ---------------------------------------------------------------------------
# Allows for the definition of 1 or more hosts that are created sequentially
# from a template. By default, this looks like "peer%d" from 0 to Count-1.
# You may override the number of nodes (Count), the starting index (Start)
# or the template used to construct the name (Hostname).
#
# Note: Template and Specs are not mutually exclusive. You may define both
# sections and the aggregate nodes will be created for you. Take care with
# name collisions
# ---------------------------------------------------------------------------
Template:
Count: 1
SANS:
- localhost
# Start: 5
# Hostname: {{.Prefix}}{{.Index}} # default
# ---------------------------------------------------------------------------
# "Users"
# ---------------------------------------------------------------------------
# Count: The number of user accounts _in addition_ to Admin
# ---------------------------------------------------------------------------
Users:
Count: 1cryptogen generate命令会读取crypto-config-org1.yaml文件来生成组织的加密材料和证书。
该文件主要定义了PeerOrgs，即管理对等节点的组织。在该配置文件中，Org1是一个PeerOrg，并定义了以下属性：
- Name：组织名称
- Domain：组织域名
在Hyperledger Fabric网络中，域名用于标识和区分不同的组织。每个组织都应该拥有一个唯一的域名。在配置文件中，每个组织都有一个名为Domain的属性，它指定了组织的域名。当Fabric网络中的参与方需要与其他参与方通信时，域名将用于识别要与之通信的参与方。此外，Fabric中的证书和标识都使用域名作为一部分其命名约定，因此使用唯一的域名可以确保证书和标识的唯一性。
- EnableNodeOUs：是否启用节点OU
EnableNodeOUs是指定组织是否启用节点的组织单位（Organizational Units，OUs），节点OU是指定PEER节点的身份的单位，可用于控制对等节点的访问权限和授权策略。在Hyperledger Fabric网络中，节点可以属于不同的OU，可以通过配置OU标识和其对应的访问策略来精细控制节点之间的通信和数据访问。启用OU可以使组织更细粒度地管理节点，并更好地满足其安全和管理需求。
在PeerOrgs下面，Template指定了如何创建节点。在此示例中，节点使用默认主机名“peer%d”，其中%d将按顺序递增。
SANS代表"Subject Alternative Names"，即主题备用名称。在生成证书时，通常可以指定多个主题备用名称，这些名称可以与证书中的主题名称一起使用，以增加证书的灵活性。在这里，SANS是在Org1中定义的，其值是一个字符串数组，其中只包含一个值"localhost"。这意味着在生成证书时，证书的主题备用名称将是"localhost"，这使得可以在同一机器上运行不同的Fabric CA服务器而不会出现证书冲突的问题。（如果同时启动了peer0和peer1，并且它们的主机名都是localhost，都属于org1，域名都是org1.example.com，那么连接localhost.org1.example.com时，具体连接的是哪个节点是不确定的，取决于网络中的路由和负载均衡策略。因此，在多个节点都使用localhost主机名时，最好使用不同的端口或不同的IP地址来区分它们。）
此外，在Users下，Count指定了除Admin用户之外的其他用户数。在Hyperledger Fabric网络中，每个Peer节点都有一个管理员用户（Admin），可以使用该用户进行管理和操作。除了管理员用户，还可以为组织中的Peer节点创建其他用户账户。Count选项用于指定在生成证书时，为Peer节点创建的用户账户数量，除了管理员账户外的其他账户数量。例如，在上面提到的配置文件中，Count指定为1，则在生成证书时，除了Admin账户外，将创建1个其他用户账户。这些用户账户可以用于Peer节点之间的身份验证和授权。
使用此配置文件，cryptogen generate命令将生成组织的私钥、证书和其他加密材料，并将它们输出到指定的目录中。输出目录默认为./crypto-config，在这个例子中，我们已经将输出目录更改为./organizations。生成的证书和密钥将用于启动Fabric网络中的各种组件，如Peer节点和Orderer节点等。