Fabric20学习进阶链码管理四

38次阅读

共计 8720 个字符，预计需要花费 22 分钟才能阅读完成。

4.1 安装链码

Fabric-sample 工程自带了很多示例链码，位于 fabric-samples/chaincode 目录中，本文测试安装 abstore 工程的 go 版本到 org1.peer0 和 org2.peer0 两个节点。

链码安装成功之后，就可以调用链码完成交易操作了。

安装链码的所有操作均需要先进入 cli 容器，执行如下命令：

docker exec -it cli bash

4.1.1 链码打包

链码打包执行如下命令：

peer lifecycle chaincode package abs.tar.gz --path github.com/hyperledger/fabric-samples/chaincode/abstore/go/ --lang golang --label abs_1

abs.tar.gz：打包合约包文件名

–path：智能合约路径

–lang：智能合约语言，支持 golang、Java、node

–label：智能合约标签，起描述作用

执行成功之后，当前目录下将生成文件 abs.tar.gz。

4.1.2 链码安装

本节将把上述打包的代码安装到 org1.peer0 和 org2.peer0 两个节点上，因此需要切换环境变量。

通过命令查看当前使用的是 org1.peer0 的环境。

执行链码安装命令，则可以把上述打包的合约代码安装到 org1.peer0 节点上。

peer lifecycle chaincode install abs.tar.gz

执行结果如下：

查看安装结果，执行命令：

peer lifecycle chaincode queryinstalled

接下来为 org2.peer0 安装智能合约代码，执行如下命令切换环境变量：

source scripts/utils.sh
setGlobals 0 2

查看切换结果，如下图所示：

执行链码安装命令，则可以把上述打包的合约代码安装到 org2.peer0 节点上。

peer lifecycle chaincode install abs.tar.gz

4.1.3 链码认证

链码安装完成之后需要被组织认证，认证通过之后才能将链码提交并运行，该过程又可以称为合约定义，定义了合约的名称、版本、序列号，后续合约升级即修改版本或序列号，重新定义合约。

执行如下代码，完成当前节点所在组织对上述安装链码的认证。

peer lifecycle chaincode approveformyorg --tls true --cafile $ORDERER_CA --channelID mychannel --name abs --version 1 --init-required --package-id abs_1:90786e8a73dbee43adfebeb316407387173f598a5f7e3cef7ddc754fe25e2ad6 --sequence 1 --waitForEvent

参照上节的方法切换环境，实现 org2 组织对上述安装链码的认证。

最后查看链码认证结果，执行如下命令：

peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name abs --version 1 --sequence 1 --output json --init-required

上图结果表示：通道 mychannel 中的两个组织 Org1 和 Org2 均已对智能合约链码 abs 认证通过。

4.1.4 链码提交

只有通过组织认证的链码才能被提交。执行如下命令提交链码：

peer lifecycle chaincode commit -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA --channelID mychannel --name abs --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt --version 1 --sequence 1 --init-required

查看提交结果，执行如下命令：

peer lifecycle chaincode querycommitted --channelID mychannel --name abs

4.2 调用链码

链码调用主要包括 invoke 和 query 两个操作，本节将演示智能链码数据初始化、数据查询以及数据更新。

4.2.1 链码初始化

执行如下命令调用链码初始化方法，并指定初始化参数和值。

peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA -C mychannel -n abs --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt --isInit -c '{"Args":["Init","a","100","b","100"]}'

4.2.2 数据查询

执行如下命令查询参数 a 的值。

peer chaincode query -C mychannel -n abs -c '{"Args":["query","a"]}'

4.2.3 数据更新

执行如下命令调用合约的 invoke 方法，实现参数 a 的值减少 10，参数 b 的值增加 10。

peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA -C mychannel -n abs --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["invoke","a","b","10"]}'

执行结果如下图所示：

4.3 升级链码

链码（合约）升级的关键之处在于合约定义，即 4.1.3 节的链码认证。升级链码之后将重新定义合约，修改合约的版本号或者序列号。

