【TCR】从 AWS 环境一键迁移镜像到TCR

原创

Jokey

发布于 2025-12-04 15:09:10

1070

文章被收录于专栏：云原生搬运工云原生搬运工

准备环境

1. 执行机器：一台 aws 服务器或cloudshell作为跳板机执行同步镜像脚本（需要有aws 命令并配置好账号认证）。

2. 已开通ECR 和 TCR 。

3. 执行机器可访问到 ECR 和 TCR。

4. 下载附件示例代码到执行机器并解压进入到主目录。

附件：

[image-transfer-demo.zip]

操作步骤

1. 下载迁移工具（可选，示例代码包中已下载）：

工具地址：GitHub - tkestack/image-transfer

wget https://github.com/tkestack/image-transfer/releases/download/v1.2.3/image-transfer-linux-amd64.tar.gz
tar -zxvf image-transfer-linux-amd64.tar.gz

2. 修改 registry-secret.yaml.tpl（重要）：

配置说明参考：镜像仓库鉴权配置文件。

xxx.tencentcloudcr.com: # TCR实例地址
    username:  xxx  # TCR 用户名
    password:  xxx  # TCR 密钥
xxx.dkr.ecr.ap-southeast-1.amazonaws.com: # ECR实例地址
  username: AWS
  password: <AWS_ECR_TOKEN> # 不要动

参数获取说明：

TCR实例地址获取：

TCR 用户名和TCR 密钥获取：

3. 创建镜像仓库（可选，不创建也可以，同步时会自动根据同步规则创建）

4. 修改transfer-rule.yaml （重要）：

配置说明参考：镜像迁移仓库配置文件。

# 若根据 tag 同步
# xxx.dkr.ecr.ap-southeast-1.amazonaws.com/jokey-ecr:latest: xxx.tencentcloudcr.com/kofj/jokey:latest
# 若根据 repo 同步
xxx.dkr.ecr.ap-southeast-1.amazonaws.com/jokey-ecr: xxx.tencentcloudcr.com/kofj/jokey
配置说明：ecr 地址在前， tcr地址在后，按照实际地址填写

5. 执行脚本同步：

# 交互式（需输入ECR地域和TCR 命名空间）：
./run-transfer.sh

# 非交互式：
# AWS_REGION: AWS ECR 地域
# REGISTRY：TCR 实例地址
# NS： TCR 仓库命名空间。
AWS_REGION="ap-southeast-1" REGISTRY="xxx.tencentcloudcr.com" NS="kofj" ./run-transfer.sh

同步成功的日志如下示例：