第 8 章 ImageStream [image.openshift.io/v1]

描述

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

兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。

类型

对象

8.1. 规格

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`
`spec`	`对象`	ImageStreamSpec 代表 ImageStreams 的选项。
`status`	`对象`	ImageStreamStatus 包含有关此镜像流状态的信息。

8.1.1. .spec

描述: ImageStreamSpec 代表 ImageStreams 的选项。
类型: object

属性	类型	描述
`dockerImageRepository`	`字符串`	dockerImageRepository 是可选的，如果指定此流由这个服务器上的容器存储库支持，则已弃用：此字段自 v3.7 起已弃用，并将在以后的版本中删除。通过 spec.tags.from 引用指定要在每个标签中导入的标签的源。
`lookupPolicy`	`对象`	ImageLookupPolicy 描述了如何使用镜像流来覆盖命名空间中 pod、构建和其他资源所使用的镜像引用。
`tags`	`array`	标签将任意字符串值映射到特定的镜像 locators
`tags[]`	`对象`	TagReference 指定镜像的可选注解，以及对 ImageStreamTag、ImageStreamImage 或 DockerImage 此标签应跟踪的可选引用。

8.1.2. .spec.lookupPolicy

描述

ImageLookupPolicy 描述了如何使用镜像流来覆盖命名空间中 pod、构建和其他资源所使用的镜像引用。

类型

object

必填

local

属性	类型	描述
`local`	`布尔值`	本地将在与此镜像流匹配时，将此命名空间中的对象上的 docker 短镜像引用（如"mysql"或"php:latest"）更改为镜像 ID，而不是到达远程 registry。如果找到，该名称将完全限定到镜像 ID。标签的 referencePolicy 被考虑在替换的值中。仅在当前命名空间中工作。

8.1.3. .spec.tags

描述: 标签将任意字符串值映射到特定的镜像 locators
类型: array

8.1.4. .spec.tags[]

描述

TagReference 指定镜像的可选注解，以及对 ImageStreamTag、ImageStreamImage 或 DockerImage 此标签应跟踪的可选引用。

类型

object

必填

name

属性	类型	描述
`annotations`	`对象（字符串）`	可选；如果指定，注解应用于通过 ImageStreamTags 检索的镜像。
`from`	`ObjectReference`	可选；如果指定，对此标签应指向的另一个镜像的引用。有效值为 ImageStreamTag、ImageStreamImage 和 DockerImage。ImageStreamTag 引用只能引用此同一 ImageStream 中的标签。
`generation`	`整数`	generation 是跟踪对 spec 标签（用户意图）的计数器。当修改标签引用时，生成会被设置为与当前流生成匹配（每次 spec 被更改时递增）。镜像导入程序等系统中的其他进程会观察到生成 spec 标签比状态中记录的生成更新，并使用该标签作为触发器导入最新的远程标签。要触发新导入，客户端可能会将此值设置为 0，这会将生成重置为最新的流生成。传统客户端将此值作为 nil 发送，它将与当前标签生成合并。
`importPolicy`	`对象`	TagImportPolicy 控制如何导入与此标签相关的镜像。
`name`	`字符串`	标签的名称
`reference`	`布尔值`	如果导入了标签，引用状态。默认值为 false，这意味着将导入标签。
`referencePolicy`	`对象`	TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器被解决时，会生成此镜像流标签中的镜像的 pull-specs。这允许镜像流作者控制如何访问镜像。

8.1.5. .spec.tags[].importPolicy

描述: TagImportPolicy 控制如何导入与此标签相关的镜像。
类型: object

属性	类型	描述
`importMode`	`string`	importMode 描述了如何导入镜像清单。
`insecure`	`布尔值`	如果服务器可以在镜像导入过程中绕过证书验证或直接连接到 HTTP，则不安全。
`scheduled`	`布尔值`	scheduled 表示此标签应定期检查的服务器，以确保它保持最新状态并导入

8.1.6. .spec.tags[].referencePolicy

描述

TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器被解决时，会生成此镜像流标签中的镜像的 pull-specs。这允许镜像流作者控制如何访问镜像。

类型

object

必填

type

属性	类型	描述
`type`	`字符串`	Type 决定在部署配置触发器或新构建中使用镜像流标签时，应如何转换镜像拉取 spec。默认值为 `Source`，表示应使用镜像的原始位置（如果导入）。用户也可以指定 `Local`，这表示 pull spec 应该指向集成的容器镜像 registry，并利用 registry 将拉取代理到上游 registry 的功能。local 允许拉取此镜像的凭证从镜像流的命名空间中管理，因此平台中的其他用户可以访问远程镜像，但不能访问远程 secret。它还允许镜像层镜像到本地 registry 中，即使上游 registry 不可用，仍然可以拉取镜像。

8.1.7. .status

描述

ImageStreamStatus 包含有关此镜像流状态的信息。

类型

object

必填

dockerImageRepository

属性	类型	描述
`dockerImageRepository`	`字符串`	dockerImageRepository 代表可在以下位置访问此流的有效位置。在服务器确定存储库所在的位置之前，可能为空
`publicDockerImageRepository`	`字符串`	publicDockerImageRepository 代表集群外可以拉取镜像的公共位置。如果管理员没有向外部公开集成的 registry，则此字段可能为空。
`tags`	`array`	标签是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。
`tags[]`	`对象`	NamedTagEventList 与其镜像历史记录关联一个标签。

8.1.8. .status.tags

描述: 标签是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。
类型: array

8.1.9. .status.tags[]

描述

NamedTagEventList 与其镜像历史记录关联一个标签。

类型

object

必填

tag
items

属性	类型	描述
`conditions`	`array`	conditions 是应用到标签事件列表的条件数组。
`conditions[]`	`对象`	TagEventCondition 包含标签事件的条件信息。
`items`	`array`	标准对象元数据。
`items[]`	`对象`	ImageStreamStatus 使用 TagEvent 来保留与标签关联的镜像的历史记录。
`tag`	`字符串`	tag 是记录历史记录的标签

8.1.10. .status.tags[].conditions

描述: conditions 是应用到标签事件列表的条件数组。
类型: array

8.1.11. .status.tags[].conditions[]

描述

TagEventCondition 包含标签事件的条件信息。

类型

object

必填

type
status
generation

属性	类型	描述
`generation`	`整数`	generation 是此状态对应于的 spec 标签生成
`lastTransitionTime`	`时间`	lastTransitionTime 是条件从一个状态转换到另一个状态的时间。
`message`	`字符串`	Message 是有关最后一次转换和补充原因的详细信息的人类可读描述。
`reason`	`字符串`	原因是对条件最后一次转换的简短机器可读说明。
`status`	`字符串`	条件的状态，True, False, Unknown 之一。
`type`	`字符串`	标签事件条件类型，目前仅 ImportSuccess

8.1.12. .status.tags[].items

描述: 标准对象元数据。
类型: array

8.1.13. .status.tags[].items[]

描述

ImageStreamStatus 使用 TagEvent 来保留与标签关联的镜像的历史记录。

类型

object

必填

created
dockerImageReference
image
generation

属性	类型	描述
`created`	`时间`	创建包含 TagEvent 创建时间
`dockerImageReference`	`字符串`	dockerImageReference 是可用于拉取此镜像的字符串
`generation`	`整数`	generation 是导致此标签被更新的 spec 标签生成
`image`	`字符串`	image 是镜像

第 8 章 ImageStream [image.openshift.io/v1]

8.1. 规格

8.1.1. .spec

8.1.2. .spec.lookupPolicy

8.1.3. .spec.tags

8.1.4. .spec.tags[]

8.1.5. .spec.tags[].importPolicy

8.1.6. .spec.tags[].referencePolicy

8.1.7. .status

8.1.8. .status.tags

8.1.9. .status.tags[]

8.1.10. .status.tags[].conditions

8.1.11. .status.tags[].conditions[]

8.1.12. .status.tags[].items

8.1.13. .status.tags[].items[]

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links