fabric-1.0动态加入组织

fabric的组织配置信息一般是提前写在configtx.yaml文件中的，通过configtx.yaml生成系统创世区块和通道文件。而系统启动和通道创建是通过创世区块和通道文件进行的，因此要在fabric系统运行时添加组织则是非常困难的。

还好，fabric-1.0提供了configtxlator工具，为动态修改fabric通道信息提供可能。本文将介绍如何利用configtxlator为fabric-1.0网络动态添加组织。

运行fabric网络

本文利用fabric-sample项目中的first-network作为测试的示例。文档参考

下载fabric-sample

从github上克隆fabric-sample项目

$ git clone https://github.com/hyperledger/fabric-samples.git
$ cd fabric-samples

下载镜像和binary包

$ curl -sSL https://goo.gl/eYdRbX | bash

这一步可能需要翻墙，可以从这里下载，然后运行，或者

$ curl -sSL http://oui195df4.bkt.clouddn.com/download-bin.sh | bash

这一步会拉取fabric-1.0的镜像和binary包

生成证书和通道文件

为了测试添加组织，先利用cryptogen工具生成三个组织的证书。
修改first-network，添加org3

生成证书和通道文件

$ ./byfn.sh -m generate

证书文件在crypto-config文件夹里，通道文件在channel-artifacts文件夹中

启动两个组织的fabric网络

执行

$ ./byfn.sh -m up

启动包括两个组织的fabric网络，cli容器会执行scripts/script.sh脚本进行创建mychannel通道，加入通道，部署chaincode，调用和查询chaincode等。

在系统channel中添加org

参考configtxlator工具的文档。

启动configtxlator服务

$ configtxlator start

获取系统通道的配置

设置MSP为Orderer

$ export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/users/Admin\@example.com/msp/
$ export CORE_PEER_LOCALMSPID=OrdererMSP

获取通道

# peer channel fetch config config_block.pb -o orderer.example.com:7050 -c testchainid

生成添加组织的增量文件

• 将配置信息区块转换为可读的json文件

$ curl -X POST --data-binary @config_block.pb http://127.0.0.1:7059/protolator/decode/common.Block > config_block.json

• 获取config区域

$ jq .data.data[0].payload.data.config config_block.json > config.json

• 修改config.json，添加org3信息

这一步可以利用configtxgen工具生成org3的配置信息，并将配置信息添加到config.json文件中，修改后的文件保存为updated_config.json，部分内容如图：

• 将original config和updated config打包成proto文件

$ curl -X POST --data-binary @config.json http://127.0.0.1:7059/protolator/encode/common.Config > config.pb

和

$ curl -X POST --data-binary @updated_config.json http://127.0.0.1:7059/protolator/encode/common.Config > updated_config.pb

• 生成增量文件

$ curl -X POST -F original=@config.pb -F updated=@updated_config.pb http://127.0.0.1:7059/configtxlator/compute/update-from-configs -F channel=testchainid > config_update.pb

至此，更新通道的数据已经准备好了。利用SDK可以签名和打包此消息，发送更新通道交易。值得注意的是，这个交易需要所有通道中已存在的org进行签名。

由于系统channel中只有一个组织——OrdererMSP，因此也可以直接通过命令行发送交易。

更新通道

• 将增量文件转换为pb格式

$ curl -X POST --data-binary @config_update.pb http://127.0.0.1:7059/protolator/decode/common.ConfigUpdate > config_update.json

• 打包数据

$ echo '{"payload":{"header":{"channel_header":{"channel_id":"testchainid", "type":2}},"data":{"config_update":'$(cat config_update.json)'}}}' > config_update_as_envelope.json

• 转换为pb文件

$ curl -X POST --data-binary @config_update_as_envelope.json http://127.0.0.1:7059/protolator/encode/common.Envelope > config_update_as_envelope.pb

• 进入cli，更新通道

root@d96f70c3b3ab:/#
root@d96f70c3b3ab:/# peer channel update -f config_update_as_envelope.pb -c testchainid -o 127.0.0.1:7050

此时系统channel——testchainid中则拥有了org3的信息。启动org3，则其可以进入fabric网络。但是org3无法加入mychannel通道，只能新建通道。

向mychannel添加org

向mychannel中添加org和向系统channel中添加org流程上是相同的，不同的是需要用所有PeerOrg进行签名。

生成增量pb文件

通过上述流程，生成增量pb文件，步骤省略。

发送更新通道交易

由于mychannel中有两个org，发送更新通道交易需要两个组织进行对更新交易进行多重签名，而通过执行peer channel update命令无法实现多重签名，因此需要通过SDK发送交易。

本文采用nodejs-sdk，创建更新交易js脚本，部分内容为

var signatures = [];
//读取增量pb文件
var config_proto = fs.readFileSync(path.join(__dirname, 'mychannel_config_update.pb'));

return Client.newDefaultKeyValueStore({
        path: 'kvs_' + org
    }).then((store) => {
        client.setStateStore(store);
        client._userContext = null;
        return getPeerAdmin(client, 'org1');
    }).then((admin) => {
        logger.info('Successfully enrolled user \'admin\' for org1');
        the_user = admin;
        //org1对config_proto进行签名
        var signature = client.signChannelConfig(config_proto);
        logger.info('Successfully signed config update by org1');
        signatures.push(signature);
        client._userContext = null;
        return getPeerAdmin(client, 'org2');
    }).then((admin) => {
        logger.info('Successfully enrolled user \'admin\' for org2');
        the_user = admin;
        //org2对config_proto进行签名
        var signature = client.signChannelConfig(config_proto); 
        logger.info('Successfully signed config update by org2');
        signatures.push(signature);
        client._userContext = null;
        return getOrdererAdmin(client);
    }).then((admin) => {
        logger.info('Successfully enrolled user \'admin\' for orderer');
        the_user = admin;
        //orderer对config_proto进行签名
        var signature = client.signChannelConfig(config_proto);
        logger.info('Successfully signed config update by org2');
        signatures.push(signature);
        let tx_id = client.newTransactionID();
        request = {
            config: config_proto,
            signatures : signatures,
            name : channelName,
            orderer : orderer,
            txId  : tx_id
        };
        //更新通道
        return client.updateChannel(request);
    }).then((result) => {
        if(result.status && result.status === 'SUCCESS') {
            logger.info('Successfully updated the channel.');
            return sleep(5000);
        } else {
            logger.error('Failed to update the channel. ');
            Promise.reject('Failed to update the channel');
        }
    }).then((nothing) => {
        logger.info('Successfully waited to make sure new channel was updated.');

执行js脚本文件，更新通道。

此时org3则能成功加入mychannel通道。

总结

从流程来看，动态添加组织过程还是比较复杂的，涉及到文件的多次转换，多重签名等步骤。

更重要的是，更新交易需要多个组织进行签名，而在实际运用过程中，一个组织不可能获取所有组织的私钥，因此需要增量数据在各个组织间进行审核、流转，这个过程也是非常繁琐的。因此，未来需要开发在线审核流转工具，协助对数据签名。

by. xuyuzhuang
date. 2017-08-22