4.4. 使用 oc-mirror 插件为断开连接的安装镜像镜像

apiVersion

ImageSetConfiguration 内容的 API 版本。

字符串.例如： mirror.openshift.io/v1alpha2。

archiveSize

镜像集中的每个存档文件的最大大小（以 GiB 为单位）。

整数.例如： 4

mirror

镜像集的配置。

对象

mirror.additionalImages

镜像集的额外镜像配置。

对象数组。例如：

additionalImages:
  - name: registry.redhat.io/ubi8/ubi:latest

mirror.additionalImages.name

要 mirror 的镜像的标签或摘要。

字符串.例如： registry.redhat.io/ubi8/ubi:latest

mirror.blockedImages

阻止 mirror 的镜像的完整标签、摘要或模式。

字符串数组。例如： docker.io/library/alpine

mirror.helm

镜像集的 helm 配置。请注意，oc-mirror 插件只支持 helm chart，在呈现时不需要用户输入。

对象

mirror.helm.local

要镜像的本地 helm chart。

对象数组。例如：

local:
  - name: podinfo
    path: /test/podinfo-5.0.0.tar.gz

mirror.helm.local.name

要镜像的本地 helm chart 的名称。

字符串.例如： podinfo。

mirror.helm.local.path

到镜像的本地 helm chart 的路径。

字符串.例如： /test/podinfo-5.0.0.tar.gz。

mirror.helm.repositories

从其中镜像的的远程 helm 软件仓库。

对象数组。例如：

repositories:
  - name: podinfo
    url: https://example.github.io/podinfo
    charts:
      - name: podinfo
        version: 5.0.0

mirror.helm.repositories.name

从其中镜像(mirror)的 helm 存储库的名称。

字符串.例如： podinfo。

mirror.helm.repositories.url

从其中镜像(mirror)的 helm 存储库的 URL。

字符串.例如： https://example.github.io/podinfo。

mirror.helm.repositories.charts

要镜像的远程 helm chart。

对象数组。

mirror.helm.repositories.charts.name

要镜像的 helm chart 的名称。

字符串.例如： podinfo。

mirror.helm.repositories.charts.version

要镜像命名 helm chart 的版本。

字符串.例如： 5.0.0。

mirror.operators

镜像集的 Operator 配置。

对象数组。例如：

operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.16
    packages:
      - name: elasticsearch-operator
        minVersion: '2.4.0'

mirror.operators.catalog

包括在镜像集中的 Operator 目录。

字符串.例如：registry.redhat.io/redhat/redhat-operator-index:v4.16。

mirror.operators.full

为 true 时，下载完整的目录、Operator 软件包或 Operator 频道。

布尔值.默认值为 false。

mirror.operators.packages

Operator 软件包配置。

对象数组。例如：

operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.16
    packages:
      - name: elasticsearch-operator
        minVersion: '5.2.3-31'

mirror.operators.packages.name

镜像集中要包含的 Operator 软件包名称

字符串.例如： elasticsearch-operator。

mirror.operators.packages.channels

Operator 软件包频道配置。

对象

mirror.operators.packages.channels.name

Operator 频道名称（软件包中唯一）要包括在镜像集中。

字符串.例如： fast 或 stable-v4.16。

mirror.operators.packages.channels.maxVersion

Operator 镜像的最高版本，在其中存在所有频道。详情请查看以下备注。

字符串.例如： 5.2.3-31

mirror.operators.packages.channels.minBundle

要包含的最小捆绑包的名称，以及频道头更新图中的所有捆绑包。仅在命名捆绑包没有语义版本元数据时设置此字段。

字符串.例如： bundleName

mirror.operators.packages.channels.minVersion

Operator 的最低版本，用于镜像存在的所有频道。详情请查看以下备注。

字符串.例如： 5.2.3-31

mirror.operators.packages.maxVersion

Operator 最高版本，可跨所有存在的频道进行镜像。详情请查看以下备注。

字符串.例如： 5.2.3-31。

mirror.operators.packages.minVersion

Operator 的最低版本，用于镜像存在的所有频道。详情请查看以下备注。

字符串.例如： 5.2.3-31。

mirror.operators.skipDependencies

如果为 true，则不会包含捆绑包的依赖项。

布尔值.默认值为 false。

mirror.operators.targetCatalog

要镜像引用的目录的替代名称和可选命名空间层次结构。

字符串.例如：my-namespace/my-operator-catalog

mirror.operators.targetName

将引用的目录镜像为。

targetName 参数已弃用。改为使用 targetCatalog 参数。

字符串.例如： my-operator-catalog

