4.11. 包括本地 OCI Operator 目录

流程

1. 创建镜像设置配置文件，并根据需要调整设置。

   以下示例镜像设置配置在磁盘上 mirror 一个 OCI 目录，以及来自 registry.redhat.io 的 OpenShift Container Platform 发行版本和 UBI 镜像。

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   storageConfig:
     local:
       path: /home/user/metadata                                                1
   mirror:
     platform:
       channels:
       - name: stable-4.13                                                      2
         type: ocp
       graph: false
     operators:
     - catalog: oci:///home/user/oc-mirror/my-oci-catalog                       3
       targetCatalog: my-namespace/redhat-operator-index                        4
       packages:
       - name: aws-load-balancer-operator
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.13           5
       packages:
       - name: rhacs-operator
     additionalImages:
     - name: registry.redhat.io/ubi9/ubi:latest                                 6

   1

   设置后端位置，以将镜像设置元数据保存到。此位置可以是 registry 或本地目录。必须指定 storageConfig 值。

   2

   （可选）包括一个 OpenShift Container Platform 发行版本，以便从 registry.redhat.io mirror。

   3

   指定磁盘上 OCI 目录位置的绝对路径。使用 OCI 功能时，路径必须以 oci:// 开头。

   4

   另外，还可指定替代命名空间和名称来镜像目录。

   5

   （可选）指定要从 registry 中拉取的额外 Operator 目录。

   6

   （可选）指定要从 registry 中拉取的额外镜像。

2. 运行 oc mirror 命令将 OCI 目录 mirror 到目标 mirror registry：

   $ oc mirror --config=./imageset-config.yaml \ 1
     --include-local-oci-catalogs                2
     docker://registry.example:5000              3

   1

   传递镜像设置配置文件。此流程假设它名为 imageset-config.yaml。

   2

   使用 --include-local-oci-catalogs 标志启用 mirror 本地 OCI 目录和其他远程内容。

   3

   指定要将内容 mirror 到的 registry。registry 必须以 docker:// 开头。如果为镜像 registry 指定顶层命名空间，则必须在后续执行时使用此命名空间。

   另外，您可以指定其他标记来调整 OCI 功能的行为：

   --oci-insecure-signature-policy

   不要将签名推送到目标 mirror registry。

   --oci-registries-config

   指定 TOML 格式的 registry.conf 文件的路径。您可以使用它来从不同的 registry 中镜像，如用于测试的预生产位置，而无需更改镜像设置配置文件。这个标志只会影响本地 OCI 目录，而不会影响任何其他被镜像的内容。

   registry.conf 文件示例

   [[registry]]
    location = "registry.redhat.io:5000"
    insecure = false
    blocked = false
    mirror-by-digest-only = true
    prefix = ""
    [[registry.mirror]]
       location = "preprod-registry.example.com"
       insecure = false