3.6. 从 oc-mirror 插件 v1 迁移到 v2

流程

1. 修改 API 版本并删除 ImageSetConfiguration 中的已弃用字段。

   带有 oc-mirror 插件 v1 配置的 ImageSetConfiguration 文件示例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   mirror:
     platform:
       channels:
         - name: stable-4.17
       graph: true
     helm:
       repositories:
         - name: sbo
           url: https://redhat-developer.github.io/service-binding-operator-helm-chart/
     additionalImages:
       - name: registry.redhat.io/ubi8/ubi:latest
       - name: quay.io/openshifttest/hello-openshift@sha256:example_hash
     operators:
       - catalog: oci:///test/redhat-operator-index
         packages:
           - name: aws-load-balancer-operator
   storageConfig:  # REMOVE this field in v2
     local:
       path: /var/lib/oc-mirror

   带有 oc-mirror 插件 v2 配置的 ImageSetConfiguration 文件示例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v2alpha1
   mirror:
     platform:
       channels:
         - name: stable-4.17
       graph: true
     helm:
       repositories:
         - name: sbo
           url: https://redhat-developer.github.io/service-binding-operator-helm-chart/
     additionalImages:
       - name: registry.redhat.io/ubi8/ubi:latest
       - name: quay.io/openshifttest/hello-openshift@sha256:example_hash
     operators:
       - catalog: oci:///test/redhat-operator-index
         packages:
           - name: aws-load-balancer-operator

2. 运行以下命令，检查工作目录中的 IDMS、ITMS、CatalogSource 和 ClusterCatalog 资源中的 cluster-resources 目录：

   $ ls <v2_workspace>/working-dir/cluster-resources/

3. 迁移完成后，验证镜像的镜像和目录是否可用：

   • 确保镜像过程中没有发生错误或警告。
   • 确保没有生成错误文件(working-dir/logs/mirroring_errors_YYYYMMdd_HHmmss.txt)。

4. 使用以下命令验证镜像镜像和目录是否可用：

   $ oc get catalogsource -n openshift-marketplace

   $ oc get imagedigestmirrorset,imagetagmirrorset -n openshift-config

   如需更多信息，请参阅"使用 oc-mirror 插件 v2 为断开连接的安装镜像镜像"。

5. 可选：使用 oc-mirror 插件 v1 删除镜像镜像：

   1. 使用 oc-mirror 插件 v1 镜像镜像。

   2. 将 ImageSetConfiguration 文件中的 API 版本从 v1alpha2 (v1)更新至 v2alpha1 (v2)，然后运行以下命令：

      $ oc-mirror -c isc.yaml file://some-dir --v2

      注意

      storageConfig 不是 ImageSetConfiguration 和 DeleteImageSetConfiguration 文件中的有效字段。当升级到 oc-mirror 插件 v2 时删除此字段。

   3. 运行以下命令生成删除清单并删除 v1 镜像：

      $ oc-mirror delete --config=delete-isc.yaml --generate --delete-v1-images --workspace file://some-dir docker://registry.example:5000  --v2

      重要

      oc-mirror 插件 v2 不会自动修剪目标 registry，这与 oc-mirror 插件 v1 不同。要清理不再需要的镜像，请使用 v2 中的删除功能及 --delete-v1-images 命令标志。

      删除所有使用 oc-mirror 插件 v1 的镜像后，您不再需要使用此标志。如果您需要删除使用 oc-mirror 插件 v2 镜像，请不要 set --delete-v1-images。

      有关删除镜像的更多信息，请参阅"从断开连接的环境中删除镜像"。

   4. 运行以下命令，根据生成的清单删除镜像：

      $ oc-mirror delete --delete-yaml-file some-dir/working-dir/delete/delete-images.yaml docker://registry.example:5000 --v2