資訊

什么是 image-syncer？

• 依賴磁盤存儲(chǔ)，需要及時(shí)進(jìn)行本地鏡像的清理，并且落盤造成多余的時(shí)間開銷，難以勝任生產(chǎn)場(chǎng)景中大量鏡像的遷移
• 依賴 docker 程序，docker daemon 對(duì) pull/push 的并發(fā)數(shù)進(jìn)行了嚴(yán)格的限制，無法進(jìn)行高并發(fā)同步
• 一些功能只能通過 HTTP api 進(jìn)行操作，單純使用 docker cli 無法做到，使腳本變得復(fù)雜

• 支持多對(duì)多鏡像倉庫同步
• 支持基于 Docker Registry V2 搭建的 docker 鏡像倉庫服務(wù) (如 Docker Hub、 Quay、 阿里云鏡像服務(wù) ACR、 Harbor 等)
• 同步只經(jīng)過內(nèi)存和網(wǎng)絡(luò)，不依賴磁盤存儲(chǔ)，同步速度快
• 增量同步, 通過對(duì)同步過的鏡像 blob 信息落盤，不重復(fù)同步已同步的鏡像
• 并發(fā)同步，可以通過配置文件調(diào)整并發(fā)數(shù)
• 自動(dòng)重試失敗的同步任務(wù)，可以解決大部分鏡像同步中的網(wǎng)絡(luò)抖動(dòng)問題
• 不依賴 docker 以及其他程序

如何使用 image-syncer？

{
 "auth": { // 認(rèn)證字段，其中每個(gè)對(duì)象為一個(gè) registry 的一個(gè)賬號(hào)和
 // 密碼；通常，同步源需要具有 pull 以及訪問 tags 權(quán)限，
 // 同步目標(biāo)需要擁有 push 以及創(chuàng)建倉庫權(quán)限，如果沒有提供，則默認(rèn)匿名訪問
 
 "quay.io": { // registry 的 url，需要和下面 images 中對(duì)應(yīng) registry 的 url 相同
 "username": "xxx", // 用戶名，可選
 "password": "xxxxxxxxx", // 密碼，可選
 "insecure": true // registry 是否是 http 服務(wù)，如果是，insecure 字段需要為 true，默認(rèn)是 false，可選，支持這個(gè)選項(xiàng)需要 image-syncer 版本 > v1.0.1
 },
 "registry.cn-beijing.aliyuncs.com": {
 "username": "xxx",
 "password": "xxxxxxxxx"
 },
 "registry.hub.docker.com": {
 "username": "xxx",
 "password": "xxxxxxxxxx"
 }
 },
 "images": {
 // 同步鏡像規(guī)則字段，其中條規(guī)則包括一個(gè)源倉庫（鍵）和一個(gè)目標(biāo)倉庫（值）
 // 同步的最大單位是倉庫（repo），不支持通過一條規(guī)則同步整個(gè) namespace 以及 registry
 // 源倉庫和目標(biāo)倉庫的格式與 docker pull/push 命令使用的鏡像 url 類似（registry/namespace/repository:tag）
 // 源倉庫和目標(biāo)倉庫（如果目標(biāo)倉庫不為空字符串）都至少包含 registry/namespace/repository
 // 源倉庫字段不能為空，如果需要將一個(gè)源倉庫同步到多個(gè)目標(biāo)倉庫需要配置多條規(guī)則
 // 目標(biāo)倉庫名可以和源倉庫名不同（tag 也可以不同），此時(shí)同步功能類似于：docker pull + docker tag + docker push
 "quay.io/coreos/kube-rbac-proxy": "quay.io/ruohe/kube-rbac-proxy",
 "xxxx":"xxxxx",
 "xxx/xxx/xx:tag1,tag2,tag3":"xxx/xxx/xx"
 // 當(dāng)源倉庫字段中不包含 tag 時(shí)，表示將該倉庫所有 tag 同步到目標(biāo)倉庫，此時(shí)目標(biāo)倉庫不能包含 tag
 // 當(dāng)源倉庫字段中包含 tag 時(shí)，表示只同步源倉庫中的一個(gè) tag 到目標(biāo)倉庫，如果目標(biāo)倉庫中不包含 tag，則默認(rèn)使用源 tag
 // 源倉庫字段中的 tag 可以同時(shí)包含多個(gè)（比如"a/b/c:1,2,3"），tag 之間通過","隔開，此時(shí)目標(biāo)倉庫不能包含 tag，并且默認(rèn)使用原來的 tag
 // 當(dāng)目標(biāo)倉庫為空字符串時(shí)，會(huì)將源鏡像同步到默認(rèn) registry 的默認(rèn) namespace 下，并且 repo 以及 tag 與源倉庫相同，默認(rèn) registry 和默認(rèn) namespace 可以通過命令行參數(shù)以及環(huán)境變量配置，參考下面的描述
 } 
}

• 創(chuàng)建 ACR 實(shí)例
• 創(chuàng)建命名空間
• 創(chuàng)建訪問憑證
• 進(jìn)行權(quán)限管理，完成配置

• 下載 image-syncer 可執(zhí)行文件（目前只支持 linux amd64 版本，可以自行編譯）并解壓，然后運(yùn)行工具

最新版源碼以及二進(jìn)制文件：
https://github.com/AliyunContainerService/image-syncer/releases/tag/v1.0.3

常見問題

原文鏈接：

https://yq.aliyun.com/articles/727565?utm_content=g_1000088598 
Github 開源地址：
https://github.com/AliyunContainerService/image-syncer 
更多 FAQ 參見：
https://github.com/AliyunContainerService/image-syncer/blob/master/FAQs.md