随着容器技术的发展，镜像管理变得越来越重要。Harbor 是一个开源的企业级容器镜像仓库管理系统，提供了丰富的功能，如镜像存储、访问控制、镜像复制等。火山引擎镜像仓库是字节跳动提供的容器镜像仓库服务，提供了高性能、高可靠的镜像存储和分发服务。本文将介绍如何将 Harbor 镜像同步至火山引擎镜像仓库，以实现镜像的统一管理和分发。

场景介绍

将 Harbor 项目 harborporject 中的 Nginx 镜像文件推送至火山引擎中的镜像仓库实例。

前提条件

• 在 Harbor 中创建一个项目（harborproject），并将需要同步的镜像文件推送到该项目中。
  • 创建项目参见 Create Projects。
  • 推送镜像参见 Pulling and Pushing Images in the Docker Client。
• 在火山引擎中创建一个镜像仓库，并获取该火山引擎账号的 AK/SK。
  • 创建火山引擎镜像仓库参见 创建标准版实例。
  • 火山引擎账号 AK/SK 的获取方法参见 API 访问密钥管理。

使用限制

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

操作步骤

第一步：添加目标仓库

1. 登录 Harbor 控制台。

2. 在左侧导航栏单击 系统管理 > 仓库管理。

3. 在 仓库管理 页面，单击 新建目标，创建目标仓库。

4. 配置参数。
   

   说明

   • 本文仅介绍完成本次实践需要调整的参数，未说明的参数按照保持默认配置即可。
   • 完成配置后，单击 测试链接 验证是否能够连接目标实例。

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

5. 单击 确定，完成操作。

第二步：配置 Harbor 镜像同步

1. 登录 Harbor 控制台。

2. 在左侧导航栏单击 系统管理 > 复制管理。

3. 在 复制管理 页面，单击 新建规则，创建镜像同步规则。

4. 配置参数。
   

   说明

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

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

5. 单击 保存，完成操作。

第三步：启动 Harbor 镜像同步

1. 在 复制管理 页面，选中目标复制规则（harbor2cr），单击 复制。
   
2. 在二次确认页面，单击 复制。
3. 在页面底部的 复制任务 区域，查看目标任务的状态。状态为 Succeed 即同步任务执行成功。
   

结果验证

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