操作场景
对于使用自建Harbor存储容器镜像的用户,可以通过开源镜像迁移工具image-syncer迁移至容器镜像服务企业版。
前提条件
• 已开通容器镜像服务企业版实例
操作步骤
1. 下载 image-syncer 并进行解压。
wget https://github.com/AliyunContainerService/image-syncer/releases/download/v1.3.1/image-syncer-v1.3.1-linux-amd64.tar.gz tar -zvxf image-syncer-v1.3.1-linux-amd64.tar.gz
也可参照官方文档使用其他方式进行安装: https://github.com/AliyunContainerService/image-syncer
2. 创建镜像仓库的认证信息文件auth.json,在其中填写Harbor和容器镜像服务企业版的地址以及用户名和密码,示例:
{
"<harbor_url>": { // Harbor地址
"username": "xxx", // Harbor用户名
"password": "xxx" // Harbor密码
},
"registry-huadong1.crs.ctyun.cn": { // 企业版实例地址
"username": "xxx", // 企业版用户名
"password": "xxx" // 企业版密码
}
}3. 创建镜像同步规则文件images.json,在其中指定Harbor源仓库和容器镜像服务企业版目标仓库的对应关系,示例:
{
"<harbor_url>/myns/nginx": "registry-huadong1.crs.ctyun.cn/myns/nginx" // 格式为源仓库:目标仓库,image-syncer将自动同步源仓库下的镜像至目标仓库
}注意,企业版实例需要先新建对应的命名空间和镜像仓库,或者在命名空间开启 自动创建仓库 选项。
4. 执行image-syncer命令开始镜像迁移。
./image-syncer --auth=./auth.json --images=./images.json
命令行可选参数包括:
参数 | 说明 |
–images | 设置镜像同步规则文件的路径 |
–auth | 设置镜像仓库认证文件的路径 |
–log | 设置输出log文件路径,默认打印到标准错误输出 |
–proc | 镜像同步的并发数,默认为5 |
–retries | 同步任务失败时的重试次数,默认为2,重试有助于减少因网络波动而导致的同步任务失败次数。 |
5. 等待命令执行完成,镜像便已成功迁移至企业版实例对应仓库下。