工业互联应用构件开发规范_第1页
工业互联应用构件开发规范_第2页
工业互联应用构件开发规范_第3页
工业互联应用构件开发规范_第4页
工业互联应用构件开发规范_第5页
已阅读5页,还剩16页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

ICS

团体标准

T/BIAIMXXXXX—20XX

工业互联应用构件开发规范

DevelopmentSpecificationforIndustrialInternetApplicationComponents

(征求意见稿)

20XX-XX-XX发布20XX-XX-XX实施

北京智能制造创新联盟发布

T/BIAIMXXXXX-20XX

目次

前言...............................................................

1范围......................................................................................1

2规范性引用文件............................................................................1

3术语和定义................................................................................1

4缩略语....................................................................................1

5应用构件架构..............................................................................1

41概述..................................................................................1

工9构件主体..............................................................................2

,口关联依赖..............................................................................2

工4存储中心..............................................................................2

工S构件接口............................................................................2

工6基础信息..............................................................................2

S.7测试用例..............................................................................2

12与外部系统交互.......................................................................2

4Q构件运行时...........................................................................3

6开发要求..................................................................................3

fi.1开发流程..............................................................................3

fi.9环境资源要求.........................................................................3

fi.1设计要求..............................................................................3

64构件定义..............................................................................4

fi.S构件接口定义.........................................................................6

fi6构件封装.............................................................................11

A7构件测试.............................................................................12

K.H构件发布.............................................................................13

附录A(资料性)yaml文件的关键配置信息示例.......................................14

附录B(资料性)values.yaml文件的关键配置信息示例................................15

I

T/BIAIMXXXXX—20XX

工业互联应用构件开发规范

1范围

本文件规定了企业研发制造资源共享服务平台上应用构件的架构和开发要求,并给出了构件封装

的关键配置信息示例。

本文件适用于指导企业研发制造资源共享服务平台上应用构件的开发和测试。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,

仅该日期对应的版本适用于本文件;不注U期的引用文件,其最新版本(包括所有的修改单〉适用于本

文件。

GB/T36455—2018软件构件模型

3术语和定义

下列术语和定义适用于本文件。

31

构件component

软件系统中具有相对独立功能、可以明确辨识、接口由契约指定、和语境有明显依赖关系、可独立

部署的可组装软件实体。

构件接口componentinterface

软件构件对外交流和交互的唯•通道。

构件库componentIibrary

一种支持软件复用的基础设施。它提供对软件构件进行描述、分类、存储和检索等功能。

4缩略语

下列缩略语适用于本文件。

CI:持续集成(ContinuousIntegration)

CD:持续交付(ContinuousDelivery)与持续部署(ContinuousDeployment)

UAT:用户验收测试(UserAcceptanceTesting)

API:应用程序接口(ApplicationProgrammingInterface)

YAML:YAMLAin'taMarkupLanguage的递归缩写,一种数据序列化标准

5应用构件架构

51概述

应用构件为企业提供各类工业互联应用服务,支持直接或组合应用,应用构件由构件主体、构件存

储中心、关联依赖、基础信息和构件接口五个部分组成,应用构件架构如图1所示。

1

T/BIAIMXXXXX—20XX

测试用例

用例媳号

关却獭基础信息构件接口

组件依赖框架依赖ID名称版本人

测试标题交

数嵬依赖创建时间接口定5L互

重要级别

版本依赖开发者类型..口

预置条件

构件主体数

测试输入控

搽作步歌口

存储中心数据库分布式存信

预期输出

构件运行时

图1应用构件架构图

5.:构件主体

构件主体是构件的核心部分,包含实现特定功能或服务的代码,编程语言包括Java、Pythor、

JavaScript等,具体取决于构件的需求和团队的技术栈。

5.2关联依赖

关联依赖是构件在运行时或编译时所需的其他库、框架、服务或数据,这些依赖项可以是内部的(例

如构件库中的其他构件)或外部的(例如第三方库或API),为了确保构件的可移植性和一致性,所有

依赖项都应被明确列出,并且应通过版本控制系统(如Maven、npm、Pip等)进行管理。

5.4存储中心

存储中心是应用构件的存储仓库.鱼贵存储应用构件的各种数据,提供高效的数据检索能力,并保

证数据一致性和安全性。

5.*构件接口

构件接口定义构件与其他构件或外部系统之间的交互方式,此外,接口还可以用于生成文档和进行

代码自动生成,简化开发过程。

弓A基础信息

基础信息描述构件的详情和基本信息,包含构件的基本情况和功能特点,便于用户在需要时选择合

适的构件进行部署和使用。

57测试用例

测试用例用于验证构件功能的正确性,包括一系列自动化测试脚本和测试步骤,用于确保构件在不

同条件下都能按预期工作,测试用例应覆盖构件的所有主要功能点、边界条件和异常处理逻辑,通过使

用持续集成(CI)工具,可以自动运行测试用例,确保在每次代码更改后都能及时发现问题。

5.fl与外部系统交互

构件与外部系统交互可以是同步的,也可以是异步的,具体取决于构件的设计和实现。在交互过程

中,构件需要确保数据的正确性和一致性,并处理可能出现的错误和异常情况。

2

T/BIAIMXXXXX—20XX

5.G构件运行时

构件运行时表示构件运行时环境,包括必要的资源、库和框架等,是用于创建、管理和运行构件的

工具。

6开发要求

6.1开发流程

如图2所示,应用构件的规范化开发能膨使企业统一、灵活、简便地使用和组合各种应用。应用构

件的开发流程如下:

a)构件定义,根据使用需求,开发人员进行构件开发,并且根据构件标准化格式进行构件的修改

