docker registry 鏡像同步

Intro

之前我們的 docker 鏡像是保存在 Azure 的 Container Registry 里的，最近我們自己搭建了一個 docker registry，我們想把之前保存的 Azure 的 Container Registry 的 docker 鏡像同步到我們自己的 docker registry 里

實現(xiàn)思路

我們的做法比較簡單也比較LOW，但是基本可以滿足要求封救，

我們的做法是

1. 首先獲取到源 Registry 里的所有鏡像列表
2. 然后逐個獲取鏡像的 tags
3. 然后依次遍歷將對應的鏡像拉到本地，然后 docker tag 一下，命名為新的 registry 鏡像名稱
4. 然后 push docker 鏡像到新的 registry
5. 刪除下載到本地的鏡像和推送到新的 registry 的鏡像

后來突然想起來阿里云好像有一個鏡像同步工具崩掘，https://github.com/AliyunContainerService/image-syncer image-syncer 是一個docker鏡像同步工具，可用來進行多對多的鏡像倉庫同步少办，支持目前絕大多數(shù)主流的docker鏡像倉庫服務苞慢，看介紹還是很棒的，有需要 registry 之間同步鏡像的可以試試這個工具英妓，看介紹這個工具不會拉取到本地磁盤挽放，從源 registry 獲取鏡像數(shù)據(jù)之后直接就推送到新的 registry 里了绍赛，效率會高很多

Docker-Registry API

docker registry 有一套規(guī)范，可以查閱 https://docs.docker.com/registry/spec/api/ 了解更多

獲取所有鏡像

docker registry v2 新增了一個 _catalog 的 api 可以獲取所有的鏡像辑畦，v1 可以用 _search 來代替

語法如下：

GET /v2/_catalog

默認最多返回100條記錄惹资，多余 100 可以通過參數(shù) n 指定返回數(shù)量，分頁的話可以指定另外一個參數(shù) last指定完上一頁返回的最后一個鏡像航闺，舉個栗子： http://example.com/v2/_catalog?n=20&last=b

獲取鏡像的 tag

獲取 docker 鏡像的 tag 列表可以使用 GET /v2/<repository-name>/tags/list 來獲取褪测，也可以分頁，類似于上面獲取鏡像列表潦刃，可以通過 n 和 last 來實現(xiàn)分頁加載

操作示例

在本地部署了一個測試用的 docker registry 來做演示侮措，我這里用 httpie 來做測試

獲取鏡像列表：

調(diào)用 _catalog 接口來獲取鏡像列表

http :5000/v2/_catalog

image

獲取鏡像的 tag 列表

調(diào)用 tags/list 接口獲取鏡像的 tag

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

image

PowerShell 腳本

一切不是自動化的運維都是耍流氓，很有可能以后會有類似的需求乖杠，不如寫個腳本自動化的跑吧

下面的腳本做了一些簡化分扎，因為我們的 azure container registry 上的數(shù)量不多，只有五六十個鏡像胧洒，而且鏡像只有 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..."

More

如果要同步的鏡像比較多列赎，考慮使用阿里云的鏡像同步工具去同步

Reference

• https://stackoverflow.com/questions/31251356/how-to-get-a-list-of-images-on-docker-registry-v2
• https://github.com/AliyunContainerService/image-syncer
• https://docs.docker.com/registry/spec/api/