全部文档
当前文档
最近更新时间：2025-07-28 17:22:11
工具名称 | 简介与特点 | 支持仓库类型 | 项目地址 |
image-syncer | 阿里云开源，支持批量、多对多镜像迁移/同步，支持增量同步、并发、高带宽利用，不依赖磁盘存储。 | ACR、TCR、Docker Hub、Quay、Harbor 等 | |
image-transfer | 腾讯云开源，支持多种云厂商镜像仓库之间的批量迁移，支持 TCR 一键全量迁移。 | TCR、CCR、其他云厂商仓库 | |
isula-transform | openEuler 开源，用于迁移 Docker 容器（非镜像仓库级别），支持指定容器或所有容器迁移。 | 本地 Docker 容器 |
本文将介绍如何借助image-syncer工具，将其他云厂商镜像仓库（以腾讯云镜像仓库TCR为例）中镜像迁移至KCR中。
准备腾讯云待迁移镜像清单，规划迁移后镜像命名空间和仓库名称
准备腾讯云迁移账号，具备容器镜像 pull 以及访问 tags 权限。
注意不能使用腾讯云临时服务级账号，该账号类型权限不足，迁移会报错，服务级账号如下：
需准备如下类型账号：
在金山云创建命名空间 (无需创建镜像仓库名称)
Releases · AliyunContainerService/image-syncer
wget https://github.com/AliyunContainerService/image-syncer/releases/download/v1.5.3/image-syncer-v1.5.3-linux-amd64.tar.gz
tar -zvxf image-syncer-v1.5.3-linux-amd64.tar.gz创建镜像仓库的认证信息文件：auth.yaml
示例：
# 填写源端和目标端镜像仓库用户名、密码信息
hub.kce.ksyun.com/ticp:
username: 2000175494 # 客户个人镜像仓库版账号
password: ******* # 个人版镜像仓库密码
abc.tencentcloudcr.com:
username: 100027941297 #腾讯云账号
password: eyJhbGciOiJS**** #腾讯云密码配置镜像迁移同步规则：images.yaml
示例：
## 以下示例为迁移镜像仓库下全量镜像
abc.tencentcloudcr.com/icp/analysis: hub.kce.ksyun.com/icp/analysis
abc.tencentcloudcr.com/icp/model: hub.kce.ksyun.com/icp/model
## 以下示例为仅迁移镜像仓库下带有标签“latest”的镜像
abc.tencentcloudcr.com/icp/model:/latest+/: hub.kce.ksyun.com/icp/model_joke_zho:latest说明：
在迁移时，可以将原有镜像仓库重新指定命名空间和仓库名称
如：将原有命名空间：icp 下的镜像仓库，指定迁移至新的命名空间：icpnew
需要在迁移规则中做好迁移前后映射关系配置
迁移工具会根据匹配的迁移规则，自动在金山云镜像服务中创建对应的镜像仓库名称
./image-syncer --auth=./auth.yaml --images=./images.yaml --retries=2 --log=./logtail -f log创建实例
选择计费模式、region和实例规格
点击实例进入详情，创建命名空间
创建访问凭证（即访问金山云企业版仓库的账号、密码）
账号：zwltest (控制台子账号)
密码：*****
新建访问白名单：
根据实际情况填写迁移工具部署机器的公网IP地址
创建镜像仓库的认证信息文件：auth2.yaml
示例：
# 填写源端和目标端镜像仓库用户名、密码信息
zwltestkcr.ksyunkcr.com/cuda:
username: zwltest # 企业版镜像仓库登录名
password: ******* # 登录密码（访问凭证）
abc.tencentcloudcr.com:
username: 100027941297 #腾讯云账号
password: eyJhbGciOiJS**** #腾讯云密码配置镜像迁移同步规则：images2.yaml
示例：
## 以下示例为迁移镜像仓库下全量镜像
abc.tencentcloudcr.com/cuda/cudatest: zwltestkcr.ksyunkcr.com/cuda/cudatest
## 以下示例为仅迁移镜像仓库下带有标签“latest”的镜像
abc.tencentcloudcr.com/cuda/model:/latest+/: zwltestkcr.ksyunkcr.com/cuda/model执行镜像仓库迁移
./image-syncer --auth=./auth2.yaml --images=./images2.yaml --retries=2 --log=./log纯净模式