4.11. 以 OCI 格式镜像基于文件的目录 Operator 镜像

流程

1. 可选：检索您需要的目录和镜像，并将其保存到磁盘上。如果您已在磁盘上有 OCI 格式的目录镜像，您可以跳过这一步。

   1. 创建镜像设置配置文件：

      复制到磁盘的镜像设置配置文件示例

      kind: ImageSetConfiguration
      apiVersion: mirror.openshift.io/v1alpha2
      mirror:
       operators:
       - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.12
         packages:
         - name: aws-load-balancer-operator

      注意

      使用 OCI 功能时，只有 mirror.operators.catalog 设置可供使用。

      storageConfig 设置将被忽略，而是传递给 oc mirror 命令的位置。

   2. 运行 oc mirror 命令将指定镜像集配置镜像到磁盘：

      $ oc mirror --config=./imageset-config.yaml \ 

      1

      
        --use-oci-feature \                         

      2

      
        --oci-feature-action=copy \                 

      3

      
        oci://my-oci-catalog                        

      4

      1

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

      2

      使用 --use-oci-feature 标志来启用 OCI 功能。

      3

      要将目录复制到磁盘，请将 --oci-feature-action 标志设置为 copy。

      4

      在要输出目录的磁盘上指定一个目录。此流程假设它名为 my-oci-catalog。该路径必须以 oci:// 开头。如果指定的目录不是完整路径，则会在运行 oc mirror 命令的当前工作目录中创建该目录。

      注意

      您可以选择使用 --oci-registries-config 标志来指定到 TOML 格式的 registry.conf 文件的路径。您可以使用它来从不同的 registry 中镜像，如用于测试的预生产位置，而无需更改镜像设置配置文件。

      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

      将 registry.mirror 部分中的 location 字段设置为您要从中拉取镜像的替代 registry 位置。registry 部分中的 location 字段必须与您在镜像设置配置文件中指定的 registry 位置相同。

   3. 列出目录内容并验证是否已创建以下目录：

      $ ls -l

      输出示例

      my-oci-catalog      

      1

      
      oc-mirror-workspace 

      2

      
      olm_artifacts       

      3

      1

      包含 OCI 目录的目录。此流程假设它名为 my-oci-catalog。

      2

      以原始格式在目录中包含每个镜像的目录。

      3

      包含描述此目录引用的 Operator 捆绑包的文件的目录。

2. 更新镜像设置配置文件，以指定磁盘上要镜像到目标镜像 registry 的目录位置：

   镜像设置配置文件示例，用于镜像 registry

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   mirror:
    operators:
    - catalog: oci:///home/user/oc-mirror/my-oci-catalog/redhat-operator-index 

   1

   
      packages:
      - name: aws-load-balancer-operator

   1

   指定磁盘上 OCI 目录位置的绝对路径。此流程假设您使用 my-oci-catalog 作为目录并镜像 redhat-operator-index 目录。该路径必须以 oci:// 开头。

3. 运行 oc mirror 命令，以处理磁盘上镜像集文件，并将内容镜像到目标镜像 registry：

   $ oc mirror --config=./imageset-config.yaml \ 

   1

   
     --use-oci-feature \                         

   2

   
     --oci-feature-action=mirror \               

   3

   
     docker://registry.example:5000              

   4

   1

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

   2

   使用 --use-oci-feature 标志来启用 OCI 功能。

   3

   要将目录镜像到目标镜像 registry，请将 --oci-feature-action 标志设置为 mirror。

   4

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

   注意

   您可以选择使用 --oci-insecure-signature-policy 标志将签名推送到目标镜像 registry。