红帽全球峰会11.7. ImageStreamMapping [image.openshift.io/v1]
- 描述
- ImageStreamMapping 代表从单个镜像流标签到容器镜像的映射，以及镜像来自的容器镜像的引用。特权集成器使用此资源来创建镜像资源，并将其与 status tags 字段中的镜像流关联。创建 ImageStreamMapping 将允许任何可以查看镜像流的用户进行标签或拉取该镜像，因此仅创建用户能够直接访问镜像内容的用户。此资源唯一支持的操作是 create，元数据名称和命名空间应设置为包含应更新的标签的镜像流。
- 类型
-
对象 - 必填
-
image -
tag
-
11.7.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| 镜像是容器镜像和元数据的不可变表示。镜像通过取其内容的哈希值（元数据和内容）以及格式、内容或元数据的更改来命名，这会导致新名称。images 资源主要供集群管理员使用，以及集群镜像 registry 等集成 - 最终用户通过 imagestreamtags 或 imagestreamimages 资源访问镜像。虽然镜像元数据存储在 API 中，实现容器镜像 registry API 的任何集成都必须为原始清单数据、镜像配置和层内容提供自己的存储。 |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| ||
|
|
| tag 是一个字符串值，此镜像可以位于流内。 |
11.7.1.1. .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.7.1.2. .image.dockerImageLayers
- 描述
- dockerImageLayers 代表镜像中的层。如果镜像没有定义这些数据，则无法设置。
- 类型
-
array
11.7.1.3. .image.dockerImageLayers[]
- 描述
- ImageLayer 代表镜像的一个层。有些镜像可能有多个层。有些内容可能没有。
- 类型
-
对象 - 必填
-
name -
size -
mediaType
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用对象的 MediaType。 |
|
|
| 底层存储定义的层名称。 |
|
|
| 由底层存储定义的层大小（以字节为单位）。 |
11.7.1.4. .image.signatures
- 描述
- 签名包含镜像的所有签名。
- 类型
-
array
11.7.1.5. .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 类型。 |
11.7.1.6. .image.signatures[].conditions
- 描述
- 条件代表签名当前状态的最新可用影响。
- 类型
-
array
11.7.1.7. .image.signatures[].conditions[]
- 描述
- SignatureCondition 描述了特定探测时特定类型的镜像签名条件。
- 类型
-
对象 - 必填
-
type -
status
-
11.7.1.8. .image.signatures[].issuedBy
- 描述
- SignatureIssuer 包含有关签名证书或密钥签发者的信息。
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 通用名称（如 openshift-signing-service）。 |
|
|
| 机构名称。 |
11.7.1.9. .image.signatures[].issuedTo
- 描述
- 签名Subject 包含有关创建签名的个人或实体的信息。
- 类型
-
对象 - 必填
-
publicKeyID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 通用名称（如 openshift-signing-service）。 |
|
|
| 机构名称。 |
|
|
| 如果存在，它是属于验证镜像签名的主题的公钥的人类可读密钥 ID。它应至少包含 64 位公钥的指纹（例如 0x685ebe62bf278440）。 |
11.7.2. API 端点
可用的 API 端点如下：
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreammappings-
POST：创建 ImageStreamMapping
-
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 对象名称和身份验证范围，如团队和项目 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| 如果 'true'，则输出被用户友善。 |
- HTTP 方法
-
POST - 描述
- 创建 ImageStreamMapping
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}