中国软件行业协会团体标准 ICS 35.020 T/SIA T/SIA 037.1 —2023 工业软件 容器镜像分发规范 Industrial Software Container Image Distribution Specification 2023-10-20发布 2023-10-20实施 中 国 软 件 行 业 协 会 发 布 全国团体标准信息平台 全国团体标准信息平台 T/SIA 037.1 —2023 I 目 次 前言 ................................ ................................ ................. 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 全国团体标准信息平台 T/SIA 037.1 —2023 II 前 言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规 定起草。 本文件由中国软件行业协会提出并归口。 本文件起草单位：北京凯思昊鹏软件工程技术有限公司、北京中科院软件中心有限公司、合肥市智 能机器人研究院、合肥哈工轩辕智能科技有限公司、北京交通大学、江苏优智享智能制造有限公司、中 国科学院软件研究所、北京软件产品质量检测检验中心、国科元科技（北京）有限公司 、中电金信软件 有限公司 。 本文件主要起草人：陈鹏、夏科睿、丁亮、陶耀东、田今晨、孙素君、张斌、徐川川、李云翔、芮 建武、孔昊、王威、曲明成、张亚楠、张韬庚、李浥东、黄东华、周启明、李晓雷、王志鑫、张宇 、陈 倩、李佳。 全国团体标准信息平台 T/SIA 037.1 —2023 1 工业软件 容器镜像分发规范 1 范围 本文件规定了工业软件 领域容器镜像分发 的合规性要求，给出了工业软件 领域容器镜像分发的工 作流类别种类和操作，确立了不同容器镜像版本兼容性的支持方案 。 本文件适用于 开展不同类型工业软件容器镜像分发 的工作。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 11457 -2006 信息技术 软件工程术语 ISO/IEC 2382 -2015 信息技术 词汇 3 术语和定义 GB/T 11457 -2006、ISO/IEC 2382 -2015中确立的以及下列术语和定义适用于 本文件。 3.1 容器镜像 container image 一种在容器化环境中用于打包和分发 工业软件应用的标准化结构 。 注：改编自OCI(2021) 《OCI Image Format Specification (image -spec)》，OCI标准中定义了容器镜像的结构和 元数据格式。 3.2 制品 artifact 一种能够通过 工业软件容器镜像分发规范推送和拉取的内容。 注：改编自OCI(2021) 《OCI Distribution Specification (distribution -spec)》，标准中 定义了制品 内容。 3.3 描述符 descriptor 一种描述被引用内容的类型、元数据和内容地址 的工具。 3.4 摘要 digest 一种应用哈希函数对容器镜像的内容进行计算而得到的唯一标识符 ，可以用来验证容器镜像的完 整性和一致性，确保在容器镜像的分发和使用过程中没有被篡改或损坏。 3.5 镜像索引 image index 全国团体标准信息平台 T/SIA 037.1 —2023 2 一种在镜像服务器上建立的索引，用于记录镜像服务器上存储的文件信息，以便用户可以快速地找 到所需的文件 。 3.6 镜像清单 image manifest 一个描述容器镜像内容和元数据的文件 ，提供了关于镜像的详细信息，包括镜像的层次结构、配置 信息和元数据等。 3.7 镜像仓库 registry 一个无状态的、高度可伸缩的服务器端应用程序，可以存储镜像，并允许分发镜像 。 4 缩略语 下列缩略语适用于本文件。 API：应用程序编程接口 （Application Programming Interface ） BLOB：二进制大对象（ Binary Large Object ） HTTP：超文本传输协议（ Hypertext Transfer Protocol ） URL: 统一资源定位符 （Uniform Resource Locator ） UUID：通用唯一标识符 （Universal Unique Identifier ） 5 镜像分发系统结构 在软件开发和部署过程中，分发是指将软件或其相关组件从一个地点传递到另一个地点的过程。在 容器化环境中，容器镜像分发是将容器镜像文件从一个位置传输到其他地方的过程。容器镜像是一个轻 量级、可移植的软件包，包含了运行特定应用程序所需的所有组件、依赖项和配置信息。容器镜像分发 的目的是将这些容器镜像有效地传输给需要部署和运行这些应用程序的目标环境。 本规范中工业软件容器镜像的分发 规定了四种工作流类别 及其合规性要求， 明确当前工业软件容 器镜像版本兼容性 ，包括回退及升级的操作。工业软 件容器镜像分发 系统结构如图 1所示： 合规性 版本兼容性 版本回退操作 版本升级操作拉取操作 推送操作 内容发现 内容管理工作流类别 合规性要求 图1 工业软件容器镜像分发 系统结构 全国团体标准信息平台 T/SIA 037.1 —2023 3 6 合规性 6.1 合规性要求 分发合规性是指在工业软件容器镜像的拉取 操作、 推送操作、 内容发现和内容管理等工作流类别中， 确保镜像仓库的操作符合相应的规范和要求。 在拉取工作流中，客户端可以从镜像仓库中拉取镜像。分发合规性要求镜像仓库必须具备支持 拉取 操作的功能，以确保客户端能够安全、可靠地获取所需的镜像。 在推送工作流中，客户端可以将镜像推送到镜像仓库。分发合规性要求镜像仓库必须具备支持 推送 操作的功能，同时符合相应的规范和要求，以确保推送的镜像符合安全性、可靠性和合法性的要求。 在内容发现工作流中，客户端可以列出或以其他方式查询存储在镜像仓库中的内容。分发合规性要 求镜像仓库必须提供相应的 API，使客户端能够方便地发现和查询存储在仓库中的镜像内容。 在内容管理工作流中，客户端可以控制存储在