mirror.operators.targetTag

附加到 targetName 或 targetCatalog 的替代标签。

字符串.例如： v1

mirror.platform

镜像集的平台配置。

对象

mirror.platform.architectures

要镜像的平台发行版本有效负载的架构。

字符串数组。例如：

architectures:
  - amd64
  - arm64
  - multi
  - ppc64le
  - s390x

默认值为 amd64。值 multi 确保镜像支持所有可用架构，无需指定单个架构。

mirror.platform.channels

镜像集的平台频道配置。

对象数组。例如：

channels:
  - name: stable-4.10
  - name: stable-4.16

mirror.platform.channels.full

为 true 时，将 minVersion 设置为频道中的第一个发行版本，将 maxVersion 设置为该频道的最后一个发行版本。

布尔值.默认值为 false。

mirror.platform.channels.name

发行频道的名称。

字符串.例如： stable-4.16

mirror.platform.channels.minVersion

要镜像引用的平台的最低版本。

字符串.例如：4.12.6

mirror.platform.channels.maxVersion

要镜像引用的平台的最高版本。

字符串.例如： 4.16.1

mirror.platform.channels.shortestPath

切换最短的路径镜像或完整范围镜像。

布尔值.默认值为 false。

mirror.platform.channels.type

要镜像的平台的类型。

字符串.例如： ocp 或 okd。默认为 ocp。

mirror.platform.graph

指明是否将 OSUS 图表添加到镜像集中，然后发布到镜像。

布尔值.默认值为 false。

storageConfig

镜像集的后端配置。

对象

storageConfig.local

镜像集的本地后端配置。

对象

storageConfig.local.path

包含镜像设置元数据的目录路径。

字符串.例如： ./path/to/dir/。

storageConfig.registry

镜像集的 registry 后端配置。

对象

storageConfig.registry.imageURL

后端 registry URI。可以选择在 URI 中包含命名空间引用。

字符串.例如： quay.io/myuser/imageset:metadata。

storageConfig.registry.skipTLS

（可选）跳过引用的后端 registry 的 TLS 验证。

布尔值.默认值为 false。

completion

为指定的 shell 生成自动完成脚本。

describe

输出镜像集合的内容。

帮助

显示有关任何子命令的帮助。

init

输出初始镜像设置配置模板。

list

列出可用平台和 Operator 内容及其版本。

version

输出 oc-mirror 版本。

-c, --config <string>

指定镜像设置配置文件的路径。

--continue-on-error

如果发生任何非镜像拉取相关的错误，请继续并尝试进行镜像(mirror)。

--dest-skip-tls

禁用目标 registry 的 TLS 验证。

--dest-use-http

使用 HTTP 用于目标 registry。

--dry-run

仅输出操作情况，不实际 mirror 镜像。生成 mapping.txt 和 pruning-plan.json 文件。

--from <string>

指定由执行 oc-mirror 生成的镜像设置归档的路径，以加载到目标 registry 中。

-h,--help

显示帮助。

--ignore-history

下载镜像和打包层时，忽略过去的镜像。禁用增量镜像，并可能会下载更多数据。

--manifests-only

为 ImageContentSourcePolicy 对象生成清单，将集群配置为使用镜像 registry，但不实际镜像任何镜像。要使用此标志，您必须使用 --from 标志传递镜像集存档。

--max-nested-paths <int>

指定限制嵌套路径的目标 registry 的最大嵌套路径数。默认值为 0。

--max-per-registry <int>

指定每个 registry 允许的并发请求数。默认值为 6。

--oci-insecure-signature-policy

在镜像本地 OCI 目录时不要推送签名（使用 --include-local-oci-catalogs）。

--oci-registries-config

提供 registry 配置文件，以指定在镜像本地 OCI 目录（使用 --include-local-oci-catalogs）时复制的替代 registry 位置。

--skip-cleanup

跳过删除工件目录。

--skip-image-pin

不要将镜像标签替换为 Operator 目录中的摘要。

--skip-metadata-check

发布镜像集时跳过元数据。只有在使用 --ignore-history 创建镜像集时才建议使用。

--skip-missing

如果没有找到镜像，则跳过它而不是报告错误并中止执行。不适用于在镜像设置配置中明确指定的自定义镜像。

--skip-pruning

从目标镜像 registry 禁用自动修剪镜像。

--skip-verification

跳过摘要验证。

--source-skip-tls

为源 registry 禁用 TLS 验证。

--source-use-http

将普通 HTTP 用于源 registry。

-v, --verbose <int>

指定日志级别详细程度的数量。有效值为 0 - 9。默认值为 0。