Hammal
是运行于cloudflare workers
上的 Docker 镜像加速工具,用于解决获取 Docker 官方镜像速度缓慢以及完全无法获取k8s.gcr.io
上镜像的问题。项目地址: https://github.com/pengfujin-momo/hammal
环境要求:
新版
Node.js
已经自带npm
,无需手动安装npm
。
1、如何部署 {#1%E3%80%81%E5%A6%82%E4%BD%95%E9%83%A8%E7%BD%B2}
1.1、安装wrangler并登录 {#1.1%E3%80%81%E5%AE%89%E8%A3%85wrangler%E5%B9%B6%E7%99%BB%E5%BD%95}
安装 https://developers.cloudflare.com/workers/get-started/guide/ , 并登录
npm install -g wrangler
`wrangler login
`
1.2、克隆项目 {#1.2%E3%80%81%E5%85%8B%E9%9A%86%E9%A1%B9%E7%9B%AE}
如需使用
git命令
还需额外安装git插件
;建议下载项目
ZIP文件
,无需安装git插件
。
克隆或者下载项目到本地,并在文件夹目录下操作
git clone https://github.com/tomwei7/hammal.git
cd hammal
`mv wrangler.toml.sample wrangler.toml
`
参考wrangler.toml.sample
,进行如下修改并保存为wrangler.toml
1.3、获取account_id {#1.3%E3%80%81%E8%8E%B7%E5%8F%96account_id}
获取 account_id
, 并修改 wrangler.toml
文件中的 account_id
wrangler whoami
1.4、获取kv_namespaces {#1.4%E3%80%81%E8%8E%B7%E5%8F%96kv_namespaces}
创建 KV namespace
wrangler kv:namespace create hammal_cache
上面的代码不要修改kv名称
,代码中还有依赖
修改 wrangler.toml
文件填充kv_namespaces 中的 id
1.5、最终配置文件 {#1.5%E3%80%81%E6%9C%80%E7%BB%88%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6}
wrangler.toml.sample
缺少如下两行,手动添加上去,否则部署会报错
main = "src/index.ts"
compatibility_date = "2022-10-29"
修改后的代码
name = "hammal"
type = "webpack"
main = "src/index.ts"
compatibility_date = "2022-10-29"
account_id = "改为自己的 account_id"
workers_dev = true
route = ""
zone_id = ""
webpack_config = "webpack.config.js"
kv_namespaces = [
{ binding = "HAMMAL_CACHE", id = "改为自己的 kv_namespaces id" }
]
1.6、发布 {#1.6%E3%80%81%E5%8F%91%E5%B8%83}
发布完成后需等待路由建立成功,可能需要几小时才能完成;
若配置自己的域名,则需要将域名
DNS
托管到Cloudflare
,产生的影响:
后续添加解析需在
Cloudflare
中添加,已有解析会自动同步过来;这也可能影响到
DDNS解析
,建议使用一个新的域名完成托管。
发布 workers
,大功告成~~
wrangler deploy
发布 workers
可以获得类似 https://hammal.{your_name}.workers.dev
的地址,修改 registry-mirrors
地址为该地址即可。但是强烈建议前往workers-设置-触发器
中绑定自己的域名。官方workers.dev
访问效果不佳。
sudo tee /etc/docker/daemon.json
`{
"registry-mirrors": [
"你的域名"
]
}
`
2、添加其他镜像源镜像 {#2%E3%80%81%E6%B7%BB%E5%8A%A0%E5%85%B6%E4%BB%96%E9%95%9C%E5%83%8F%E6%BA%90%E9%95%9C%E5%83%8F}
目前 hammal
支持获取 k8s.gcr.io
, gcr.io
, quay.io
的镜像,可以通过修改 handler.ts
中的 ORG_NAME_BACKEND
添加
# 拉取 k8s.gcr.io 镜像
docker pull hammal.{your_name}.workers.dev/k8sgcr/kubernetes-dashboard-amd64:v1.8.3
拉取 gcr.io 镜像
============
docker pull hammal.{your_name}.workers.dev/gcr/youlib/image:tags
拉取 quay.io 镜像
=============
`docker pull hammal.{your_name}.workers.dev/quay/coreos/flannel:v0.13.1-rc2`