红帽全球峰会第 6 章 从 oc-mirror 插件 v1 迁移到 v2
oc-mirror v2 插件对镜像 mirror 工作流进行了重大更改。本指南为迁移提供了步骤说明，同时确保与 oc-mirror 插件 v2 兼容。
您必须通过修改 API 版本并删除已弃用的字段来手动更新配置。如需更多信息，请参阅"从 oc-mirror 插件 v1 改为 v2"。
6.1. 从 oc-mirror 插件 v1 改为 v2
在从 oc-mirror 插件 v1 迁移到 v2 之前，请参阅 oc-mirror 插件 v1 和 v2 之间的以下区别：
-
显式版本选择：在使用
oc-mirror时，用户必须明确指定--v2。如果没有指定版本，则默认执行 v1。此行为预期会在以后的版本中改变，其中--v2是默认设置。 更新了命令：镜像工作流的命令已更改为与 oc-mirror 插件 v2 的新工作流保持一致。
对于 mirror-to-disk，请运行以下命令：
oc-mirror --config isc.yaml file://<directory_name> --v2
$ oc-mirror --config isc.yaml file://<directory_name> --v2Copy to Clipboard Copied! Toggle word wrap Toggle overflow 对于 disk-to-mirror，运行以下命令：
oc-mirror --config isc.yaml --from file://<directory_name> docker://<remote_registry> --v2
$ oc-mirror --config isc.yaml --from file://<directory_name> docker://<remote_registry> --v2Copy to Clipboard Copied! Toggle word wrap Toggle overflow 对于 mirror-to-mirror，运行以下命令：
oc-mirror --config isc.yaml --workspace file://<directory_name> docker://<remote_registry> --v2
$ oc-mirror --config isc.yaml --workspace file://<directory_name> docker://<remote_registry> --v2Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意mirror-to-mirror 操作现在需要
--workspace。
-
API 版本更新：
ImageSetConfigurationAPI 版本从v1alpha2(v1)改为v2alpha1(v2)。迁移前，您必须手动更新配置文件。 配置更改：
-
storageConfig必须在 oc-mirror 插件 v2 中删除。 - 现在，通过工作目录或本地缓存自动处理增量镜像。
-
在结果目录中更改：要应用到断开连接的集群的所有自定义资源都会在迁移后的
<workspace_path>/working-dir/cluster-resources目录中生成。- oc-mirror 插件 v2 中的输出不会存储在与 oc-mirror 插件 v1 相同的位置。
您必须检查工作目录中的
cluster-resources文件夹以查找以下资源：-
ImageDigestMirrorSet(IDMS) -
ImageTagMirrorSet(ITMS) -
CatalogSource -
ClusterCatalog -
UpdateService
-
工作区和目录命名：遵循新的 oc-mirror v2 约定，以防止在不同版本间进行转换时潜在的数据不一致。
-
oc-mirror 插件 v1
oc-mirror-workspace目录不再需要。 - 为 oc-mirror 插件 v2 使用新目录以避免冲突。
-
oc-mirror 插件 v1
将
ImageContentSourcePolicy(ICSP) 资源替换为 IDMS/ITMS ：重要删除所有
ImageContentSourcePolicy(ICSP)资源可能会删除与 oc-mirror 无关的配置。为了避免意外删除，请在删除前识别 oc-mirror 生成的 ICSP 资源。如果您不确定，请与集群管理员进行检查。如需更多信息，请参阅"使用 oc-mirror 插件 v2 为断开连接的安装镜像镜像"。
-
在 oc-mirror 插件 v2 中，ICSP 资源由
ImageDigestMirrorSet(IDMS)和ImageTagMirrorSet(ITMS)资源替代。
-
在 oc-mirror 插件 v2 中，ICSP 资源由
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}