Skip to content

Latest commit

 

History

History
115 lines (82 loc) · 3.65 KB

README.md

File metadata and controls

115 lines (82 loc) · 3.65 KB
Raw

镜像迁移工具：image-transfer

image-transfer 是一个docker镜像迁移工具，用于对不同镜像仓库的镜像进行批量迁移。

特性

  • 支持多对多镜像仓库迁移
  • 支持腾讯云 TCR 个人版(CCR)一键全量迁移至企业版
  • 支持基于 Docker Registry V2搭建的docker镜像仓库服务 (如 腾讯云TCR个人版(CCR)/TCR企业版、Docker Hub、 Quay、 阿里云镜像服务ACR、 Harbor等)
  • 支持自定义 qps 限速，避免迁移时对仓库造成过大压力
  • 同步不落盘，提升同步速度
  • 利用 pipeline 模型，提高任务执行效率
  • 增量同步, 通过对同步过的镜像 blob 信息落盘，不重复同步已同步的镜像
  • 并发同步，可以通过配置文件调整并发数
  • 自动重试失败的同步任务，可以解决大部分镜像同步中的网络抖动问题
  • 不依赖docker以及其他程序

模式

tcr镜像迁移工具具有两种运行模式：

  • 通用模式：支持多种镜像仓库迁移
  • 腾讯云 CCR 一键全量迁移模式：腾讯云 TCR 个人版(CCR) -> TCR企业版

架构

image

使用

下载和安装

在releases页面可下载源码以及二进制文件

手动编译

git clone https://github.com/tkestack/image-transfer.git
cd ./image-transfer

# 编译
make

使用方法

使用帮助

./image-transfer -h

使用示例1：通用模式

设置镜像鉴权配置文件为 registry-secret.yaml，镜像迁移仓库规则文件为 transfer-rule.yaml，默认迁移目标为腾讯云 TCR 个人版：ccr.ccs.tencentyun.com，默认 namespace 为 default，并发数为 5，

./image-transfer --securityFile=./registry-secret.yaml --ruleFile=./transfer-rule.yaml \  
--ns=default --registry=ccr.ccs.tencentyun.com --routines=5 --retry=3

使用示例2：腾讯云 CCR 一键全量迁移模式

打开ccr迁移模式 ccrToTcr=true, 设置镜像仓库鉴权配置文件为 registry-secret.yaml，腾讯云 API 调用密钥配置文件为 tencentcloud-secret.yaml，默认个人版及企业版实例所在地域均为 ap-guangzhou（广州） TCR 企业版实例示例名称为 image-transfer, 并发数为 5，失败重试次数为 3

./image-transfer --ccrToTcr=true --securityFile=./registry-secret.yaml --secretFile=./tencentcloud-secret.yaml \ 
--tcrName=image-transfer --tcrRegion=ap-guangzhou --ccrRegion=ap-guangzhou --routines=5 --retry=3

配置文件参考

腾讯云 API 密钥配置文件 tencentcloud-secret.yaml

如需迁移至腾讯云容器镜像服务内，需配置腾讯云 API 调用密钥，可前往 控制台-访问管理-访问密钥-API密钥管理 获取密钥对。如果在同账号下将 TCR 个人版数据迁移至企业版实例内，可共用同一套密钥。

ccr:
    secretId: xxx
    secretKey: xxx
tcr:
    secretId: xxx
    secretKey: xxx

镜像仓库鉴权配置文件 registry-secret.yaml

配置源目标及迁移目标镜像仓库的访问凭证，即 Docker Login 所使用的用户名，密码。

ccr.ccs.tencentyun.com:
  username: xxx
  password: xxx
image-transfer.tencentcloudcr.com:
  username: xxx
  password: xxx
registry.hub.docker.com:
  username: xxx
  password: xxx
registry.cn-guangzhou.aliyuncs.com:
  username: xxx
  password: xxx
acr.cn-guangzhou.cr.aliyuncs.com:
  username: xxx
  password: xxx

镜像迁移仓库配置文件 transfer-rule.yaml

配置镜像迁移规则，即镜像仓库，镜像版本在源目标及迁移目标内的映射关系。

demo-ns/nginx:latest : image-transfer.tencentcloudcr.com/demo-ns/nginx:latest