和调整:

b)构件接口定义,利用构件接口规则,对构件接口进行规范化开发;

c)构件封装,进行构件代码质量检查后,对符合构件设计标准的构件进行打包生成构件镜像和

Chart格式:

d)构件测试,将应用构件镜像通过CI/CD自动部署到测试环境,系统自动完成UAT测试、功能测

试和性能测试;

0)构件发布,将拥有标准接口的构件推送到构件库,并进行构件版本控制,以供不同需求用户匹

配使用。

其中,步骤a-b由构件开发者按照标准化定义格式完成,步骤c-e由平台根据开发者提交的构件源

文件自动完成。

图2应用构件开发流程

A9环境资源要求

本文件定义的应用构件以容器方式运行,支持以下运行环境:

----Docker:

----Kubernetes;

----Nodc-RED:

——0CI;

----rune;

----CRI-Oo

A?设计要求

应用构件的设计应符合下列要求:

——每个构件应只关注一个特定的业务功能,避免将多个不相关的功能集成在一个应用构件中:

——支持代码编辑环境,包括常规配置、代码编辑等设置选项;

----支持构件版本向下兼容:

——支持构件参数的修改,能让用户根据个人需求修改构件;

3

T/BIAIMXXXXX—20XX

一一明确日志规范,规定日志输出的格式和应当包含的内容:

一一支持多个应用构件的关联组合:

一一支持企业快速构建、构件动态扩展和多应用场景迁移:

——支持应用构件的调用和部署:

一一提供在线开发和离线开发上传的方式:

----支持多个协同在线开发。

64构件定义

6.4.1构件分类

根据功能和结构特性,构件可以划分为不同的类别,包括:

——基础构件,提供基本的计算、存储、通信等底层服务,包括数据可视、消息构件、报警构件、

算法模型、成分分析模型等;

-业务构件,实现常见的业务逻辑、数据处理等功能,包括物料跟踪、设备管理、运维巡检、辅

助调度、计算服务、工艺优化、检测报告智能生成等:

-智能构件,具有更强的专业性,包括故障诊断、故障预警、能耗分析、设备画像、健康维护、

安全检测、设备定位等。

