文档首页 > > 用户指南> 区块链管理> 链代码管理

链代码管理

分享
更新时间:2020/09/27 GMT+08:00

为您提供界面化链代码管理功能,包括链代码安装、实例化、更新链代码,同时提供了链代码在线编辑器方便您开发链代码。

注意事项

如果链代码管理页面右上角出现“网络状态”异常提示,请不要立刻进行链代码管理操作,请稍等几分钟,待网络状态正常后,再进行操作。

安装链代码

  1. 登录区块链服务管理页面。

    • 如果部署在CCE集群上时,请执行以下步骤进区块链管理页面:
      1. 登录区块链服务管理控制台。
      2. 单击服务卡片中的“区块链管理”。
      3. 输入用户名、密码、验证码,单击登录。
    • 如果部署在边缘集群上时,请执行以下步骤进区块链管理页面:
      1. 登录IEF管理控制台。
      2. 选择左侧导航栏的“边缘应用 > 容器应用”
      3. 单击当前BCS服务的baas-agent容器,在实例列表中查看其边缘节点。
      图1 查询边缘节点
      1. 单击节点详情,查看主机名。
      2. 在弹性云服务中搜索主机名,查询纳管该边缘节点的弹性云服务器的IP(弹性公网)。
      图2 查询弹性云服务器的IP
      1. 通过该地址https://IP:30603 访问区块链管理页面。
      2. 输入用户名、密码、验证码,单击登录。
        • 用户名为admin,初始登录密码为您在部署区块链服务时设置的密码。为了保证系统安全,建议定期修改密码。
        • 登录时,若您使用的是IE浏览器,有可能会跳转失败并提示使用证书不受信任,此时您可以单击此处进行处理。

  2. 在链代码管理页面,单击“安装链代码”。
  3. 在安装界面输入“链代码名称”、“链代码版本”,选择安装链代码的Peer节点及链代码语言,添加链代码文件等,如下图。

  4. 单击“安装”。

实例化链代码

链代码安装后需要将链代码实例化到通道上,以便Peer节点通过链代码容器和分布式账本进行交互。

实例化链代码前,需要先将节点添加进通道中,否则无法实例化链代码。

  1. 单击链代码列表“操作”列的“实例化”。
  2. 选择实例化通道、链代码版本、背书策略、背书组织,并填写初始化函数、链代码参数等。

    图3 链代码实例化

  3. 在“隐私保护配置”中输入JSON格式的隐私保护数据。

    如果您需要确保一个共享通道内数据的隐私性,例如指定A成员可以访问相关数据的权限,没有权限的成员B,则无法访问相关的数据,可以使用隐私保护功能。如果您的链代码不需要使用隐私保护功能,可以跳过本步骤。

    在配置隐私保护时,请参照示例进行配置,其中:
    • name表示隐私数据空间的名称,此处为"collectionPrivateDetails";
    • policy表示隐私数据空间数据的访问策略,此处表示仅允许组织Org1和Org2的节点获取该隐私空间的数据;
    • requiredPeerCount表示需要几个节点背书,并将隐私数据分发,此处为0表示自己背书;
    • maxPeerCount表示共识节点最大个数,起冗余备份作用,若其中1个共识节点不可用,其他共识节点可以响应获取隐私数据的请求,此处配置为3;
    • blockToLive表示可以保存的隐私数据最大块数,超过这个值,就会进行清除,若想无限存储,需要将该值设为0,此处设置为0;
    • memberOnlyRead默认设置为true,只有该选项为true时policy中的策略才生效。

    隐私保护配置JSON定义举例:

    [
     {
        "name": "collectionPrivateDetails",
        "policy": "OR('Org1MSP.member','Org2MSP.member')",
        "requiredPeerCount": 0,
        "maxPeerCount": 3,
        "blockToLive":0,
        "memberOnlyRead": true
     }
    ]

    表示链码将使用一个叫做“collectionPrivateDetails”的隐私数据空间,只有组织“Org1”和“Org2”的节点才能获取该隐私空间内的数据。

    隐私保护配置中的“name”和“blockToLive” 一旦被设置,后续在升级链代码时,将不能对这两个值做修改。更多信息可以参考 Using Private Data in Fabric

  4. 最后单击“实例化”完成链代码在通道上的实例化。

    如果配置了隐私保护,实例化成功后,单击“查看更多”,可以下载隐私保护数据确认配置是否正确。
    图4 下载隐私保护数据

    若实例化失败,可根据链代码实例化错误码列表查询错误信息以便定位失败原因。

更新链代码

如果您的链代码更新,您需要对新版本链代码进行重新安装且实例化以满足新的业务需求。

  1. 单击链代码列表“操作”列的“更新链代码”。
  2. 填写链代码版本、选择安装节点、添加链代码文件等,单击“更新”。
  3. 实例化新版本链代码,操作请参见实例化链代码
  4. (可选)单击链代码名称前的,展开链代码详细信息,您可以查看当前链代码的版本列表、安装列表和实例化情况。

BCS为您提供了在线链代码编辑器(链代码编辑器请使用Chrome浏览器,使用IE浏览器可能会导致页面混乱),您可以在链代码管理页面,单击“链代码编辑器”进行链代码编辑、调试、运行等操作。

链代码实例化错误码列表

链代码实例化过程中可能会由于种种原因,导致实例化失败。此时您可以在此表中查询错误码对应的错误信息。

表1 错误码列表

错误码

异常信息

6001

执行超时

6999

未知错误

6701

客户端连接Peer失败

6703

Peer背书时,验证签名失败

6704

链代码编译时,拉取ccenv镜像失败

6705

链代码编译失败

6707

链代码镜像构建失败

6708

链代码容器创建失败

6709

链代码容器注册失败

6710

客户端连接Orderer失败

6712

交易信息写入账本失败

6713

Orderer判定请求错误

6714

背书策略校验失败

6715

同一个Peer节点上,不能同时实例化多个链代码

6716

实例化时,init参数错误

6717

实例化时,invoke参数错误

6720

证书创建失败

6721

链代码容器启动超时

6722

链代码容器启动后执行init时遇到异常退出,导致交易超时

6723

包含相同Schema的链代码已经实例化

6725

签名集不满足背书策略

6726

实例化策略校验失败,请使用老组织节点升级链代码

6803

链码不能重复导入依赖包

6901

失败,实例化版本链码必须包含上版本所有表

6902

失败,实例化版本链码必须包含上版本所有字段

6903

失败,实例化版本链码不能改变上版本字段属性

6904

实例化版本链码的schema文件不存在

6905

实例化版本链码的schema文件解析错误

6906

磁盘空间不足

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问