4.3.1 获取合约代码

巧妇难为无米之炊。升级链码的第一步应该是获取合约代码，获取合约代码有两种方式：

  • 根据 4.1.1 节链码打包命令参数 –path 指定的路径获取代码；

  • 通过 peer 脚本获取已安装的合约代码包，执行如下命令：

    # 查看已安装的合约代码包，获取对应包的 package-id 值
peer lifecycle chaincode queryinstalled

    执行结果如下图所示：

    # 下载指定合约代码包
peer lifecycle chaincode getinstalledpackage --package-id abs_1:90786e8a73dbee43adfebeb316407387173f598a5f7e3cef7ddc754fe25e2ad6

    执行结果如下图所示：

    上图中，我们可以看到当前目录下多了一个以 package-id 值命名的压缩文件，重命名该文件为 abs.tar.gz，通过 tar 命令查看该压缩包包含一个 json 文件和一个压缩包。Json 文件是对压缩包的描述，code.tar.gz 则是合约源码，是我们本次的修改目标，将该包解压之后我们继续接下来的操作。

4.3.2 修改合约代码

假设大家已经把下载的合约源码包解压了，或者找到了样例自带源码的路径，接下来开始修改合约代码。

本次修改目标文件为：abstore.go，增加一个 Add 函数，具体内容如下：

func (t *ABstore) Add(ctx contractapi.TransactionContextInterface, A string, X int) error {
        var err error
        //Get the state from the leger
        Avalbytes, err := ctx.GetStub().GetState(A)
        if err != nil {return fmt.Errorf("Failed to get state for" + A)
        }

        if Avalbytes == nil {return fmt.Errorf("Nil amount for" + A)
        }

        var Aval int
        Aval, _ = strconv.Atoi(string(Avalbytes))
        Aval = Aval + X

        // Write the state back to the ledger
        err = ctx.GetStub().PutState(A, []byte(strconv.Itoa(Aval)))
        if err != nil {return err}

        return nil
}

修改后的文件内容如下图所示：

4.3.3 重新打包合约

代码修改完成之后，重新打包，执行如下命令：

peer lifecycle chaincode package abs.tar.gz --path github.com/hyperledger/fabric-samples/chaincode/abstore/go/ --lang golang --label abs_1

执行完成之后请自行检测当前目录是否生成代码包。

4.3.4 重新安装合约 

# 安装链码
peer lifecycle chaincode install abs.tar.gz
# 查询链码安装结果
peer lifecycle chaincode queryinstalled

执行结果如下图所示：

上图标红的内容为新打包安装成功的合约代码包。

参照 4.1.2 节，切换到另外的组织节点，进行新打包合约代码的安装。

4.3.5 修改合约定义

修改合约定义与 4.1.3 节链码认证执行一样的命令，只是指定参数值不一样。

package-id 为最新合约包的 Package ID，即上图红框中的内容；sequence 参数设置为 2，因为这是该合约相同版本的第 2 次安装。具体执行命令如下：

peer lifecycle chaincode approveformyorg --tls true --cafile $ORDERER_CA --channelID mychannel --name abs --version 1 --init-required --package-id abs_1:013a79f868db17429c3195acacc08ae376994c5a9fb32d2302bef7f49f0354f7 --sequence 2 --waitForEvent

参照 4.1.3 节，切换到另外的组织节点，进行新打包合约代码的定义。

最后查看新合约的定义（认证）结果，执行如下命令：

peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name abs --version 1 --sequence 2 --output json --init-required

上图结果表示：通道 mychannel 中的两个组织 Org1 和 Org2 对新打包的智能合约认证通过。

4.3.6 重新提交合约

重新提交合约与 4.1.4 节链码提交使用相同的命令，唯一不同的就是 sequence 参数值为 2。

peer lifecycle chaincode commit -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA --channelID mychannel --name abs --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt --version 1 --sequence 1 --init-required

查看提交结果，如下图所示：