6.4.2构件文件目录

构件在开发时需要遵循一定的文件组织规范,如图3所示,分别存放构件测试用例、构件主体、构

件关联依赖、构件存储中心、构件接口和构件基础信息六个部分,其余部分的文件组织形式不做规范要

求,模型开发者可进行个性化开发。

测试用例依籁列表构建脚本接口列表具体定义

图3应用构件文件目录

6.4.3构件主体

构件主体包含构件的全部功能代码,用于实现构件的主要功能和业务逻辑,根据用户需求,明确应

用构件的需求场景和实现功能,应满足以下要求:

一一代码编写规范,可读性高:

——拥有明确的功能,具有实际应用意义:

只关注单•的功能或服务,便于复用和维护;

——对每个关键语句单独说明,并提供错误提示;

——具备数据备份和数据恢复策略,确保数据的可靠性;

-提供错误的报警和基础错误的恢复功能,便于用户使用。

6.4.4构件测试用例

4

T/BIAIMXXXXX—20XX

构件测试用例是构件测试中的核心组成部分,用于验证构件是否满足规定的需求和功能。测试用例

的设计和实现应遵循一系列的要求,以确保测试的全面性和有效性。测试用例应满足以下要求:

-需求覆盖,测试用例应覆盖所有的需求点,确保被测功能100%被覆盖:

——正确性验证,验证正确性操作、正常数据和可能导致出错的数据、操作:

一—数据值域覆盖,有数据值域的必须考虑数据值域覆盖.,包括边界值利等价类,所有边界值都必

须覆盖,等价类必须包含有效和无效等价类,目等价类各子类不存在交错以避免冗余,同时,

等价类的使用应避开边界值重叠的情况:

一—明确性,测试用例中的描述应清晰明确,不存在二义性或名义性,不会因执行人不同而产生不

同执行结果:

预期结果,每个测试用例都应有明确的预期结果,便于准确判断是否符合要求。

测试用例编写应包含以下要素:

a)用例编号,具有唯一性,通常由字符和数字组成的字符串,易于识别。不同阶段的测试用例应

有不同的编号规则;

b)测试项目,对应测试用例编号中的测试子项名,可以是功能点、性能指标、界面控件等:

c)测试标题,简要说明测试用例的出发点、关注点以及期望的测试结果:

d)重要级别,根据测试用例的重要程度进行划分,如高、中、低等级别,便于制定测试规程和同

归测试:

e)预置条件,测试用例在执行前需要满足的前提条件,包括环境设置、其他测试用例的执行结果

等;

f)测试输入,测试用例执行过程中需要加工的外部信息,如手工输入、文件、数据库记录等;

g)操作步骤,执行当前测试用例需要经过的操作步骤,需要明确的给山每•个步骤的描述;

h)预期输出,测试用例执行后的预期结果,包括界面显示、数据库变化、相关信息变化等。

6.4.5构件关联依赖

构件关联依赖包括:

一组件依赖,可能依赖于其也构件提供的功能或服务,或是依赖于各种第三方库,如数学计算库、

数据库连接库、网络通信库等:

——框架依赖,包含运行的系统和计算框架,如Spring、Django等,这些框架本身可能包含多个

库和组件,需要依赖这些框架来构建和运行:

——数据依赖,可能依赖于配置文件中的参数或设置运行:

——环境依赖,可能需要在特定的硬件环境上运行;

一一版本依赖,可能依赖于特定版本的构件或库.

6.4.6构件存储中心

存储中心应支持:

----数据库,采用关系型数据,率(如MySQL、PoslgreSQL)或非关系型数据库(如MongoDB^Cassandra)

等技术来实现数据存储利管理:

-分布式存储,对于需要处理大量数据或具有高可用性和容错性要求的构件,采用分布式存储

(如Hadoop、Cassandra等)来实现数据存储和扩展性:

一缓存,为了提高数据访问速度,采用缓存技术(如Redis、Memcached等)来存储常用的数据

