文档中心

镜像仓库

镜像迁移/同步

从 Harbor 推送镜像至火山引擎镜像仓库

本文介绍如何通过 Harbor 的复制管理功能，将 Harbor 中的镜像推送至镜像仓库，实现镜像的统一管理和分发。本文同时适用于 Harbor 2.11 及以上版本和 Harbor 2.11 以下版本，两者仅在添加目标仓库步骤的配置方式上略有差异。

场景介绍

将 Harbor 项目 harborporject 中的 Nginx 镜像文件推送至中的镜像仓库实例。根据 Harbor 版本不同，配置方式略有差异，具体对比如下。

前提条件

使用限制

镜像仓库的命名空间名称长度限制在 2 至 90 字符，若 Harbor 项目名称为 1 字符，则需在复制规则中目标 > 命名空间参数里手动配置大于等于 2 字符的命名空间名称。

操作步骤

第一步：添加目标仓库

Harbor 2.11 及以上版本

Harbor 2.11 以下版本

说明

参数	说明
提供者	选择 VolcEngine CR。
目标名	自定义目标仓库的名称。
目标 URL	填写目标镜像仓库的域名。域名可在镜像仓库实例概览页面的访问域名处查看。填写本参数时需要在访问域名前添加 https://。正确的格式如 https://****-cn-beijing.cr.volces.com。
访问 ID	账号的 Access Key ID 和 Secret Access Key，获取方法参见 API 访问密钥管理。
访问密码	账号的 Access Key ID 和 Secret Access Key，获取方法参见 API 访问密钥管理。

第二步：配置 Harbor 镜像同步

说明

本文仅介绍完成本次实践需要调整的参数，未说明的参数按照保持默认配置即可。

参数	说明
名称	自定义复制规则名称，本文示例为 harbor2cr。
复制模式	选择 Push-based。
名称	匹配的资源名称。本文需要的复制的资源为 harborproject 下的所有镜像，即可填写 harborproject/**。
目标仓库	选择在第一步中已添加的目标镜像仓库实例。
目标	可选，本文填写 crnamespace。不填写则在目标仓库中创建相同名称的命名空间。镜像仓库中命名空间名称的长度限制为 2~90。如果 Harbor 项目名称为 1 字符，需要配置大于等于 2 字符的命名空名称。

第三步：启动 Harbor 镜像同步

结果验证

在镜像仓库的目标实例、命名空间中查看镜像是否同步成功。本示例中，目标镜像实例 ****-test 的 crnamespace 命名空间中，已存在同步成功的 nginx 镜像文件，即从 Harbor 推送镜像至镜像仓库成功。

最近更新时间：2026.06.25 20:40:58

这个页面对您有帮助吗？

有用

无用