基於cloudflare workers自建docker映象

xuanli233發表於2024-06-08
CloudDocker

緣由

因為近期國內映象站點的變動，自建docker映象也提上了日程。順便發現了Hammal這個優秀的專案。

Hammal 是執行於 cloudflare workers 上的 Docker 映象加速工具，用於解決獲取 Docker 官方映象速度緩慢以及完全無法獲取 k8s.gcr.io 上映象的問題。

在這裡感謝如下兩個專案

tomwei7/hammal: docker-registry proxy run in cloudflare workers (github.com)

pengfujin-momo/hammal: docker-registry proxy run in cloudflare workers (github.com)

使用姿勢

首先安裝 wrangler 命令列工具, 並登入

npm install -g wrangler
wrangler login

克隆或者下載專案到本地

並在資料夾目錄下操作

git clone https://github.com/tomwei7/hammal.git 
cd hammal
mv wrangler.toml.sample wrangler.toml

參考wrangler.toml.sample，進行如下修改並儲存為wrangler.toml

獲取 account_id id, 並修改 wrangler.toml 檔案中的 account_id id

wrangler whoami

建立 KV namespace

wrangler kv:namespace create hammal_cache

上面的程式碼別改kv名稱，程式碼中還有依賴（

修改 wrangler.toml 檔案填充 kv_namespaces 中的 id

另，原作者的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 = "your account_id"
workers_dev = true
route = ""
zone_id = ""
webpack_config = "webpack.config.js"
kv_namespaces = [
	 { binding = "HAMMAL_CACHE", id = "you kv id" }
]

最後釋出 workers，大功告成~~

wrangler deploy

釋出 workers 可以獲得類似 https://hammal.{your_name}.workers.dev 的地址，修改 registry-mirrors 地址為該地址即可。但是強烈建議前往workers-設定-觸發器 中繫結自己的域名。官方workers.dev訪問效果不佳。

<<EOF sudo tee /etc/docker/daemon.json
{
  "registry-mirrors": [
    "你的域名"
  ]
}
EOF

新增其他映象源映象

目前 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

相關文章