docker registry 镜像同步的实现思路

intro

之前我们的 docker 镜像是保存在 azure 的 container registry 里的，最近我们自己搭建了一个 docker registry，我们想把之前保存的 azure 的 container registry 的 docker 镜像同步到我们自己的 docker registry 里

实现思路

我们的做法比较简单也比较low，但是基本可以满足要求，

我们的做法是

首先获取到源 registry 里的所有镜像列表
然后逐个获取镜像的 tags
然后依次遍历将对应的镜像拉到本地，然后 docker tag 一下，命名为新的 registry 镜像名称
然后 push docker 镜像到新的 registry
删除下载到本地的镜像和推送到新的 registry 的镜像

后来突然想起来阿里云好像有一个镜像同步工具，https://github.com/aliyuncontainerservice/image-syncer image-syncer 是一个docker镜像同步工具，可用来进行多对多的镜像仓库同步，支持目前绝大多数主流的docker镜像仓库服务，看介绍还是很棒的，有需要 registry 之间同步镜像的可以试试这个工具，看介绍这个工具不会拉取到本地磁盘，从源 registry 获取镜像数据之后直接就推送到新的 registry 里了，效率会高很多

docker-registry api

docker registry 有一套规范，可以查阅 https://docs.docker.com/registry/spec/api/ 了解更多

获取所有镜像

docker registry v2 新增了一个 _catalog 的 api 可以获取所有的镜像，v1 可以用 _search 来代替

语法如下：

get /v2/_catalog

默认最多返回100条记录，多余 100 可以通过参数 n 指定返回数量，分页的话可以指定另外一个参数 last指定完上一页返回的最后一个镜像，举个栗子： http://example.com/v2/_catalog?n=20&last=b

获取镜像的 tag

获取 docker 镜像的 tag 列表可以使用 get /v2/<repository-name>/tags/list 来获取，也可以分页，类似于上面获取镜像列表，可以通过 n 和 last 来实现分页加载

操作示例

在本地部署了一个测试用的 docker registry 来做演示，我这里用 httpie 来做测试

获取镜像列表：

调用 _catalog 接口来获取镜像列表

http :5000/v2/_catalog

docker registry 镜像同步的实现思路

获取镜像的 tag 列表

调用 tags/list 接口获取镜像的 tag

http :5000/v2/busybox/tags/list
http :5000/v2/redis/tags/list

docker registry 镜像同步的实现思路

powershell 脚本

一切不是自动化的运维都是耍流氓，很有可能以后会有类似的需求，不如写个脚本自动化的跑吧

下面的脚本做了一些简化，因为我们的 azure container registry 上的数量不多，只有五六十个镜像，而且镜像只有 latest 的 tag，没有其他 tag ，所以把上面的步骤做了简化，并没有分页获取所有的镜像，也没有获取所有的 tag，实际使用的话还请自行修改后使用

				?

									# variables

									$srcreguser = "xxx"

									$srcregpwd = "111111"

									$srcreghost = "xxx.azurecr.cn"

									$destreguser = "yyy"

									$destregpwd = "222"

									$destreghost = "registry.xxx.com"

									# get repositories from source registry

									# httpie

									$response = (http -b -a "${srcreguser}:${srcregpwd}" "https://${srcreghost}/v2/_catalog") | convertfrom-json

									# curl

									#$response = (curl -u "${srcreguser}:${srcregpwd}" "https://${srcreghost}/v2/_catalog") | convertfrom-json

									# repository

									$repositories = $response.repositories

									#

									write-host $repositories

									# login source registry

									docker login $srcreghost -u $srcreguser -p $srcregpwd

									# login dest registry

									docker login $destreghost -u $destreguser -p $destregpwd

									# sync

									foreach($repo in $repositories)

									{

									  write-host "sync $repo begin"

									  $srctag = "${srcreghost}/${repo}:latest"

									  $desttag = "${destreghost}/${repo}:latest"

									  write-host "source image tag: $srctag"

									  write-host "dest image tag $desttag"

									  write-host "docker pull $srctag begin"

									  docker pull $srctag

									  write-host "docker pull $srctag completed"

									  write-host "docker tag $srctag $desttag ing"

									  docker tag $srctag $desttag

									  write-host "docker push $desttag begin"

									  docker push $desttag

									  write-host "docker push $desttag completed"

									  write-host "docker rmi $srctag $desttag begin"

									  docker rmi $srctag $desttag

									  write-host "docker rmi $srctag $desttag end"

									  write-host "sync $repo completed"

									}

									write-host "completed..."