5.4. 将镜像集镜像(mirror)到镜像 registry
将镜像集镜像到镜像 registry 可确保所需的镜像在安全且受控的环境中可用,从而促进平稳部署、更新和维护任务。
5.4.1. 构建镜像设置配置 复制链接链接已复制到粘贴板!
oc-mirror 插件 v2 使用镜像设置配置作为输入文件,以确定镜像镜像所需的镜像。
ImageSetConfiguration 输入文件示例
- 1
- 将频道设置为从中检索 OpenShift Container Platform 镜像。
- 2
- 添加
graph: true以构建并推送 graph-data 镜像推送到镜像 registry。创建 OpenShift Update Service (OSUS) 需要 graph-data 镜像。graph: true字段还会生成UpdateService自定义资源清单。oc命令行界面 (CLI) 可以使用UpdateService自定义资源清单来创建 OSUS。如需更多信息,请参阅关于 OpenShift Update Service。 - 3
- 将 Operator 目录设置为从中检索 OpenShift Container Platform 镜像。
- 4
- 仅指定要包含在镜像集中的某些 Operator 软件包。删除此字段以检索目录中的所有软件包。
- 5
- 指定要在镜像集中包含的任何其他镜像。注意
在 oc-mirror 插件 v2 中,您必须为
additionalImages下列出的所有镜像使用显式 registry 主机名。否则,镜像会被镜像到不正确的目标路径。
5.4.2. 在部分断开连接的环境中镜像设置的镜像 复制链接链接已复制到粘贴板!
您可以在带有受限互联网访问的环境中使用 oc-mirror 插件 v2 将镜像集镜像到 registry。
先决条件
- 在运行 oc-mirror 插件 v2 的环境中,您可以访问互联网和镜像 registry。
流程
运行以下命令,将指定镜像设置配置中的镜像镜像到指定的 registry:
oc mirror -c isc.yaml --workspace file://<file_path> docker://<mirror_registry_url> --v2
$ oc mirror -c isc.yaml --workspace file://<file_path> docker://<mirror_registry_url> --v21 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 指定存储镜像并从中删除镜像的镜像 registry 的 URL 或地址。
验证
-
进入到
working-dir中的cluster-resources目录,它在<file_path>目录中生成。 -
验证
ImageDigestMirrorSet、ImageTagMirrorSet和CatalogSource资源是否存在 YAML 文件。
后续步骤
- 配置集群以使用 oc-mirror 插件 v2 生成的资源。
5.4.3. 镜像在完全断开连接的环境中设置的镜像 复制链接链接已复制到粘贴板!
您可以在 OpenShift Container Platform 集群无法访问互联网的完全断开连接的环境中镜像镜像集。
- 镜像到磁盘 :准备包含为镜像设置的镜像的存档。需要访问互联网。
- 手动步骤 :将存档传输到断开连接的镜像 registry 的网络。
- 磁盘到镜像: 要将存档中的镜像集镜像到目标断开连接的 registry,请从可访问镜像 registry 的环境运行 oc-mirror 插件 v2。
5.4.3.1. 从镜像镜像到磁盘 复制链接链接已复制到粘贴板!
您可以使用 oc-mirror 插件 v2 生成镜像集,并将内容保存到磁盘。然后,您可以将生成的镜像集传送到断开连接的环境中,并镜像到目标 registry。
oc-mirror 插件 v2 从镜像设置配置中指定的源中检索容器镜像,并将它们打包到本地目录中的 tar 存档中。
流程
运行以下命令,将指定镜像集配置中的镜像镜像到磁盘:
oc mirror -c isc.yaml file://<file_path> --v2
$ oc mirror -c isc.yaml file://<file_path> --v21 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 添加所需的文件路径。
验证
-
进入生成的
<file_path>目录。 - 验证存档文件是否已生成。
后续步骤
- 配置集群以使用 oc-mirror 插件 v2 生成的资源。
5.4.3.2. 从磁盘镜像到镜像 复制链接链接已复制到粘贴板!
您可以使用 oc-mirror 插件 v2 将磁盘中的镜像集镜像到目标镜像 registry。
oc-mirror 插件 v2 从本地磁盘检索容器镜像并将其传送到指定的镜像 registry。
流程
运行以下命令,处理磁盘上的镜像集文件,并将内容镜像到目标镜像 registry:
oc mirror -c isc.yaml --from file://<file_path> docker://<mirror_registry_url> --v2
$ oc mirror -c isc.yaml --from file://<file_path> docker://<mirror_registry_url> --v21 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 指定存储镜像并从中删除镜像的镜像 registry 的 URL 或地址。
验证
-
进入到
working-dir中的cluster-resources目录,它在<file_path>目录中生成。 -
验证
ImageDigestMirrorSet、ImageTagMirrorSet和CatalogSource资源是否存在 YAML 文件。
后续步骤
- 配置集群以使用 oc-mirror 插件 v2 生成的资源。