130 lines
4.6 KiB
Markdown
130 lines
4.6 KiB
Markdown
# public-image-mirror
|
||
|
||
[](https://github.com/DaoCloud/public-image-mirror/raw/gh-pages/daocloud-sync.log)
|
||
|
||
Sync: 是 tag 的同步率 只要 tag 存在就是同步的
|
||
|
||
## 背景
|
||
很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。
|
||
|
||
## 目标
|
||
|
||
* 一个简洁有效的方法能够加速这些包。简洁的名称映射
|
||
* 易于添加，添加新的包，不需要去修改代码。
|
||
* 稳定可靠，更新实时。每天检查同步情况。
|
||
|
||
## 快速开始
|
||
|
||
```
|
||
docker run -d -P m.daocloud.io/docker.io/library/nginx
|
||
```
|
||
## 使用方法
|
||
|
||
**增加前缀** (推荐方式)。比如：
|
||
```
|
||
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 **带宽**
|
||
- 国际带宽 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 变更后会需要重新同步...
|
||
|
||
## 懒加载
|
||
|
||
所有懒加载 **带宽**
|
||
- 国际带宽 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.
|
||
|
||
| 源站 | 替换为 |
|
||
| ----------------------- | ----------------------------- |
|
||
| cr.l5d.io | l5d.m.daocloud.io |
|
||
| docker.elastic.co | elastic.m.daocloud.io |
|
||
| docker.io | docker.m.daocloud.io |
|
||
| gcr.io | gcr.m.daocloud.io |
|
||
| ghcr.io | ghcr.m.daocloud.io |
|
||
| k8s.gcr.io | k8s-gcr.m.daocloud.io |
|
||
| registry.k8s.io | k8s.m.daocloud.io |
|
||
| mcr.microsoft.com | mcr.m.daocloud.io |
|
||
| nvcr.io | nvcr.m.daocloud.io |
|
||
| quay.io | quay.m.daocloud.io |
|
||
| registry.jujucharms.com | jujucharms.m.daocloud.io |
|
||
| rocks.canonical.com | rocks-canonical.m.daocloud.io |
|
||
|
||
## 最佳实践
|
||
|
||
* 通过 加速 安装 kubeadm
|
||
``` bash
|
||
kubeadm config images pull --image-repository k8s-gcr.m.daocloud.io
|
||
```
|
||
|
||
* 通过 加速 安装 kind
|
||
|
||
``` bash
|
||
kind create cluster --name kind --image m.daocloud.io/docker.io/kindest/node:v1.22.1
|
||
```
|
||
|
||
* 通过 加速 部署 应用(这里以 Ingress 为例)
|
||
|
||
``` bash
|
||
wget -O image-filter.sh https://github.com/DaoCloud/public-image-mirror/raw/main/hack/image-filter.sh && chmod +x image-filter.sh
|
||
|
||
wget -O deploy.yaml https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.1.0/deploy/static/provider/baremetal/deploy.yaml
|
||
|
||
cat ./deploy.yaml | ./image-filter.sh | kubectl apply -f -
|
||
```
|
||
|
||
* Docker 加速
|
||
|
||
添加到 `/etc/docker/daemon.json`
|
||
``` json
|
||
"registry-mirrors": [
|
||
"https://docker.m.daocloud.io"
|
||
]
|
||
```
|
||
|
||
## [友情链接]加速三剑客
|
||
|
||
* 镜像加速：https://github.com/DaoCloud/public-image-mirror
|
||
* 二进制文件加速：https://github.com/DaoCloud/public-binary-files-mirror
|
||
* Helm 加速：https://github.com/DaoCloud/public-helm-charts-mirror
|
||
|
||
|
||
## 贡献者
|
||
|
||
<a href="https://github.com/DaoCloud/public-image-mirror/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=DaoCloud/public-image-mirror" />
|
||
</a>
|
||
|
||
Made with [contrib.rocks](https://contrib.rocks).
|