第 12 章 ImageDigestMirrorSet [config.openshift.io/v1]
- 描述
- ImageDigestMirrorSet 包含集群范围信息，有关如何使用摘要拉取规格处理 registry 镜像规则。定义了多个策略时，会在每个字段中定义行为的结果。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
spec
-
12.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 |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| spec 包含用于配置的用户可设置值 |
|
|
| status 包含资源的观察状态。 |
12.1.1. .spec
- 描述
- spec 包含用于配置的用户可设置值
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
imageDigestMirrors 允许从替代镜像的存储库位置拉取 pod 中镜像摘要引用的镜像。为 pod 提供的镜像拉取规格将与 imageDigestMirrors 中描述的源位置进行比较，镜像可以从列表中的任何镜像(mirror)而不是指定存储库拉取(pull)，使管理员能够选择可能更快地镜像的镜像。要使用 mirrors 来使用标签规格拉取镜像，用户应使用 "ImageTagMirrorSet" CRD 配置一个镜像列表。如果镜像拉取规格与多个 imagedigestmirrorset 对象中的 "source" 存储库匹配，则只使用定义最具体命名空间匹配的对象。例如，如果存在使用 quay.io/libpod 和 quay.io/libpod/busybox 作为 "source" 的对象，则只有 quay.io/libpod/busybox 的对象将应用到拉取规格 quay.io/libpod/busybox。每个"源"存储库都独立处理；不同"源"存储库的配置不交互。如果没有指定 "mirrors"，则镜像将继续从 pull spec 中的指定存储库拉取。当为同一"源"存储库定义了多个策略时，定义的镜像集合将合并在一起，保留镜像的相对顺序（如果可能）。例如，如果策略 A 具有镜像 |
|
|
| imageDigestMirrors 包含有关如何处理 registry 配置中镜像的集群范围信息。 |
12.1.2. .spec.imageDigestMirrors
- 描述
-
imageDigestMirrors 允许从替代镜像的存储库位置拉取 pod 中镜像摘要引用的镜像。为 pod 提供的镜像拉取规格将与 imageDigestMirrors 中描述的源位置进行比较，镜像可以从列表中的任何镜像(mirror)而不是指定存储库拉取(pull)，使管理员能够选择可能更快地镜像的镜像。要使用 mirrors 来使用标签规格拉取镜像，用户应使用 "ImageTagMirrorSet" CRD 配置一个镜像列表。如果镜像拉取规格与多个 imagedigestmirrorset 对象中的 "source" 存储库匹配，则只使用定义最具体命名空间匹配的对象。例如，如果存在使用 quay.io/libpod 和 quay.io/libpod/busybox 作为 "source" 的对象，则只有 quay.io/libpod/busybox 的对象将应用到拉取规格 quay.io/libpod/busybox。每个"源"存储库都独立处理；不同"源"存储库的配置不交互。如果没有指定 "mirrors"，则镜像将继续从 pull spec 中的指定存储库拉取。当为同一"源"存储库定义了多个策略时，定义的镜像集合将合并在一起，保留镜像的相对顺序（如果可能）。例如，如果策略 A 具有镜像
a, b, c和 policy B 具有 mirrorc, d, e，则镜像将按a、b、c、d、e的顺序使用。如果镜像条目的顺序冲突（例如，b和 ）。b, a）配置不会被拒绝，但生成的顺序未指定。要使用特定镜像顺序的用户，应该使用预期的顺序将它们配置为一个镜像列表。 - 类型
-
数组
12.1.3. .spec.imageDigestMirrors[]
- 描述
- imageDigestMirrors 包含有关如何处理 registry 配置中镜像的集群范围信息。
- 类型
-
object - 必填
-
source
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 如果无法从镜像拉取镜像，mirrorSourcePolicy 定义回退策略。如果未设置，则仅在一个或多个镜像位于镜像列表中时，才会从 pull spec. sourcePolicy 中的存储库拉取镜像。 |
|
|
| mirror 是零个或多个位置，也可以包含同一镜像。如果没有指定镜像，则不会配置镜像。只有镜像被摘要引用时，才能从这些镜像中拉取(pull)镜像。镜像的位置是通过替换与 mirrors 条目匹配的源（如 registry.redhat.io/product/repo 参考,,源, mirror.io, mirror.local/redhat/product/repo 存储库）匹配的输入引用的一部分，从而导致使用 mirror.local/redhat/product/repo 存储库。此列表中的镜像顺序被视为用户所需的优先级，而源默认被视为比所有镜像的优先级较低。如果没有指定镜像，或者从镜像列表拉取（但不仅限于），则镜像将继续从 pull spec 中的存储库拉取，除非被"mirrorSourcePolicy"其他集群配置明确禁止，包括（但不仅限于）其他 imageDigestMirrors 对象，可能会影响联系的确切顺序镜像，或者可以并行联系某些镜像。因此，这应该被视为首选项，而不是排序的保证。"mirrors"使用以下格式之一：host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace[/namespace…]/repo 了解有关格式的更多信息，请参阅有关 location 字段的文档 ：https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table |
|
|
| 源与用户引用的存储库匹配，例如在镜像拉取规格中。将 source 设置为 registry 主机名（如 docker.io. quay.io 或 registry.redhat.io）将匹配 corressponding registry 的镜像拉取规格。"source" 使用以下格式之一：host[:port] host[:port]/namespace[:port]/namespace[:port]/namespace[/namespace]/namespace[/namespace…]/repo [*.host] https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table |
12.1.4. .status
- 描述
- status 包含资源的观察状态。
- 类型
-
object
