T/SIA 037.1-2023 工业软件 容器镜像分发规范

ICS35.020

T/SIA

中国软件行业协会团体标准

T/SIA037.1—2023

工业软件容器镜像分发规范

IndustrialSoftwareContainerImageDistributionSpecification

2023-10-20发布2023-10-20实施

中国软件行业协会发布

T/SIA037.1—2023

目次

前言.................................................................................II

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

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

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

4缩略语..............................................................................2

5镜像分发系统结构....................................................................2

6合规性..............................................................................3

6.1合规性要求.......................................................................3

6.2工作流类别.......................................................................3

7版本兼容性.........................................................................10

7.1兼容性..........................................................................10

7.2版本回退选择....................................................................10

7.3版本升级选择....................................................................11

参考文献.............................................................................12

I

T/SIA037.1—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规

定起草。

本文件由中国软件行业协会提出并归口。

本文件起草单位：北京凯思昊鹏软件工程技术有限公司、北京中科院软件中心有限公司、合肥市智

能机器人研究院、合肥哈工轩辕智能科技有限公司、北京交通大学、江苏优智享智能制造有限公司、中

国科学院软件研究所、北京软件产品质量检测检验中心、国科元科技（北京）有限公司、中电金信软件

有限公司。

本文件主要起草人：陈鹏、夏科睿、丁亮、陶耀东、田今晨、孙素君、张斌、徐川川、李云翔、芮

建武、孔昊、王威、曲明成、张亚楠、张韬庚、李浥东、黄东华、周启明、李晓雷、王志鑫、张宇、陈

倩、李佳。

II

T/SIA037.1—2023

工业软件容器镜像分发规范

1范围

本文件规定了工业软件领域容器镜像分发的合规性要求，给出了工业软件领域容器镜像分发的工

作流类别种类和操作，确立了不同容器镜像版本兼容性的支持方案。

本文件适用于开展不同类型工业软件容器镜像分发的工作。

2规范性引用文件

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

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T11457-2006信息技术软件工程术语

ISO/IEC2382-2015信息技术词汇

3术语和定义

GB/T11457-2006、ISO/IEC2382-2015中确立的以及下列术语和定义适用于本文件。

3.1

容器镜像containerimage

一种在容器化环境中用于打包和分发工业软件应用的标准化结构。

注：改编自OCI(2021)《OCIImageFormatSpecification(image-spec)》，OCI标准中定义了容器镜像的结构和

元数据格式。

3.2

制品artifact

一种能够通过工业软件容器镜像分发规范推送和拉取的内容。

注：改编自OCI(2021)《OCIDistributionSpecification(distribution-spec)》，标准中定义了制品内容。

3.3

描述符descriptor

一种描述被引用内容的类型、元数据和内容地址的工具。

3.4

摘要digest

一种应用哈希函数对容器镜像的内容进行计算而得到的唯一标识符，可以用来验证容器镜像的完

整性和一致性，确保在容器镜像的分发和使用过程中没有被篡改或损坏。

3.5

镜像索引imageindex

1

T/SIA037.1—2023

一种在镜像服务器上建立的索引，用于记录镜像服务器上存储的文件信息，以便用户可以快速地找

到所需的文件。

3.6

镜像清单imagemanifest

一个描述容器镜像内容和元数据的文件，提供了关于镜像的详细信息，包括镜像的层次结构、配置

信息和元数据等。

3.7

镜像仓库registry

一个无状态的、高度可伸缩的服务器端应用程序，可以存储镜像，并允许分发镜像。

4缩略语

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

API：应用程序编程接口（ApplicationProgrammingInterface）

BLOB：二进制大对象（BinaryLargeObject）

HTTP：超文本传输协议（HypertextTransferProtocol）

URL:统一资源定位符（UniformResourceLocator）

UUID：通用唯一标识符（UniversalUniqueIdentifier）

5镜像分发系统结构

在软件开发和部署过程中，分发是指将软件或其相关组件从一个地点传递到另一个地点的过程。在

容器化环境中，容器镜像分发是将容器镜像文件从一个位置传输到其他地方的过程。容器镜像是一个轻

量级、可移植的软件包，包含了运行特定应用程序所需的所有组件、依赖项和配置信息。容器镜像分发

的目的是将这些容器镜像有效地传输给需要部署和运行这些应用程序的目标环境。

本规范中工业软件容器镜像的分发规定了四种工作流类别及其合规性要求，明确当前工业软件容

器镜像版本兼容性，包括回退及升级的操作。工业软件容器镜像分发系统结构如图1所示：

合规性

工作流类别

合规性要求拉取操作推送操作内容发现内容管理

版本兼容性

版本回退操作版本升级操作

图1工业软件容器镜像分发系统结构

2

T/SIA037.1—2023

6合规性

6.1合规性要求

分发合规性是指在工业软件容器镜像的拉取操作、推送操作、内容发现和内容管理等工作流类别中，

确保镜像仓库的操作符合相应的规范和要求。

在拉取工作流中，客户端可以从镜像仓库中拉取镜像。分发合规性要求镜像仓库必须具备支持拉取

操作的功能，以确保客户端能够安全、可靠地获取所需的镜像。

在推送工作流中，客户端可以将镜像推送到镜像仓库。分发合规性要求镜像仓库必须具备支持推送

操作的功能，同时符合相应的规范和要求，以确保推送的镜像符合安全性、可靠性和合法性的要求。

在内容发现工作流中，客户端可以列出或以其他方式查询存储在镜像仓库中的内容。分发合规性要

求镜像仓库必须提供相应的API，使客户端能够方便地发现和查询存储在仓库中的镜像内容。

在内容管理工作流中，客户端可以控制存储在镜像仓库中的内容的整个生命周期。分发合规性要求

镜像仓库必须支持相关的操作和管理功能，以确保镜像的存储、更新、删除等操作符合规范和要求。

符合分发合规性要求的镜像仓库必须实现以上提到的拉取操作、推送操作、内容发现和内容管理等

工作流类别的所有API，并且满足相应规范类别的要求。这样的镜像仓库能够保证镜像的安全性、可靠

性和合法性，同时提供方便的内容发现和管理功能，为用户提供优质的工业软件容器镜像分发服务。

6.2工作流类别

6.2.1拉取操作

拉取清单操作

拉取对象的进程以检索两个组件为主：清单和一个或多个blob。通常，拉取对象的第一步是检索

清单，可以以任何顺序在镜像仓库中检索内容。

要拉取清单，应按以下格式对URL执行GET请求：

/v2/<name>/manifests/<reference>

<name>指的是存储库的命名空间。<reference>必须是清单的摘要或标记。<reference>不得采用任

何其它格式。在本规范中，<name>必须匹配以下正则表达式：

[a-z0-9]+([._-][a-z0-9]+)*(/[a-z0-9]+([._-][a-z0-9]+)*)*

在本规范中，作为标签的<reference>的长度必须最多为128个字符，并且必须匹配以下正则

表达式：

[a-zA