计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
弹性伸缩 AS
镜像服务 IMS
专属主机 DeH
函数工作流 FunctionGraph
云手机服务器 CPH
Huawei Cloud EulerOS
网络
虚拟私有云 VPC
弹性公网IP EIP
虚拟专用网络 VPN
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
VPC终端节点 VPCEP
云连接 CC
企业路由器 ER
企业交换机 ESW
全球加速 GA
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
边缘安全 EdgeSec
威胁检测服务 MTD
CDN与智能边缘
内容分发网络 CDN
CloudPond云服务
智能边缘云 IEC
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
云搜索服务 CSS
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
数据可视化 DLV
数据湖工厂 DLF
湖仓构建 LakeFormation
企业应用
云桌面 Workspace
应用与数据集成平台 ROMA Connect
云解析服务 DNS
专属云
专属计算集群 DCC
IoT物联网
IoT物联网
设备接入 IoTDA
智能边缘平台 IEF
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
国际站常见问题
ICP备案
我的凭证
支持计划
客户运营能力
合作伙伴支持计划
专业服务
区块链
区块链服务 BCS
Web3节点引擎服务 NES
解决方案
SAP
高性能计算 HPC
视频
视频直播 Live
视频点播 VOD
媒体处理 MPC
实时音视频 SparkRTC
数字内容生产线 MetaStudio
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
存储容灾服务 SDRS
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属分布式存储服务 DSS
容器
云容器引擎 CCE
容器镜像服务 SWR
应用服务网格 ASM
华为云UCS
云容器实例 CCI
管理与监管
云监控服务 CES
统一身份认证服务 IAM
资源编排服务 RFS
云审计服务 CTS
标签管理服务 TMS
云日志服务 LTS
配置审计 Config
资源访问管理 RAM
消息通知服务 SMN
应用运维管理 AOM
应用性能管理 APM
组织 Organizations
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
应用身份管理服务 OneAccess
数据库
云数据库 RDS
文档数据库服务 DDS
数据管理服务 DAS
数据复制服务 DRS
云数据库 GeminiDB
云数据库 GaussDB
分布式数据库中间件 DDM
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
人脸识别服务 FRS
图引擎服务 GES
图像识别 Image
内容审核 Moderation
文字识别 OCR
AI开发平台ModelArts
图像搜索 ImageSearch
对话机器人服务 CBS
华为HiLens
视频智能分析服务 VIAS
语音交互服务 SIS
应用中间件
分布式缓存服务 DCS
API网关 APIG
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
多活高可用服务 MAS
事件网格 EG
企业协同
华为云会议 Meeting
云通信
消息&短信 MSGSMS
云生态
合作伙伴中心
云商店
开发者工具
SDK开发指南
API签名指南
Terraform
华为云命令行工具服务 KooCLI
其他
产品价格详情
系统权限
管理控制台
客户关联华为云合作伙伴须知
消息中心
公共问题
开发与运维
应用管理与运维平台 ServiceStage
软件开发生产线 CodeArts
需求管理 CodeArts Req
部署 CodeArts Deploy
性能测试 CodeArts PerfTest
编译构建 CodeArts Build
流水线 CodeArts Pipeline
制品仓库 CodeArts Artifact
测试计划 CodeArts TestPlan
代码检查 CodeArts Check
代码托管 CodeArts Repo
云应用引擎 CAE
开天aPaaS
云消息服务 KooMessage
云手机服务 KooPhone
云空间服务 KooDrive

链代码管理

更新时间:2023-06-05 GMT+08:00

为您提供界面化链代码管理功能,包括链代码安装、实例化、更新链代码,安装和更新链代码时支持对Golang语言的代码进行安全检查。

说明:

安装链代码总数支持500个,建议CCE集群机器总规格至少达到500U1000GB。

注意事项

  1. 链代码安装前需要将开发的链代码文件压缩成zip格式以执行安装。
  2. 如果链代码管理页面右上角出现“网络状态”异常提示,请不要立刻进行链代码管理操作,请稍等几分钟,待网络状态正常后,再进行操作。
    图1 网络状态正常