或查询结果。

6A7构件基础信息

构件基础信息用于标识、描述和管理构件,构件基础信息包括:

a)ID,唯一标识构件的编号;

b)名称,正式名称;

c)类型,构件所属的类别:

d)详情,描述构件功能和使用方法:

e)用途,主要用途或应用场景;

f)接口定义,构件提供的接口的定义,包括输入输出、接口说明等:

T/BIAIMXXXXX—20XX

g)定价,用户使用构件需要支付的金额:

h)开发者,开发人员;

i)创建时间,构件开发的时间;

j)版本,用于区分不同版本的构件。

A5构件接口定义

6.5.1接口描述规则

构件接口是对外交互的唯一通道,是构件外部可见行为的描述。应用构件的接口描述规则如下:

----协议规范:采用https或http协议:

一一域名规范:接口有且仅有一个域名和端口:

——API路径规范:为了和其他路径区分,必须在路径中添加api目录;

一版本控制规范:正式版本的服务组件应确定接口版本,备份接口代码,并在接口路径中加入版

本信息:

一一API命名规范:url为域名规范+API路径规范+版本控制规范:

——方法规范:采用http标淮方法,如GET,POST,PUT,DELETE等;

——请求参数规范:公共数据使用GET方式请求,私有数据使用POST方式请求,尽量全部用POST,

请求头据需求添加配置参数;

-接口数据格式规范:使用JSON或者XML格式数据。

6.5.2接口规范

构件接口应规范化定义,如图4所示,一个应用构件的接口应包含:

a)接口描述字段,对该接口的功能和作用进行较为详细的阐述,使用户能够了解如何与该接口对

接;

b)请求地址字段,该请求从什么地方发出;

c)请求方式字段,该请求以什么协议发出:

d)资源描述字段,该接口需要何种资源,实际体现为该构件需要什么请求参数,同时还需要在此

字段对具体的返回参数进行说明,并且给出一个正常的返回示例;

e)资源地址字段,资源存储在公共地址,构件访问该地址进行资源的获取:

f)模型调用字段,写明构件将调用什么模型。

"interfaceDes":(接口描述,讲明功能和作用)

urequestAdd":"http:〃localhost:8080/service”,(数据发送地址)

MrequestProM:"http”,(数据发送协议)

“resourceDesM:"timestamp,file”,(资源描述,包括资源类型和所需

的参数)

"resourceAdd":("timestamp":"http://localhost:8080/resource","—":(对

应参数的获取地址)

"model":"",(使用的智能模型)

}

图4应用构件接口json格式图

6.5.3接口分类

应用构件通用接口模型如图5所示,通用接口主要分为:

人机交互接口,用于用户与构件之间进行交流和指令交互,包括查询构件信息和查询构件状态

等:

-数据接口,用于数据的传输,包括向应用构件输入数据、从外部数据源获取数据、从应用构件

输出数据等;

——控制接口,用于对数据传输进行控制和管理,包括修改构件参数、运行控制等:

T/BIAIMXXXXX—20XX

-第三方工具接口,用于连接第三方工具,如依赖关系的构件、智能模型,进行实时数据处理、

信息与健康检测等。

构件信息、构件状态

控制参数、启停控制

图5应用构件通用接口模型

6.5.4接口定义

应用构件接口定义见表1:

表1应用构件通用接口说明表

接口类型接口描述接口名称功能说明

查询构件信息Getlnfo查看构件详情

人机交互接口

查询构件状态GetCon查看构件运行状态

输入数据InputData向构件输入数据

数据接口外部数据调用GetEnternalData从外部数据源获取数据

输出数据OulpulData从构件输出数据

修改参数ChangeOP上传和修改构件运行参数

控制接口

运行控制ControlRun控制构件运行过程

依赖连接ConnectTool连接其他构件或第三方应用工具

实时数据分析工具集成RcalTimeTool与实时数据分析工具集成

