文档中心

镜像仓库

镜像迁移/同步

通过 cr-image-syncer 批量迁移镜像

cr-image-syncer 是镜像仓库自研的通用镜像迁移工具，支持将通用 Docker Registry 类型的镜像仓库迁移至火山引擎镜像仓库。

场景描述

多云和搬站场景中都涉及到镜像仓库的迁移工作，cr-image-syncer工具可以有效的支持通用 Docker Registry 类型的镜像仓库的迁移。

前提条件

说明

公网：当前镜像仓库已产品化支持通过公网，将阿里云、腾讯云、AWS、Google、Harbor、Docker 等云厂家镜像仓库，一键迁移至火山引擎镜像仓库，操作详情参见外部仓库同步至镜像仓库。

操作步骤

第一步：下载并安装工具

wget https://cr-tools.tos-cn-beijing.volces.com/darwin/amd64/cr-image-syncer && chmod a+x cr-image-syncer

wget https://cr-tools.tos-cn-beijing.volces.com/linux/amd64/cr-image-syncer && chmod a+x cr-image-syncer

第二步：批量创建命名空间

配置	说明
type	云厂商的代号，固定为 volc。
apiHost	OpenAPI 访问地址，固定为 cr.cn-beijing.volcengineapi.com 。
region	火山引擎镜像仓库实例实例所属地域。
instance	火山引擎镜像仓库实例的名称，不是实例 ID。
accessKey	访问火山引擎 OpenAPI 所需的密钥信息，获取方法参见 API 访问密钥管理。
secretKey	访问火山引擎 OpenAPI 所需的密钥信息，获取方法参见 API 访问密钥管理。

配置	说明
repositoryDefaultAccessLevel	命名空间中制品仓库的默认公私有类型。 Private：私有 OCI 制品仓库类型，需要输入访问密钥后才能够访问。 Public：公有 OCI 制品仓库类型，不需要访问密钥，支持直接访问。
name	待创建命名空间的名称。

cr-image-syncer prepare create-namespace --config config.yaml --namespaces namespace.yaml --debug

第三步：批量同步镜像

将鉴权信息添加至配置文件 config.yaml 中。本示例为第三方云迁移之前火山引擎，source 填写第三方云镜像仓库鉴权信息，target 填写火山引擎镜像仓库鉴权信息。

配置	说明
registryHost	镜像迁移源仓库货目标仓库的地址。
registryUsername/ registryPassword	镜像仓库的登录信息。第三方云镜像仓库登录信息请参见对应的官网文档。火山引擎镜像仓库登录信息参见标准版实例访问凭证。
insecure	镜像仓库是否允许 HTTP 登录，建议选择否，填写 false。

src-regsitry-cn-beijing.cr.****.com/****/repo: dst-registry-cn-beijing.cr.volces.com/ns1/repo
src-regsitry-cn-beijing.cr.****.com/****/a: dst-registry-cn-beijing.cr.volces.com/ns2/a
src-regsitry-cn-beijing.cr.****.com/****/ubuntu: dst-registry-cn-beijing.cr.volces.com/ns2/ubuntu

# --debug 按需增加
cr-image-syncer copy --without-prepare --config config.yaml --images images.yaml --debug

操作结果

操作完成后可在对应的 OCI 制品仓库镜像列表中查看已完成同步的镜像。

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

这个页面对您有帮助吗？

有用

无用