Fabric v2.0 通道(channel)创建后的配置修改——新增组织

推荐阅读：通道（Channel）机制运行原理。

1. 创建包含两个组织的channel

1.1 准备configtx.yaml文件

首先需要准备channel配置的configtx.yaml文件，同时需要将环境变量FABRIC_CFG_PATH设置为该文件所在目录。

configtx.yaml中的相关配置如下：

    TwoOrgsChannel:
        Consortium: SampleConsortium
        <<: *ChannelDefaults
        Application:
            <<: *ApplicationDefaults
            Organizations:
                - *Org1
                - *Org2
            Capabilities:
                <<: *ApplicationCapabilities

• 初始配置只包含两个组织Org1和Org2，channel创建成功后，我们会尝试在该channel中新增第三个组织Org3。
• Capabilities引用了ApplicationCapabilities定义，用于确保网络和channel以相同的方式处理交易，使用版本号进行定义。
• Application引用了ApplicationDefaults定义，控制应用程序channel的配置参数(添加/删除组织):修改这一部分配置需要大部分组织管理管理员的签名。要实现将组织添加到channel必须将组织的MSP等配置参数添加到组织配置。
• 组织相关参数：可以更改组织特定的任何参数（例如，标识锚点peer或组织管理员的证书）。默认情况下，更改这些值将不需要大多数application组织管理员，而仅需要组织本身的管理员。

1.2 生成创建channel的tx文件

执行下面的命令，生成channel配置的tx文件：

configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychannel

-outputCreateChannelTx ：输出tx文件路径
-channelID： 指定channel ID

1.3 创建channel

进入cli容器，执行下面命令根据上面生成的tx文件，创建channel：

peer channel create -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/channel.tx --tls true --cafile $ORDERER_CA

-c：channel ID
-o：排序节点的服务域名、端口
-f：channel配置的tx文件所在路径

channel创建成功后，当前目录会产生channel的区块文件mychannel.block。

1.4 节点加入channel

切换到peer0.org1.example.com节点（切换方法见文章末尾），将该节点加入到channel：

peer channel join -b mychannel.block

-b：区块文件路径

使用下面命令可查看当前节点加入的所有channel：

peer channel list

节点加入成功后，查看排序节点的日志，可以看到排序节点写入了新的区块，同时为该channel创建了一个raft集群。

2. channel中新增组织

2.1 生成Org3证书配置

生成Org3的密钥与证书，作为该组织在Fabric网络中的身份。org3-crypto.yaml如下，包括两个节点和一个普通user：

PeerOrgs:
  - Name: Org3
    Domain: org3.example.com
    EnableNodeOUs: true
    Template:
      Count: 2
    Users:
      Count: 1

执行下面命令生成密钥和证书：

cd org3-artifacts
cryptogen generate --config=./org3-crypto.yaml

org3-artifacts路径下将会生成crypto-config证书目录。

还需将orderer的证书配置拷贝到org3-artifacts目录：

cp -r crypto-config/ordererOrganizations org3-artifacts/crypto-config/

2.2 生成Org3组织定义

生成Org3组织定义，配置文件为first-network/org3-artifacts/configtx.yaml：

cd org3-artifacts
export FABRIC_CFG_PATH=$PWD
configtxgen -printOrg Org3MSP > ../channel-artifacts/org3.json

channel-artifacts目录下将会产生org3.json文件。

Fabric网络中已经创建了创世区块与user channel的配置，后面步骤中会将新加的组织配置添加到区块配置中。

2.3 生成新增Org3的channel配置交易

首先获取该channel的最新配置区块：

peer channel fetch config config_block.pb -o orderer.example.com:7050 -c mychannel --tls --cafile $ORDERER_CA

解码获取到的区块文件config_block.pb，得到config.json文件：

configtxlator proto_decode --input config_block.pb --type common.Block | jq .data.data[0].payload.data.config > config.json

在config.json文件基础上增加新组织Org3，得到modified_config.json文件：

jq -s '.[0] * {"channel_group":{"groups":{"Application":{"groups": {"Org3MSP":.[1]}}}}}' config.json ./channel-artifacts/org3.json > modified_config.json

计算出前后的配置更新，得到config_update.json文件：

configtxlator proto_encode --input config.json --type common.Config >original_config.pb
configtxlator proto_encode --input modified_config.json --type common.Config >modified_config.pb
configtxlator compute_update --channel_id mychannel --original original_config.pb --updated modified_config.pb >config_update.pb
configtxlator proto_decode --input config_update.pb --type common.ConfigUpdate >config_update.json

将更新文件config_update.json包装在信封消息中，得到config_update_in_envelope.json文件：

echo '{"payload":{"header":{"channel_header":{"channel_id":"'$CHANNEL'", "type":2}},"data":{"config_update":'$(cat config_update.json)'}}}' | jq . >config_update_in_envelope.json

将该json文件编码为protobuf格式文件，得到org3_update_in_envelope.pb，即为最终的更新对象：

configtxlator proto_encode --input org3_update_in_envelope.json --type common.Envelope --output org3_update_in_envelope.pb

2.4 签名并提交配置更新交易

添加组织需要channel大部分的组织Admin签名（当前环境变量为peer0.org1.example.com）：

peer channel signconfigtx -f org3_update_in_envelope.pb

切换环境为peer0.org2.example.com执行更新配置（切换方法见文章末尾），因为update也会为当前组织签名，所以不需要再org2的签名：

peer channel update -f org3_update_in_envelope.pb -c mychannel -o orderer.example.com:7050 --tls --cafile ${ORDERER_CA}

2.5 Org3的节点加入channel

启动Org3相关的节点容器，在first-network目录下执行：

docker-compose -f docker-compose-org3.yaml up -d

获取mychannel的0号创世区块：

peer channel fetch 0 mychannel.block -o orderer.example.com:7050 -c mychannel --tls --cafile $ORDERER_CA

当前环境变量为peer0.org3.example.com，使用创世区块将org3的节点加入channel：

peer channel join -b mychannel.block

查看当前节点加入的channel：

peer channel list

附录：环境变量

本文命令中使用的环境变量配置：

ORDERER_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem
PEER0_ORG1_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
PEER0_ORG2_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt
PEER0_ORG3_CA=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org3.example.com/peers/peer0.org3.example.com/tls/ca.crt

cli中设置连接不同的节点，需要设置相应的环境变量：

• peer0.org1.example.com

export CORE_PEER_LOCALMSPID="Org1MSP"
export 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
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/[email protected]/msp
export CORE_PEER_ADDRESS=peer0.org1.example.com:7051

• peer0.org2.example.com

export CORE_PEER_LOCALMSPID="Org2MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/[email protected]/msp
export CORE_PEER_ADDRESS=peer0.org2.example.com:9051

• peer0.org3.example.com

export CORE_PEER_LOCALMSPID=Org3MSP
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org3.example.com/peers/peer0.org3.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org3.example.com/users/[email protected]/msp
export CORE_PEER_ADDRESS=peer0.org3.example.com:11051

参考资料：
github.com/hyperledger/fabric-samples/first-network/eyfn.sh