镜像仓库
镜像仓库
文档指南
请输入
- 文档首页
镜像仓库镜像仓库 CR用户指南实例同步外部仓库同步至镜像仓库
复制全文
下载 pdf外部仓库同步至镜像仓库
文档反馈
问问助手本文主要介绍实例同步功能中，将外部仓库迁移到火山引擎镜像仓库标准版实例的操作。
背景信息
镜像仓库 CR 支持一键迁移火山引擎以外的外部仓库至标准版实例，为您提供专业稳定的托管服务及技术支持，减少自行搭建及维护的运维管理成本，满足低复杂度交付业务需求。
注意
近期中国大陆地区出现无法访问 Docker Hub 的现象，导致无法直接通过实例同步规则将 Docker Hub 镜像迁移至中国地域镜像仓库中。
当前镜像仓库支持远端代理功能，支持将 Docker Hub 镜像迁移至镜像仓库。
使用限制
- 当前支持迁移的外部仓库源包括：腾讯云 TCR 企业版、阿里云 ACR、AWS ECR 私有 类型存储库、Harbor、 Docker、 Google Artifact Registry（GAR）、 Docker Registry。
- 请确保外部仓库源能够通过 公网 正常推拉镜像，当前仅支持公网的方式同步外部镜像。
- 海外镜像源迁移至中国大陆地域的镜像仓库时，不保证迁移的成功率。
前提条件
- 源实例和目标实例均已处于 运行中 状态。
- 已准备好外部仓库实例的地址、用户名、密码等相关信息。
操作步骤
步骤一：配置同步规则
- 登录 镜像仓库控制台。
- 在左侧导航栏选择 实例同步，单击 创建实例同步规则。
- 在 创建实例同步规则 页面，根据要求填写参数信息。
- 实例同步类型
- 参数说明同步类型选择 外部迁移，将外部仓库迁移到火山引擎镜像仓库标准版实例中。
- 基本信息
- 参数说明名称自定义同步规则名称。同一个账号下名称必须唯一。
- 源/目标实例配置
-
说明
外部仓库的来源，目前支持腾讯云 TCR 企业版、阿里云 ACR、AWS ECR 私有 类型存储库、Harbor、 Docker、 Google Artifact Registry（GAR）、Docker Registry。
- 源实例
- 说明仅支持迁移 腾讯云企业版 至火山引擎镜像仓库。参数说明服务地址以 http(s):// 开头的外部源仓库服务地址。例如 https://test-sync.tencentcloudcr.com。Access Key IDSecret Access Key仓库类型仅支持 镜像 仓库类型下制品同步，Chart 仓库下制品不支持同步。命名空间腾讯云镜像仓库中需要同步的命名空间名称，单击回车键确定。仓库需要同步的外部源仓库命名空间下的 OCI 制品仓库。
- 全部：同步指定命名空间下的全部 OCI 制品仓库。
- 正则匹配：通过输入正则规则，匹配需要同步的 OCI 制品仓库。配置详情，请参见 正则匹配示例。
版本 Tag注意- 迁移阿里云镜像仓库资源至火山引擎镜像仓库时，为了避免源实例限流，单次同步的镜像数量不能超过 20 个，建议在 15 个以内。
- Access Key ID 需要至少具备阿里云镜像仓库服务 ACK 的访问权限（例如 AliyunContainerRegistryReadOnlyAccess），以免权限不足导致同步失败。
参数说明API 调用地址以 http(s):// 开头的 API 服务接入地址。例如 https://cr.cn-beijing.aliyuncs.com。实例 ID需要同步的阿里云镜像仓库实例的 ID。Access Key ID访问阿里云 OpenAPI 的账号。Secret Access Key访问阿里云 OpenAPI 的账号所对应的密钥。仓库类型仅支持 镜像 仓库类型下制品同步，Chart 仓库下制品不支持同步。命名空间阿里云镜像仓库中需要同步的命名空间名称，单击回车键确定。仓库需要同步的外部源仓库命名空间下的 OCI 制品仓库。- 全部：同步指定命名空间下的全部 OCI 制品仓库。
- 正则匹配：通过输入正则规则，匹配需要同步的 OCI 制品仓库。配置详情，请参见 正则匹配示例。
版本 Tag参数说明服务地址以 http(s):// 开头的外部源仓库服务地址。例如 http://180.**.**.**。忽略证书有效性是否忽略源仓库地址的证书有效性。- 是：忽略外部源仓库证书的有效性，直接同步外部仓库至镜像仓库。
- 否： 不忽略外部源仓库证书的有效性，若源仓库证书不在有效期内，则无法同步。以 https 开头的服务地址必须选择 否。
注意外部源仓库证书必须为权威机构签发的证书，否则此处选择 否 后，会同步失败。用户名登录 Harbor 仓库的用户名。密码登录 Harbor 仓库的密码。命名空间Harbor 仓库中需要同步的项目名称。仓库需要同步的外部源仓库命名空间下的 OCI 制品仓库。- 全部：同步指定命名空间下的全部 OCI 制品仓库。
- 正则匹配：通过输入正则规则，匹配需要同步的 OCI 制品仓库。配置详情，请参见 正则匹配示例。
版本 Tag参数说明服务地址以 http(s):// 开头的外部源仓库服务地址。例如 http(s)://index.dockrhub.io。忽略证书有效性是否忽略源仓库地址的证书有效性。- 是：忽略外部源仓库证书的有效性，直接同步外部仓库至镜像仓库。
- 否： 不忽略外部源仓库证书的有效性，若源仓库证书不在有效期内，则无法同步。
注意外部源仓库证书必须为权威机构签发的证书，否则此处选择 否 后，会同步失败。Access Key IDAWS 账号的 Access Key ID。Secret Access KeyAWS 账号的 Secret Access Key。仓库需要同步的外部源仓库命名空间下的 OCI 制品仓库。- 全部：同步指定命名空间下的全部 OCI 制品仓库。
- 正则匹配：通过输入正则规则，匹配需要同步的 OCI 制品仓库。配置详情，请参见 正则匹配示例。
版本 Tag注意Docker Hub 的免费用户存在镜像拉取速率限制，超出限制可能导致同步失败。建议配置方法如下：- 正则匹配 采用精确写法，非模糊匹配，避免拉取无用的镜像。例如 仓库 填写 nginx，版本 Tag 正则匹配 填写 ^v1.0.0$。
- 同步间隔时长 6 小时以上，避免频繁拉取导致限速。
-
参数说明访问地址固定为 https://hub.docker.com。用户名登录 Dockerhub 仓库的用户名。注意必须使用 Docker Hub 仓库的注册用户名登录，不支持使用邮箱地址登录。密码登录 Dockerhub 仓库的密码。类型支持同步公共仓库和个人仓库：- library：同步公开的 Dockhub 仓库，可以获取 nginx，ubuntu 等基础镜像。
- 个人仓库：同步个人账号下的 Dockerhub 仓库。
命名空间Docker 仓库中需要同步的命名空间名称。- Library（公共仓库）：固定为 library。
- 个人仓库：对应 Dockerhub 中的 account + organzation。
仓库需要同步的外部源仓库命名空间下的 OCI 制品仓库。- Library（公共仓库）：
仅支持仓库名称精准匹配，需要正确填写公共仓库的名称，例如 nginx、ubuntu，python、redis 等。- 个人仓库：
- 全部：同步指定命名空间下的全部 OCI 制品仓库。
- 正则匹配：通过输入正则规则，匹配需要同步的 OCI 制品仓库。配置详情，请参见 正则匹配示例。
版本 Tag参数说明服务地址输入来源实例的服务地址。忽略证书有效性是否跳过 SSL/TLS 证书有效性的验证，避免报错。镜像拉取鉴权是否开启镜像拉取的鉴权。拉取私有镜像需要开启鉴权功能并填写用户名和密码。用户名填写登录仓库的用户名。密码填写登录仓库的密码。命名空间填写仓库中需要同步的命名空间名称。注意一个规则仅支持填写一个命名空间。仓库填写需要同步的外部源仓库命名空间下的 OCI 制品仓库，支持填写多个 OCI 制品仓库。版本 Tag注意- 仅中国香港、亚太东南（柔佛）、亚太东南（雅加达）地域支持 Google Cloud 类型镜像仓库的实例同步功能。
- 如果需要迁移 Google Cloud 公共镜像，请在 源实例 > 来源 选择 Docker Registry 类型。
参数说明服务地址以 http(s):// 开头的外部源仓库服务地址。例如 https://southamerica-west1-docker.pkg.dev。用户名自动获取，您无需填写。访问密钥Google Cloud Platform（GCP）的访问密钥。在 GCP 服务账号页面 创建服务账号，并生成密钥。您需要至少获取 Artifact Registry 的 Reader 角色，并添加 resourcemanager.projects.get 权限。仓库类型固定为 镜像。命名空间Google Artifact Registry（GAR）项目下的命名空间，对应 GAR 中的代码库 Repository。项目名称填写 Google Cloud Platform（GCP）中项目名称（Project）。仓库版本 Tag
- 目标实例
- 参数说明实例名称选择镜像仓库中的目标标准版实例，外部仓库将同步到该标准版实例。命名空间选择标准版实例下的目标命名空间。注意
- 不填写则默认同步至与源仓库同名的命名空间。
- 不填写且若不存在同名命名空间，默认在目标实例下创建同名的命名空间。
- 源实例为 Docker 类型且选择 library 时，默认同步至命名空间 library 下。没有 library 命名空间则时默认创建。
- 同步规则
-
步骤二：执行同步规则
支持如下两种触发方式：
- 若您在配置同步规则时选择 定时触发，则系统会定时自动触发一次同步。
说明
定时触发的同步规则，也可以手动触发。
- 若您选择 手动触发，请参考以下步骤：
- 在 镜像仓库控制台 的左侧导航栏选择 实例同步。
- 在 实例同步 页面，找到需要触发的规则，单击对应 操作 列的 触发。
- 在系统弹出的提示框中确认规则信息，单击 确定，触发同步操作。
步骤三：查看同步日志
- 在 镜像仓库控制台 左侧导航栏选择 实例同步。
- 在 实例同步 页面，找到目标规则，单击规则名称。
- 在规则详情页面，单击 同步日志 页签，查看对应规则的所有同步日志。
-
- 单击任务 ID，可查看该同步任务的详情。展示本次同步任务源实例下的[namespace]/[repo]:tag，目标实例下的[namespace]/[repo]:tag，及同步状态。
- 同步状态为 成功 表明源实例的制品成功同步到目标实例；同步状态为 失败 表明源实例的制品未能同步到目标实例。
最近更新时间：2026.07.08 10:45:37
这个页面对您有帮助吗？
有用
有用
无用
无用