第三方工具接口在构件自动化部署时,使用Liveness

Prchc和ReadinessProbe进行容盟健席

信息与健康检测,总集成HealthTool

信息检测:在模型运行时反馈模型维

节,控制参数等

6.5.5输入输出数据类型

各类接口涉及的输入输出数据类型包括:

----command类,为命令;

T/BIAIMXXXXX—20XX

---number类,为数字:

---string类,为字符串:

---image类,为图片;

---voice类,为音频:

---video类,为视频;

---file类,为文件:

——zip类,为压缩包。

6.5.6人机交互接口

6.5.6.1查询构件信息接口

查看构件详情的接口说明见表2。状态码用于判断执行结果是否成功。

表2查询构件信息接口说明

接口定义StringGetInfo(StringComName)

URLhttp://localhost:8080/GetInfo

请求方式GET

参数构件名称ComName

状态码

返回内容

构件详情ComInfo

6.5.6.2查询构件状态接口

查看构件运行状态,如是否正在运行、已完成、失败等,接口说明见表3。

表3查询构件状态接口说明

接口定义StringGetCon(StringComName)

URLhttp://localhost:8080/GetCon

请求方式GET

参数构件名称ComName

状态码

返回内容

构件状态ComCon

6.5.7数据接口

6.5.7.1输入数据接口

向构件输入数据的接口说明见表4。T概括了所有6.5.5中列举的数据类型,具体使用的数据由桧件

功能决定,输入数据接口应支持大数据处理任务。

表4揄入数据接口说明

接口定义StringInputData(StringComNamc.TInData)

URLhttp://localhost:8080/InputData

请求方式POST

构件名称ComName

参数

输入数据InData

8

T/BIAIMXXXXX-20XX

返向内容状态因

6.5.7.2外部数据调用

从指定数据源(如公共数据库、云•服务、第三方API等)获取数据的接口说明见表5。

表5外部数据调用接口说明

接口定义StringGetEnternalData(SuingConiName.SuingSource.StringOPName)

URLht(p://localhost:8080/GetEnternalData

请求方式POST

构件名称ComName

参数数据源标识Source

查询参数OPName

返回内容状态码

6.5.7.3输出数据接口

从构件输出数据的接口说明见表6。

表6输出数据接口说明

接口定义TOutpulData(SiringComName)

URLh(ip://)ocalhost:8080/OutputData

请求方式GET

参数构件名称ComName

状态码

返回内容

输出数据OutData

6.5.8控制接口

6.5.8.1修改参数接口

上传和修改构件运行参数的接口说明见表7。

表7修改参数接口说明

接口定义StringChangcOP(SlringComName.SlringOPName.TOPNum)

URLht(p://iocalhosl:8080/ChangeOP

诂求方式POST

构件名称ComName

参数参数名称OPName

参数值OPNum

返回内容状态码

6.5,8.2运行控制接口

T/BIAIMXXXXX—20XX

控制构件的运行,如启动和停止操作,接口说明见表8。

表8运行控制接口说明

接口定义StringControlRun(StringConiName)

URLhltp://localhos(:8080/Conlro.Run

请求方式POST

参数构件名称ConiName

返回内容状态码

6.5.9第三方工具接口

6.5.9,1依赖连接接口

连接其他构件或第三方应用工具,如深度学习模型等,接口说明见表9。

表9依赖连接接口说明

接口定义StringConnectTool(StringComName,StringToolName)

URLhttp://localhost:8080/Conncc:T(x)l

请求方式POST

构件名称ComNaine

参数

第三方工具名称ToolName

返回内容状态码

6.5,9.2实时数据分析工具集成接口

与实时数据分析工具(如Stonn、Flink等)进行集成,支持实时数据分析和处理,接口说明见表10。

表10实时数据分析工具集成接口说明

接口定义StringRealTimeTooKStringConiName.SlringToolConfig)

URLhttp://localhost:8080/RealTinieTool

请求方式GET

构件名称ConiName

参数

工具连接配置ToolConfig

状态码

返回内容

数据分析结果AnalysisData

6.5,9.3信息与健康检测工具集成接口

在构件自动化部署时,使用LivenessProbe和ReadinessProbe进行容器健康信息检测;在模型运行时

反馈模型细节,控制参数等,接口说明见表11。

表11信息与健康检测工具集成接匚说明

接I」定义StringHeallhTooKStringComName.StringToolConfig)

URLht(p://localhost:8080/Heal(hTool

1C

T/BIAIMXXXXX-20XX

请求方式GET

构件名称CoinName

参数

工具连接配置ToolConfig

状态码

返回内容

构件运行信息Runinfo

AA构件封装

6.6.1概述

本文件按照技术实现的逻辑顺序和构件间的调用关系,将构件封装划分为镜像封装和Charts封装

两个步骤,如图6所示。

图6应用构件封装总体设计

6.6.2容器化封装

容器化封装过程如下:

a)收集构件与构件接口信息,对配置信息进行标准化整合,判断配置信息的正确性,如果不正确,

则向构件开发者反馈偌误信息以供修改,

b)如果正确,则通过构件信息进行yaml文件的自动化编写。