上图显示合约 abs 已经提交到通道 mychannel，并展示了对应的版本、序列、背书插件、校验插件等信息。

4.3.7 检验新合约

本次校验步骤分为三步：

(1) 调用合约的 query 方法，查询参数 a 的值；

peer chaincode query -C mychannel -n abs -c '{"Args":["query","a"]}'

(2) 调用合约新增的 add 方法，将 a 的值增加 30；

peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA -C mychannel -n abs --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["add","a","30"]}'

(3) 再次调用合约的 query 方法，查询参数 a 的值，判断上一步是否正确执行；

peer chaincode query -C mychannel -n abs -c '{"Args":["query","a"]}'

上述过程的执行结果如下图所示：

从上图的执行结果来看，a 的原值为 90，调用 add 方法给 a 值增加 30，再次查询 a 的值为 120，说明合约更新成功，新增的方法也调用成功。

4.4 其他节点补充安装链码

之前的操作仅在 org1.peer0 和 org2.peer0 两个节点上安装并升级了链码，org1.peer1 和 org2.peer1 两个节点未安装链码。当运行基于 Fabric SDK 编写的 Java 代码时，调用查询方法失败，报错“abs 链码未安装”，应该是客户端把请求发到了未安装链码的两个节点，基于此原因，补充本节内容。

补充安装链码的步骤如下：

(1) 从已安装的 peer 节点获取安装包 

# 下载链码包
peer lifecycle chaincode getinstalledpackage --package-id abs_1:013a79f868db17429c3195acacc08ae376994c5a9fb32d2302bef7f49f0354f7
# 重命名链码包
mv abs_1\:013a79f868db17429c3195acacc08ae376994c5a9fb32d2302bef7f49f0354f7.tar.gz abs.tar.gz

（2）在 org1.peer1 和 org2.peer1 节点上安装链码 

# 切换环境到 org1.peer1
source scripts/utils.sh
setGablobs 1 1
# 执行安装命令
peer lifecycle chaincode queryinstalled
setGablobs 1 2
# 执行安装命令
peer lifecycle chaincode queryinstalled

(3) 获得 org1 和 org2 两个组织的认证

本过程最重要的是注意 sequence 参数值，该值必须在 sequence 最新值上增加 1，查询该链码最新的 sequence 值，执行如下命令：

peer lifecycle chaincode querycommitted --channelID mychannel --name abs

假如链码 abs 的 sequence 最新值为 2，则获取组织认证命令如下：

peer lifecycle chaincode approveformyorg --tls true --cafile $ORDERER_CA --channelID mychannel --name abs --version 1 --init-required --package-id abs_1:013a79f868db17429c3195acacc08ae376994c5a9fb32d2302bef7f49f0354f7 --sequence 3 --waitForEvent

切换到另外 1 个组织的任意节点，执行上述相同的命令。

最后查看认证结果，必须两个组织都认证通过才行。

peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name abs --version 1 --sequence 3 --output json --init-required

(4) 提交链码

提交代码同样需要注意修改 sequence 参数即可，命令如下：

peer lifecycle chaincode commit -o orderer.example.com:7050 --tls true --cafile $ORDERER_CA --channelID mychannel --name abs --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt --version 1 --sequence 3 --init-required

当 org1.peer1 和 org2.peer1 两个节点成功安装链码之后，ContractAPI 的样例代码才能运行成功，如果还是有问题，则需要检查证书文件。

文章作者：xiaohui249
本文链接：http://javatech.wang/index.ph…
版本所有 ©转载时必须以链接形式注明作者和原始出处

本文由博客群发一文多发等运营工具平台 OpenWrite 发布

正文完
区块链
发表至： 区块链
2020-07-01
 0
关于区块链:邀请函-区块链如何助力公益腾讯深大微众专家齐聚ESG系列研讨会
关于区块链:企业供应链数字化怎么做如何搭建数字化供应链系统
关于区块链:ADAMoracle的增值空间和发展价值
关于区块链:如何在智能合约中调用另一个合约的函数