diff --git a/README.md b/README.md index a615fd7..b5b72ca 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,10 @@ [![Sync](https://github.com/DaoCloud/public-image-mirror/raw/gh-pages/daocloud-sync-badge.svg)](https://github.com/DaoCloud/public-image-mirror/raw/gh-pages/daocloud-sync.log) -Sync: 是 tag 的同步率 只要 tag 存在就是同步的 +Sync: 定期同步列表里的 image tag 的同步率, 只要 tag 存在就是同步的. ## 背景 + 很多镜像都在国外。比如 gcr 。国内下载很慢,需要加速。 ## 目标 @@ -21,6 +22,7 @@ docker run -d -P m.daocloud.io/docker.io/library/nginx ## 使用方法 **增加前缀** (推荐方式)。比如: + ``` k8s.gcr.io/coredns/coredns => m.daocloud.io/k8s.gcr.io/coredns/coredns ``` @@ -31,37 +33,43 @@ k8s.gcr.io/coredns/coredns => m.daocloud.io/k8s.gcr.io/coredns/coredns k8s.gcr.io/coredns/coredns => k8s-gcr.m.daocloud.io/coredns/coredns ``` -## 单次单镜像同步 (强烈推荐) +## 单次单镜像同步 + +**!!!!!!!!!!!!!!!!!!!!!!!!强烈推荐!!!!!!!!!!!!!!!!!!!!!!!!** + +您可以根据 [镜像同步 Issue 模板](https://github.com/DaoCloud/public-image-mirror/issues/new?assignees=&labels=&projects=&template=sync-image.md&title=SYNC+IMAGE) 创建一个 Issue, 将会有机器人帮您优先主动同步指定的镜像 + +> 原先已经在下的镜像还是会继续走原来的, 需要重启 docker 再重新拉取才能走已经同步好的缓存过, 所以推荐先单次同步再尝试拉取 +> 对于 latest 这种经常内容会发生变更的 tag 变更后会需要重新同步 每个 Issue **带宽** - 国际带宽 3 * 50 Mbps - 对象存储带宽 **无限制** -您可以根据 [镜像同步 Issue 模板](https://github.com/DaoCloud/public-image-mirror/issues/new?assignees=&labels=&projects=&template=sync-image.md&title=SYNC+IMAGE) 创建一个 Issue, 将会有机器人帮您优先主动同步指定的镜像 - -原先已经在下的镜像还是会继续走原来的, 需要重启 docker 再重新拉取才能走已经同步好的缓存过, 所以推荐先单次同步再尝试拉取 - -注意: 对于 latest 这种经常内容会发生变更的 tag 变更后会需要重新同步... - ## 懒加载 +> 仅推荐用于小于 20MiB 的镜像 +> 这条通道主要用于保持 image 是最新的, 每次拉取都会检查是否和上游保持同步 + +如果您看到下没有进度这是由于带宽有限只要有几人在下较大的文件就会阻塞后续的下载, 可以尝试[单次单镜像同步](#单次单镜像同步) + +就算没同步也能 **直接拉取**, 初次拉取会比已经同步过的慢, 但是[每 7 天会清理一次缓存](https://github.com/distribution/distribution/blob/e3509fc1deedaab489dd8829cc438de8f4c77fc3/registry/proxy/proxymanifeststore.go#L15). + 所有懒加载 **带宽** - 国际带宽 3 * 30 Mbps - 服务器下行带宽 3 * 5 Mbps - 单个连接限制带宽 1 Mbps -**支持懒加载**, 就算没同步也能 **直接拉取**, 初次拉取会比已经同步过的慢, 并且[每 7 天会清理一次缓存](https://github.com/distribution/distribution/blob/e3509fc1deedaab489dd8829cc438de8f4c77fc3/registry/proxy/proxymanifeststore.go#L15). +## 定期同步列表 -如果您看到下没有进度这是由于带宽有限只要有几人在下较大的文件就会阻塞后续的下载, 可以尝试单次单镜像同步 +> 不推荐, 由于数量已经比较多了初次提交, 到被同步到需要很长时间 -## 定期同步列表 (不推荐) +强烈建议使用[单次单镜像同步](#单次单镜像同步) [mirror.txt](mirror.txt) 如果想要新增, 提 PR 修改即可。例如 [PR#1](https://github.com/DaoCloud/public-image-mirror/pull/1/), 并请在 PR 提交前排序: `./hack/fmt.sh mirror.txt` -注意由于数量已经比较多了初次提交, 到被同步到至少需要一周时间, 强烈建议使用单次单镜像同步 - ## 支持前缀替换的 Registry 前缀替换的 Registry 的规则, 这是人工配置的, 有需求提 Issue.