c)根据yaml文件进行模型镜像自动化封装。

yaml文件的关键配置信息示例见附录A。

6.6.3Chart文件目录

Charl代码文件目录包括:

a)templates/,模板文件,存放Kubernetes资源文件,如DeploymentsService、Ingress%

ConfigMap>Secrets等;

b)values,yaml,定义Chart的默认配置值:

c)Chart,yaml,核心配置文件,定义Chart的基本信息(如名称、版本、描述等)以及依赖关系,

包含name、version、description'icon、sources、maintainers^dependencies等字段:

d)README,md,介绍文档。

values,yaml文件的关键配置信息示例见附录B。

6.6.4Chart封装

应用构件的Chart封装过程如下:

a)获取容器化封装后容器服务的端口、健康检测接口等关跳信息:

b)编写资源定义文件,使用YAML格式编写资源定义文件,并放置在te叩lates/目录下:

11

T/BIAIMXXXXX—20XX

c)创建Chart,yaml文件,在Chart的根目录下创建Chart,yaml文件,并填写Chart的基本信

息,如名称、版木、描述和依赖等;

d)创建values,yaml文件,在Chart的根目录下创建values,yaml文件,并定义Chart的配置

参数:

e)编写README.md文件,根据需要,编写README,md文件,描述Chart的使用方法和注意事项;

f)打包Chart,将Chart打包成.tgz格式的文件,完成Chart封装。

67构件测试

6.7.1概述

构件测试是对构件性能进行评估和对构件功能进行验证的方法,本文件的构件测试在Kubernetes集

群中完成,主要包括UAT测试、功能测试和性能测试。

6.7.2UAT测试

构件开发完成后,由相关的用户或独立测试人员根据测试计划和结果对构件进行测试和接收。这一

阶段的测试旨在验证构件是否满足业务需求、功能要求以及用户期望,确保软件在实际应用中的稳定性

和可靠性,LAT测试主要包括:

——验证功能完整性,确保所有规定的功能按预期工作,无遗漏或错误;

——确认用户满意度,用户对构件的使用体验感到满意,界面友好,操作便捷;

一—发现并修复缺陷,在发布前识别并解决潜在的问题,确保构件质量;

——业务流程验证,确认构件支持的实际业务流程无误,符合业务需求。

6.7.3功能测试

功能测试用于验证构件在实际业务场景中的表现,根据开发者提交的测试用例模拟用户请求并验

证构件响应的正确性,功能测试主要包括:

—边界值测试,测试构件在极限情况下的响应和表现,即测试边界值处的构件行为是否符合规范;

-等价类划分测试,将各和输入值看做是几个等价类,选取一个代表性的值进行测试:

——冒烟测试,运行构件的核心功能,检查构件是否能够启动、执行基本操作和完成基本任务等:

一一面向场景测试,定义不同的测试场景来验证构件的功能和行为。

6.7.4性能测试

性能测试用于评估构件在各种负载条件下的响应时间、吞吐量、资源利用率等性能表现,测试方式

包括:

-负载测试,通过不断增加并发用户数或交易量,观察构件的响应时间、吞吐量等性能指标的变

化情况,以评估构件在特定负载下的性能表现:

一压力测试,通过模拟极端负载条件,测试构件在资源饱和或过载情况下的性能表现,以评估稳

定性和容错能力:

一并发测试,模拟多用户同时部署构件的场景,测试系统在并发访问下的性能表现,以发现潜在

的并发问题,如死锁、资源争用等;

——基准测试,在特定软硬件和网络环境下,模拟一定数量的虚拟用户运行一种或多种业务,将测

试结果作为基准线数据,用于后续的性能调优或系统评测;

-稳定性测试,在特定负载条件下,长时间运行构件,观察其性能指标的稳定情况,以评估系统

的长期运行稳定性。

6.7.5测试工具

构件测试在Kubernetes集群环境中完成,为了实现构件的自动测试,可以使用以下工具:

——KUTTL;

----Kubcmark;

----Clusterloader2;

----Popeye;

12

T/BIAIMXXXXX—20XX

----Kubescapc;

----Mirrord;

----Kube-1inter:

----Prometheus+Grafana:

----Sysdigo

6.8构件发布

6.8.1发布流程

构件通过测试后使用HTTF7HTTPS通信协议符封装后的构件文件传输到构件库,完成构件的发布,

发布过程如下:

a)系统前端收集开发好的应用构件信息,向后端发送发布请求;

b)系统后端完成模型镜像的打包,封装为【mage和Charts格式;

c)使用IITTP/HTTPS通信协议将封装好的构件上传到构件库中:

d)构件发布完成,向开发者返回发布结果,用户可以在构件库中查看发布的构件。

在构件发布的过程中需要完成开发者的身份验证,只有注册的开发者才能够进行构件的发布。

6.8.2版本控制

构件的版本控制是确保构件稳定性和可追溯性的重要手段。版本控制过程如下:

a)版本号的定义,版本号格式为“主版本号.修订号”,其中,.主版本号当添加构件新功能时递

增,修订号当进行向卜.兼容的问题修复时递增:

b)版本发布,详细记录本次版小史新的内容、修麦的问题和新增的功能,通过测试后根据正式发

布版本的命名规则进行构件新版本发布,并通知相关人员;

c)版本控制工具的使用,使用Git、Mercurial等分布式版本控制工具管理不同的版本。

13

T/BIAIMXXXXX—20XX

附录A

(资料性)

yamI文件的关键配置信息示例

yaml关键配置信息示例如下:

FROMPytorch/Pylorch:latest#Mpylorch、lensorflow等基础镜像进行运行环境搭建

LABELkeys="Serviceinterfaceandcomponentparameterinformation”

#将服务接口信息与构件参数言息通过LABEL进行传递

Instal1basicbuildingtoolsanddependencies

BuildGolangruncnvironnicnt#配置Golang运行环境

Down1oadGolangandinstallit

ConfigureGolangenvironmentvariables

BuildATModelrunenvironmentM±/.Python模型运行环境

InstallingPythonandnecessaryconfigurations

pipinstall-rrequirements,txt

BuildGoproject,compileproject#由于服务由Go语言搭建,因此需要搭建Go项目

EXPOSEScrviccPort#暴露服务访问端口号

CMD/ComponentSerivce"]#在容器启动同时启动构件服务

14

T/BIAIMXXXXX—20XX

附录B

(资料性)

values,yamI文件的关键配置信息示例

yaml关键配置信息示例如下:

image:#镜像存储位置信息

repository:http:localhost:8080/1ibra

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论