11.5. ImageStreamImport [image.openshift.io/v1]
- 描述
镜像流导入资源为用户提供了从其他容器镜像 registry 中查找和导入容器镜像至服务器的简单方法。可能会导入单个镜像或整个镜像存储库,用户可以在将生成的镜像标记到指定镜像流前查看导入的结果。
此 API 适用于需要查看导入前镜像元数据的最终用户工具(例如,从其中生成应用程序)。知道所需镜像的客户端可以继续直接在其镜像流中创建 spec.tags。
- 类型
-
对象
- 必填
-
spec
-
status
-
11.5.1. 规格 复制链接链接已复制到粘贴板!
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| ImageStreamImportSpec 定义应该导入哪些镜像。 |
|
| ImageStreamImportStatus 包含有关镜像流导入状态的信息。 |
11.5.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- ImageStreamImportSpec 定义应该导入哪些镜像。
- 类型
-
对象
- 必填
-
import
-
属性 | 类型 | 描述 |
---|---|---|
|
| 镜像是要导入的独立镜像的列表。 |
|
| ImageImportSpec 描述了导入特定镜像的请求。 |
|
| import 指明是否执行导入 - 如果这样做,则指定的标签会在 spec 和类型 meta 定义的镜像流的状态上设置。 |
|
| RepositoryImportSpec 描述了从容器镜像存储库导入镜像的请求。 |
11.5.1.2. .spec.images 复制链接链接已复制到粘贴板!
- 描述
- 镜像是要导入的独立镜像的列表。
- 类型
-
array
11.5.1.3. .spec.images[] 复制链接链接已复制到粘贴板!
- 描述
- ImageImportSpec 描述了导入特定镜像的请求。
- 类型
-
对象
- 必填
-
from
-
属性 | 类型 | 描述 |
---|---|---|
| from 是要导入的镜像的来源;只允许 DockerImage 类型 | |
|
| TagImportPolicy 控制如何导入与此标签相关的镜像。 |
|
| IncludeManifest 决定在响应中是否返回各个镜像的清单 |
|
| TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时,此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。 |
| 要是当前镜像流中的标签,用于将导入的镜像分配到,如果没有指定来自 from.name 的默认标签 |
11.5.1.4. .spec.images[].importPolicy 复制链接链接已复制到粘贴板!
- 描述
- TagImportPolicy 控制如何导入与此标签相关的镜像。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 如果服务器可以在镜像导入过程中绕过证书验证或直接通过 HTTP 连接,则不安全为 true。 |
|
| scheduled 表示应定期检查该标签的服务器以确保它最新并导入 |
11.5.1.5. .spec.images[].referencePolicy 复制链接链接已复制到粘贴板!
- 描述
- TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时,此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。
- 类型
-
对象
- 必填
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
|
Type 决定在部署配置触发器或新构建中使用镜像流标签时,应该如何转换镜像拉取规格。默认值为 |
11.5.1.6. .spec.repository 复制链接链接已复制到粘贴板!
- 描述
- RepositoryImportSpec 描述了从容器镜像存储库导入镜像的请求。
- 类型
-
对象
- 必填
-
from
-
属性 | 类型 | 描述 |
---|---|---|
| from 是要导入的镜像存储库的源;只允许 DockerImage 和容器镜像存储库的名称 | |
|
| TagImportPolicy 控制如何导入与此标签相关的镜像。 |
|
| IncludeManifest 决定在响应中是否返回各个镜像的清单 |
|
| TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时,此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。 |
11.5.1.7. .spec.repository.importPolicy 复制链接链接已复制到粘贴板!
- 描述
- TagImportPolicy 控制如何导入与此标签相关的镜像。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 如果服务器可以在镜像导入过程中绕过证书验证或直接通过 HTTP 连接,则不安全为 true。 |
|
| scheduled 表示应定期检查该标签的服务器以确保它最新并导入 |
11.5.1.8. .spec.repository.referencePolicy 复制链接链接已复制到粘贴板!
- 描述
- TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时,此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。
- 类型
-
对象
- 必填
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
|
Type 决定在部署配置触发器或新构建中使用镜像流标签时,应该如何转换镜像拉取规格。默认值为 |
11.5.1.9. .status 复制链接链接已复制到粘贴板!
- 描述
- ImageStreamImportStatus 包含有关镜像流导入状态的信息。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 镜像通过导入 spec.images 的结果进行设置 |
|
| ImageImportStatus 描述了镜像导入的结果。 |
|
| ImageStream 存储标签到镜像的映射、当镜像在流中标记时应用的元数据覆盖,以及对 registry 上容器镜像存储库的可选引用。用户通常会更新 spec.tags 字段,以指向使用带有 pull secret 类型的命名空间中的凭证从容器 registry 导入的外部镜像,或者指向可立即可用于标记或拉取的现有镜像流标签和镜像。应用到标签的镜像历史记录在 status.tags 字段中可见,任何可以查看镜像流的用户都可以将该镜像标记到自己的镜像流中。通过对给定镜像流具有"get imagestreams/layers"权限,授予从集成 registry 中拉取镜像的访问权限。用户可以通过删除 imagestreamtag 资源来删除标签,这会导致该标签的 spec 和 status 被删除。在管理员运行修剪操作前,会保留镜像流历史记录,这将删除不再使用的引用。要保留历史镜像,请确保在其摘要指向该镜像的 spec 中有一个标签。 |
|
| RepositoryImportStatus 描述了镜像存储库导入的结果 |
11.5.1.10. .status.images 复制链接链接已复制到粘贴板!
- 描述
- 镜像通过导入 spec.images 的结果进行设置
- 类型
-
array
11.5.1.11. .status.images[] 复制链接链接已复制到粘贴板!
- 描述
- ImageImportStatus 描述了镜像导入的结果。
- 类型
-
对象
- 必填
-
status
-
属性 | 类型 | 描述 |
---|---|---|
|
| 镜像是容器镜像和元数据的不可变表示。镜像通过取其内容的哈希值(元数据和内容)以及格式、内容或元数据的更改来命名,这会导致新名称。images 资源主要供集群管理员使用,以及集群镜像 registry 等集成 - 最终用户通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中,实现容器镜像 registry API 的任何集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。 |
| status 是镜像导入的状态,包括检索镜像时遇到的错误 | |
|
| tag 是此镜像所在的标签(若有) |
11.5.1.12. .status.images[].image 复制链接链接已复制到粘贴板!
- 描述
- 镜像是容器镜像和元数据的不可变表示。镜像通过取其内容的哈希值(元数据和内容)以及格式、内容或元数据的更改来命名,这会导致新名称。images 资源主要供集群管理员使用,以及集群镜像 registry 等集成 - 最终用户通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中,实现容器镜像 registry API 的任何集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。
- 类型
-
对象
- 必填
-
dockerImageLayers
-
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| DockerImageConfig 是一个 JSON blob,运行时用于设置容器。这是清单模式 v2 的一部分。 |
|
| dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据,则无法设置。 |
|
| ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。 |
|
| DockerImageManifest 是清单的原始 JSON |
|
| DockerImageManifestMediaType 指定清单的 mediaType。这是清单模式 v2 的一部分。 |
| dockerImageMetadata 包含有关此镜像的元数据 | |
|
| dockerImageMetadataVersion 传递了对象的版本,如果为空默认为 "1.0" |
|
| dockerImageReference 是可用于拉取此镜像的字符串。 |
|
| DockerImageSignatures 提供签名作为不透明 Blob。这是清单模式 v1 的一部分。 |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| 签名包含镜像的所有签名。 |
|
| 镜像签名包含镜像签名。只要签名被信任,就可以验证镜像身份和其他声明。根据此信息,可以将可运行的镜像限制为匹配的集群范围策略。必要字段应由执行镜像验证的客户端解析。其他对象由服务器从签名的内容解析。它们只用于说明目的。 |
11.5.1.13. .status.images[].image.dockerImageLayers 复制链接链接已复制到粘贴板!
- 描述
- dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据,则无法设置。
- 类型
-
array
11.5.1.14. .status.images[].image.dockerImageLayers[] 复制链接链接已复制到粘贴板!
- 描述
- ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。
- 类型
-
对象
- 必填
-
name
-
size
-
mediaType
-
属性 | 类型 | 描述 |
---|---|---|
|
| 引用对象的 MediaType。 |
|
| 底层存储定义的层名称。 |
|
| 由底层存储定义的层大小(以字节为单位)。 |
11.5.1.15. .status.images[].image.signatures 复制链接链接已复制到粘贴板!
- 描述
- 签名包含镜像的所有签名。
- 类型
-
array
11.5.1.16. .status.images[].image.signatures[] 复制链接链接已复制到粘贴板!
- 描述
- 镜像签名包含镜像签名。只要签名被信任,就可以验证镜像身份和其他声明。根据此信息,可以将可运行的镜像限制为匹配的集群范围策略。必要字段应由执行镜像验证的客户端解析。其他对象由服务器从签名的内容解析。它们只用于说明目的。
- 类型
-
对象
- 必填
-
type
-
content
-
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 条件代表签名当前状态的最新可用影响。 |
|
| SignatureCondition 描述了特定探测时特定类型的镜像签名条件。 |
|
| 必需:不透明二进制字符串,即镜像签名。 |
| 如果指定,这是签名创建的时间。 | |
|
| 代表镜像身份的人类可读字符串。它可以是产品名称和版本,也可以是镜像拉取规格(如 "registry.access.redhat.com/rhel7/rhel:7.2")。 |
|
| SignatureIssuer 包含有关签名证书或密钥签发者的信息。 |
|
| 签名Subject 包含有关创建签名的个人或实体的信息。 |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| 包含来自签名的声明。 |
|
| 必需:描述存储的 blob 类型。 |
- 描述
- 条件代表签名当前状态的最新可用影响。
- 类型
-
array
- 描述
- SignatureCondition 描述了特定探测时特定类型的镜像签名条件。
- 类型
-
对象
- 必填
-
type
-
status
-
11.5.1.19. .status.images[].image.signatures[].issuedBy 复制链接链接已复制到粘贴板!
- 描述
- SignatureIssuer 包含有关签名证书或密钥签发者的信息。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 通用名称(如 openshift-signing-service)。 |
|
| 机构名称。 |
11.5.1.20. .status.images[].image.signatures[].issuedTo 复制链接链接已复制到粘贴板!
- 描述
- 签名Subject 包含有关创建签名的个人或实体的信息。
- 类型
-
对象
- 必填
-
publicKeyID
-
属性 | 类型 | 描述 |
---|---|---|
|
| 通用名称(如 openshift-signing-service)。 |
|
| 机构名称。 |
|
| 如果存在,它是属于验证镜像签名的主题的公钥的人类可读密钥 ID。它应至少包含 64 位公钥的指纹(例如 0x685ebe62bf278440)。 |
11.5.1.21. .status.import 复制链接链接已复制到粘贴板!
- 描述
- ImageStream 存储标签到镜像的映射、当镜像在流中标记时应用的元数据覆盖,以及对 registry 上容器镜像存储库的可选引用。用户通常会更新 spec.tags 字段,以指向使用带有 pull secret 类型的命名空间中的凭证从容器 registry 导入的外部镜像,或者指向可立即可用于标记或拉取的现有镜像流标签和镜像。应用到标签的镜像历史记录在 status.tags 字段中可见,任何可以查看镜像流的用户都可以将该镜像标记到自己的镜像流中。通过对给定镜像流具有"get imagestreams/layers"权限,授予从集成 registry 中拉取镜像的访问权限。用户可以通过删除 imagestreamtag 资源来删除标签,这会导致该标签的 spec 和 status 被删除。在管理员运行修剪操作前,会保留镜像流历史记录,这将删除不再使用的引用。要保留历史镜像,请确保在其摘要指向该镜像的 spec 中有一个标签。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| ImageStreamSpec 代表 ImageStreams 的选项。 |
|
| ImageStreamStatus 包含此镜像流状态的信息。 |
11.5.1.22. .status.import.spec 复制链接链接已复制到粘贴板!
- 描述
- ImageStreamSpec 代表 ImageStreams 的选项。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| dockerImageRepository 是可选的,如果指定此流由这个服务器上的容器存储库支持:从 v3.7 开始已弃用,并将在以后的发行版本中删除。通过 spec.tags.from 引用来指定每个标签中要导入的标签的源。 |
|
| ImageLookupPolicy 描述了如何使用镜像流覆盖命名空间中 pod、构建和其他资源使用的镜像引用。 |
|
| 标签将任意字符串值映射到特定的镜像 locators |
|
| TagReference 为使用此标签的镜像指定可选注解,以及此标签应跟踪的 ImageStreamTag、ImageStreamImage 或 DockerImage 的可选引用。 |
11.5.1.23. .status.import.spec.lookupPolicy 复制链接链接已复制到粘贴板!
- 描述
- ImageLookupPolicy 描述了如何使用镜像流覆盖命名空间中 pod、构建和其他资源使用的镜像引用。
- 类型
-
对象
- 必填
-
local
-
属性 | 类型 | 描述 |
---|---|---|
|
| 每当与此镜像流匹配时,local 会将这个命名空间中的对象上的 docker 短镜像引用(如 "mysql" 或 "php:latest")更改为镜像 ID,而不是到达远程 registry。如果找到,该名称将完全限定到镜像 ID。标签的 referencePolicy 会考虑替换的值。仅在当前命名空间中工作。 |
11.5.1.24. .status.import.spec.tags 复制链接链接已复制到粘贴板!
- 描述
- 标签将任意字符串值映射到特定的镜像 locators
- 类型
-
array
11.5.1.25. .status.import.spec.tags[] 复制链接链接已复制到粘贴板!
- 描述
- TagReference 为使用此标签的镜像指定可选注解,以及此标签应跟踪的 ImageStreamTag、ImageStreamImage 或 DockerImage 的可选引用。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选;如果指定,则应用于通过 ImageStreamTags 检索的镜像的注解。 |
| 可选;如果指定,则对此标签应指向的另一个镜像的引用。有效值为 ImageStreamTag、ImageStreamImage 和 DockerImage。ImageStreamTag 引用只能引用同一 ImageStream 中的标签。 | |
|
| 生成是一个计数器,可跟踪到 spec 标签(用户意图)的变异。更改标签引用时,将生成设置为与当前流生成匹配(每次更改 spec 时就会递增)。镜像导入程序等系统中的其他进程会观察生成 spec 标签比状态中记录的生成更新,并使用该触发器导入最新的远程标签。要触发新导入,客户端可能会将此值设置为零,这会将生成重置为最新的流生成。旧客户端会将此值发送为 nil,该值将与当前标签生成合并。 |
|
| TagImportPolicy 控制如何导入与此标签相关的镜像。 |
|
| 标签的名称 |
|
| 引用状态,如果标签将导入。默认值为 false,这意味着将导入标签。 |
|
| TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时,此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。 |
11.5.1.26. .status.import.spec.tags[].importPolicy 复制链接链接已复制到粘贴板!
- 描述
- TagImportPolicy 控制如何导入与此标签相关的镜像。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 如果服务器可以在镜像导入过程中绕过证书验证或直接通过 HTTP 连接,则不安全为 true。 |
|
| scheduled 表示应定期检查该标签的服务器以确保它最新并导入 |
11.5.1.27. .status.import.spec.tags[].referencePolicy 复制链接链接已复制到粘贴板!
- 描述
- TagReferencePolicy 描述了当部署配置或构建中的镜像更改触发器时,此镜像流标签中镜像的 pull-specs 是如何生成的。这允许镜像流作者控制镜像的访问方式。
- 类型
-
对象
- 必填
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
|
Type 决定在部署配置触发器或新构建中使用镜像流标签时,应该如何转换镜像拉取规格。默认值为 |
11.5.1.28. .status.import.status 复制链接链接已复制到粘贴板!
- 描述
- ImageStreamStatus 包含此镜像流状态的信息。
- 类型
-
对象
- 必填
-
dockerImageRepository
-
属性 | 类型 | 描述 |
---|---|---|
|
| dockerImageRepository 代表此流可在其访问的有效位置。可以为空,直到服务器确定存储库所在的位置 |
|
| publicDockerImageRepository 代表可以从集群外拉取镜像的公共位置。如果管理员没有在外部公开集成的 registry,则此字段可能为空。 |
|
| 标签是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。 |
|
| NamedTagEventList 将标签与其镜像历史记录相关联。 |
11.5.1.29. .status.import.status.tags 复制链接链接已复制到粘贴板!
- 描述
- 标签是与每个标签关联的镜像的历史记录。TagEvent 数组中的第一个条目是当前标记的镜像。
- 类型
-
array
11.5.1.30. .status.import.status.tags[] 复制链接链接已复制到粘贴板!
- 描述
- NamedTagEventList 将标签与其镜像历史记录相关联。
- 类型
-
对象
- 必填
-
tag
-
items
-
属性 | 类型 | 描述 |
---|---|---|
|
| conditions 是应用到标签事件列表的条件数组。 |
|
| TagEventCondition 包含标签事件的条件信息。 |
|
| 标准对象元数据。 |
|
| ImageStreamStatus 使用 TagEvent 来保留与标签关联的镜像的历史记录。 |
|
| tag 是记录历史记录的标签 |
11.5.1.31. .status.import.status.tags[].conditions 复制链接链接已复制到粘贴板!
- 描述
- conditions 是应用到标签事件列表的条件数组。
- 类型
-
array
11.5.1.32. .status.import.status.tags[].conditions[] 复制链接链接已复制到粘贴板!
- 描述
- TagEventCondition 包含标签事件的条件信息。
- 类型
-
对象
- 必填
-
type
-
status
-
生成
-
属性 | 类型 | 描述 |
---|---|---|
|
| 生成是此状态对应的 spec 标签生成 |
| lastTransitionTime 是条件从一个状态转换到另一个状态的时间。 | |
|
| 消息是最后一次转换的详细信息的人类可读描述,补充原因。 |
|
| reason 是条件最后一次转换的简短机器可读说明。 |
|
| 条件的状态,True, False, Unknown 之一。 |
|
| 标签事件状况类型,目前只有 ImportSuccess |
11.5.1.33. .status.import.status.tags[].items 复制链接链接已复制到粘贴板!
- 描述
- 标准对象元数据。
- 类型
-
array
11.5.1.34. .status.import.status.tags[].items[] 复制链接链接已复制到粘贴板!
- 描述
- ImageStreamStatus 使用 TagEvent 来保留与标签关联的镜像的历史记录。
- 类型
-
对象
- 必填
-
created
-
dockerImageReference
-
image
-
生成
-
属性 | 类型 | 描述 |
---|---|---|
| created 包含 TagEvent 创建的时间 | |
|
| dockerImageReference 是可用于拉取此镜像的字符串 |
|
| 生成是导致此标签的 spec 标签生成更新 |
|
| image 是镜像 |
11.5.1.35. .status.repository 复制链接链接已复制到粘贴板!
- 描述
- RepositoryImportStatus 描述了镜像存储库导入的结果
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| AdditionalTags 是存储库中存在的标签,但没有导入,因为应用了自动导入的最大值。 |
|
| 镜像是存储库导入成功检索的镜像列表。 |
|
| ImageImportStatus 描述了镜像导入的结果。 |
| status 反映了导入过程中是否发生任何失败 |
11.5.1.36. .status.repository.images 复制链接链接已复制到粘贴板!
- 描述
- 镜像是存储库导入成功检索的镜像列表。
- 类型
-
array
11.5.1.37. .status.repository.images[] 复制链接链接已复制到粘贴板!
- 描述
- ImageImportStatus 描述了镜像导入的结果。
- 类型
-
对象
- 必填
-
status
-
属性 | 类型 | 描述 |
---|---|---|
|
| 镜像是容器镜像和元数据的不可变表示。镜像通过取其内容的哈希值(元数据和内容)以及格式、内容或元数据的更改来命名,这会导致新名称。images 资源主要供集群管理员使用,以及集群镜像 registry 等集成 - 最终用户通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中,实现容器镜像 registry API 的任何集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。 |
| status 是镜像导入的状态,包括检索镜像时遇到的错误 | |
|
| tag 是此镜像所在的标签(若有) |
11.5.1.38. .status.repository.images[].image 复制链接链接已复制到粘贴板!
- 描述
- 镜像是容器镜像和元数据的不可变表示。镜像通过取其内容的哈希值(元数据和内容)以及格式、内容或元数据的更改来命名,这会导致新名称。images 资源主要供集群管理员使用,以及集群镜像 registry 等集成 - 最终用户通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中,实现容器镜像 registry API 的任何集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。
- 类型
-
对象
- 必填
-
dockerImageLayers
-
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| DockerImageConfig 是一个 JSON blob,运行时用于设置容器。这是清单模式 v2 的一部分。 |
|
| dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据,则无法设置。 |
|
| ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。 |
|
| DockerImageManifest 是清单的原始 JSON |
|
| DockerImageManifestMediaType 指定清单的 mediaType。这是清单模式 v2 的一部分。 |
| dockerImageMetadata 包含有关此镜像的元数据 | |
|
| dockerImageMetadataVersion 传递了对象的版本,如果为空默认为 "1.0" |
|
| dockerImageReference 是可用于拉取此镜像的字符串。 |
|
| DockerImageSignatures 提供签名作为不透明 Blob。这是清单模式 v1 的一部分。 |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| 签名包含镜像的所有签名。 |
|
| 镜像签名包含镜像签名。只要签名被信任,就可以验证镜像身份和其他声明。根据此信息,可以将可运行的镜像限制为匹配的集群范围策略。必要字段应由执行镜像验证的客户端解析。其他对象由服务器从签名的内容解析。它们只用于说明目的。 |
- 描述
- dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据,则无法设置。
- 类型
-
array
- 描述
- ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。
- 类型
-
对象
- 必填
-
name
-
size
-
mediaType
-
属性 | 类型 | 描述 |
---|---|---|
|
| 引用对象的 MediaType。 |
|
| 底层存储定义的层名称。 |
|
| 由底层存储定义的层大小(以字节为单位)。 |
11.5.1.41. .status.repository.images[].image.signatures 复制链接链接已复制到粘贴板!
- 描述
- 签名包含镜像的所有签名。
- 类型
-
array
- 描述
- 镜像签名包含镜像签名。只要签名被信任,就可以验证镜像身份和其他声明。根据此信息,可以将可运行的镜像限制为匹配的集群范围策略。必要字段应由执行镜像验证的客户端解析。其他对象由服务器从签名的内容解析。它们只用于说明目的。
- 类型
-
对象
- 必填
-
type
-
content
-
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 条件代表签名当前状态的最新可用影响。 |
|
| SignatureCondition 描述了特定探测时特定类型的镜像签名条件。 |
|
| 必需:不透明二进制字符串,即镜像签名。 |
| 如果指定,这是签名创建的时间。 | |
|
| 代表镜像身份的人类可读字符串。它可以是产品名称和版本,也可以是镜像拉取规格(如 "registry.access.redhat.com/rhel7/rhel:7.2")。 |
|
| SignatureIssuer 包含有关签名证书或密钥签发者的信息。 |
|
| 签名Subject 包含有关创建签名的个人或实体的信息。 |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| 包含来自签名的声明。 |
|
| 必需:描述存储的 blob 类型。 |
- 描述
- 条件代表签名当前状态的最新可用影响。
- 类型
-
array
- 描述
- SignatureCondition 描述了特定探测时特定类型的镜像签名条件。
- 类型
-
对象
- 必填
-
type
-
status
-
- 描述
- SignatureIssuer 包含有关签名证书或密钥签发者的信息。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 通用名称(如 openshift-signing-service)。 |
|
| 机构名称。 |
- 描述
- 签名Subject 包含有关创建签名的个人或实体的信息。
- 类型
-
对象
- 必填
-
publicKeyID
-
属性 | 类型 | 描述 |
---|---|---|
|
| 通用名称(如 openshift-signing-service)。 |
|
| 机构名称。 |
|
| 如果存在,它是属于验证镜像签名的主题的公钥的人类可读密钥 ID。它应至少包含 64 位公钥的指纹(例如 0x685ebe62bf278440)。 |
11.5.2. API 端点 复制链接链接已复制到粘贴板!
可用的 API 端点如下:
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreamimports
-
POST
:创建 ImageStreamImport
-
参数 | 类型 | 描述 |
---|---|---|
|
| 对象名称和身份验证范围,如团队和项目 |
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
POST
- 描述
- 创建 ImageStreamImport
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空 |