×

镜像 [image.openshift.io/v1]

描述

镜像是在特定时间点对容器镜像和元数据的不可变表示。镜像通过对其内容(元数据和内容)进行哈希命名,任何格式、内容或元数据的更改都会导致新的名称。镜像资源主要供集群管理员和集群镜像注册表等集成使用 - 最终用户改为通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中,但任何实现容器镜像注册表 API 的集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageSignature [image.openshift.io/v1]

描述

ImageSignature 包含镜像的签名。只要签名受信任,它就可以验证镜像身份和可能的其他声明。基于此信息,可以将可运行镜像限制为与集群范围策略匹配的镜像。客户端执行镜像验证时应解析必填字段。其他字段由服务器从签名的内容中解析。它们仅具有信息性目的。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageStreamImage [image.openshift.io/v1]

描述

ImageStreamImage 代表从 ImageStream 中按镜像名称检索的镜像。用户界面和普通用户可以使用此资源访问镜像流历史记录中标记镜像的元数据详细信息以进行查看,因为最终用户无法直接访问镜像资源。如果 ImageStream 中的任何标记都没有引用此类镜像,则会返回未找到错误。当设置镜像流上的 spec 标记来表示外部注册表中的镜像、推送到集成注册表或将现有镜像从一个镜像流标记到另一个镜像流时,会创建镜像。镜像流镜像的名称采用“<STREAM>@<DIGEST>”的形式,其中 digest 是镜像的内容可寻址标识符 (sha256:xxxxx…)。您可以使用 ImageStreamImages 作为镜像流规范标记的 from.kind 来精确引用镜像。ImageStreamImage 端点上仅支持检索镜像的操作。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageStreamImport [image.openshift.io/v1]

描述

镜像流导入资源为用户提供了一种简单的方法,可以从其他容器镜像注册表中查找并导入容器镜像到服务器。可以导入单个镜像或整个镜像仓库,用户可以在将生成的镜像标记到指定的镜像流之前查看导入结果。

此 API 旨在用于需要在导入之前查看镜像元数据(例如,从中生成应用程序)的最终用户工具。知道所需镜像的客户端可以继续直接在其镜像流中创建 spec.tags。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageStreamLayers [image.openshift.io/v1]

描述

ImageStreamLayers 描述了此镜像流中镜像引用的层信息。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageStreamMapping [image.openshift.io/v1]

描述

ImageStreamMapping 表示从单个镜像流标签到容器镜像的映射,以及镜像来源的容器镜像流的引用。特权集成者使用此资源来创建镜像资源并将其与状态标签字段中的镜像流关联。创建 ImageStreamMapping 将允许任何可以查看镜像流的用户标记或拉取该镜像,因此仅在用户已证明他们可以直接访问镜像内容时才创建映射。此资源支持的唯一操作是创建,并且元数据名称和命名空间应设置为包含应更新的标签的镜像流。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageStream [image.openshift.io/v1]

描述

ImageStream 存储标签与镜像的映射、在流中标记镜像时应用的元数据覆盖以及对注册表上容器镜像仓库的可选引用。用户通常更新 spec.tags 字段以指向外部镜像(这些镜像使用您命名空间中具有 pull secret 类型的凭据从容器注册表导入),或指向可立即访问以进行标记或拉取的现有镜像流标签和镜像。应用于标签的镜像历史记录在 status.tags 字段中可见,任何可以查看镜像流的用户都可以在其自己的镜像流中标记该镜像。访问从集成注册表拉取镜像的权限是通过在给定镜像流上拥有“get imagestreams/layers”权限来授予的。用户可以通过删除 imagestreamtag 资源来删除标签,这会导致该标签的 spec 和 status 都被删除。镜像流历史记录将保留,直到管理员运行 prune 操作,该操作将删除不再使用的引用。要保留历史镜像,请确保 spec 中有一个标签指向该镜像及其摘要。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageStreamTag [image.openshift.io/v1]

描述

ImageStreamTag 表示从 ImageStream 中按标签名称检索的镜像。使用此资源通过标签与镜像流中的标签和镜像进行交互,或查看特定标签的镜像详细信息。与该资源关联的镜像是最新的成功标记、导入或推送的镜像(如该标签的镜像流 status.tags.items 列表中所述)。如果导入正在进行或已失败,则将显示之前的镜像。删除镜像流标签将清除镜像流的 status 和 spec 字段。如果无法为给定标签检索镜像,则将返回“未找到”错误。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

ImageTag [image.openshift.io/v1]

描述

ImageTag 表示镜像流中的单个标签,包括 spec、状态历史记录以及提供的标签的当前引用镜像(如果有)。此类型通过提供标签的全视图来替换 ImageStreamTag。对于镜像流上存在的每个 spec 或 status 标签,都会返回 ImageTags。如果任一形式都不存在标签,则 API 将返回“未找到”错误。如果尚未定义 spec 标签并且已设置 spec 字段,则创建操作将成功。删除将从镜像流中删除 spec 和 status 元素。

兼容性级别 1:在主要版本内稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

SecretList [image.openshift.io/v1]

描述

SecretList 是 Secret 的列表。

类型

对象