安装链代码

  1. 登录区块链服务管理页面。
  2. 在链代码管理页面,单击“安装链代码”。
  3. 在安装界面输入“链代码名称”、“链代码版本”等,详细参数配置请参考表1

    图2 安装链代码
    表1 链代码信息

    参数

    描述

    链代码名称

    链代码名称,以小写字母开头,支持小写字母和数字,长度6-25位。

    链代码版本

    链代码版本号。

    账本数据存储方式

    默认是文件数据库(goleveldb)。

    选择全部Peer节点

    打勾后,选择全部Peer节点。

    组织&Peer节点

    手动选择组织&Peer节点。

    链代码语言

    支持Golang,Nodejs,Java三种类型。

    链代码文件

    添加链代码文件。

    链代码描述

    自定义描述信息。

    代码安全检查

    链代码语言选择Golang,该功能才会显示。选择是否开启代码安全检查。

  4. 单击“安装”,完成链代码安装。
  5. 单击链代码名称前,展开链代码详细信息。
  6. 在“版本列表”页签,单击“操作”列的“下载检查报告”查看链代码检查结果。(以下示例仅供参考,请以实际扫描结果为准。)

    说明:

    若不开启代码安全检查,则不会生成检查报告,也不会显示“下载检查报告”按钮。

    图3 下载检查报告
    1. 解压文件压缩包,打开里面的html文件查看扫描结果详情,扫描报告按照错误、警告、提示三种类型分类显示,其中“错误”级别的问题需要处理,否则会影响链代码的正常功能;“警告”级别的问题建议通过代码重构进行规避;“提示”级别的问题可以根据实际情况进行选择性的处理。
      图4 扫描文件
    2. 例如示例图中出现“提示”级别的问题1次,单击打开详细信息,提供问题的简要说明、错误示例代码、扫描详情、修改建议和示例代码供您参考。
      说明:

      您可以根据链代码检查结果对代码进行修改后,重新进行链代码的安装或者更新。

实例化链代码

链代码安装后需要将链代码实例化到通道上,以便Peer节点通过链代码容器和分布式账本进行交互。实例化链代码前,请确保先将组织中的Peer节点添加进通道中,否则无法实例化链代码。

说明:
  • 根据链代码开发语言的不同,实例化后的容器占用内存量并不相同。对于单个peer节点,单个Go语言链代码容器占用运行内存约10MB,单个Java语言链代码容器占用约110MB。例如需要实例化100个Java语言链代码,建议CCE节点规格为16核32GB。
  • 链代码实例化前需要将开发的链代码文件压缩成zip格式。
  1. 单击链代码列表“操作”列的“实例化”。
  2. 选择实例化通道、链代码版本、背书策略、背书组织列表等,填写链代码参数。

    说明:

    背书是指背书组织执行链码交易并返回一个提案响应给客户端应用的过程。背书策略则指明了需要通道中多少不同组织的成员根据指定智能合约执行和验证交易才能使一笔交易有效。因此,背书策略定义了必须“背书”(批准)提案执行的组织中的 Peer 节点。

    • 选择“下列任意组织背书”:只要任意一个背书组织为交易背书,交易即为有效。
    • 选择“下列全部组织背书”:只有所有背书组织为交易背书,交易才为有效。
    图5 链代码实例化

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

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

    在配置隐私保护时,请参照示例进行配置,其中:
    • name表示隐私数据空间的名称,此处为“collectionPrivateDetails”。

      在链代码中,若要将数据写入该隐私数据空间,需保证指定的隐私数据空间名称与此处定义一致,即:

      stub.PutPrivateData("collectionPrivateDetails", key, value)
    • policy表示隐私数据空间数据的访问策略,此处表示仅允许组织Org1和Org2的节点获取该隐私空间的数据。

      MSP标识获取方法:进入“通道管理”界面,在对应通道选择查看节点,切换组织,获取两个组织的MSP标识(如下图所示)。

      图6 查看节点的MSP
    • requiredPeerCount表示需要几个节点背书,并将隐私数据分发,此处为0表示自己背书。
    • maxPeerCount表示共识节点最大个数,起冗余备份作用,若其中1个共识节点不可用,其他共识节点可以响应获取隐私数据的请求,此处配置为3。
    • blockToLive表示可以保存的隐私数据最大块数,超过这个值,就会进行清除,若想无限存储,需要将该值设为0,此处设置为0。
    • memberOnlyRead默认设置为true,只有该选项为true时policy中的策略才生效。

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

    [    
      {        
        "name": "collectionPrivateDetails",
        "policy": "OR('<组织Org1的MSP标识>.member','<组织Org2的MSP标识>.member')",
        "requiredPeerCount": 0,
        "maxPeerCount": 3,
        "blockToLive": 0,
        "memberOnlyRead": true
      }
    ]

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

    说明:

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

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

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

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

更新链代码

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

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

链代码实例化错误码列表

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

表2 错误码列表

错误码

异常信息

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

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

6901

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

6902

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

6903

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

6904

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

6905

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

6906

磁盘空间不足

我们使用cookie来确保您的高速浏览体验。继续浏览本站,即表示您同意我们使用cookie。 详情

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容