memo:sakuracloud-container-registry
長い!
さくらのクラウド「コンテナレジストリ」を regclient で便利に使う
いよいよさくらのクラウド「コンテナレジストリ」の無償テスト期間が終わり、有償の正式サービスが始まりましたね。
正式リリース前に作っていた組は年度末まで無償です。来年度からは基本料金+ストレージ超過分の従量課金なのですが、つまり年度内に減らせるものがあれば減らしたほうがいいですね。
私たちも独自に改変した Mastodon を運用しており、GitHub Actions によって Docker イメージをビルド、さくらのコンテナレジストリに保管して各サーバーからPullしています[1]。
latest 以外にも、検証用に様々なブランチを切ってはその場限りのタグを生成するので、結構な量が積もっているはずです。年度内になんとかしないといけません。
…しかし、コンパネからはどれだけのタグが生えてしまっているのかも、個別のタグの削除方法も分かりません。困りましたね。
コンパネで出来ないこと、regctl でやっちゃいましょう
さくらのコンテナレジストリは Docker Hub 互換を謳っています。つまり、OCI Distribution Specification あるいはそれ以前の Docker Registry HTTP API に準じた API は備わっていると考えるのが自然でしょう(間違ってたら教えて下さい)。
そこで今日の9割、これらのAPIを扱うクライアントである regclient の備える便利コマンド、 regctl のご紹介です。
regctlis a command line interface to the Go library designed to facilitate adhoc queries and scripting. See the CLI Reference for a full list of commands and and their usage. Allregctlcommands have a--helpflag that shows available child commands, usage, flags, and often contain examples.
ドキュメントを読めるタイプの人であればもう後は公式ドキュメントを読んでください。必要な機能が揃っています。
とりあえずよく使うやつだけ簡単に紹介します。
regctl registry login
regctl registry login example.sakuracr.jp
でレジストリ example.sakuracr.jp にログインできます。
regctl tag ls
regctl tag ls example.sakuracr.jp/docker-img
docker-img のタグ一覧を引っ張ってこれます。
regctl tag delete
regctl tag delete example.sakuracr.jp/docker-img:this-tag-is-obsoleted
docker-img の this-tag-is-obsoleted タグを削除できます。ls なんだから rm だろと思ったら、delete のエイリアスらしいです。
仕上げ
example.sakuracr.jp の docker-img に存在する、latest と stable 以外のタグをお掃除するやつを適当に用意します[2]。
#!/bin/bash
DRY_RUN=false
if [[ "$1" == "--dry-run" ]]; then
DRY_RUN=true
fi
REPO="example.sakuracr.jp/docker-img"
# 除外タグ
EXCLUDE_TAGS=("latest" "stable")
# タグ一覧を取得
TAGS=$(regctl tag ls "$REPO")
while read -r TAG; do
# 空行スキップ
[[ -z "$TAG" ]] && continue
# 除外タグチェック
if [[ ${EXCLUDE_TAGS[*]} =~ ${TAG} ]]; then
echo "Skipping excluded tag: $TAG"
continue
fi
if $DRY_RUN; then
echo "[DRY-RUN] Would delete tag: $TAG"
else
echo "Deleting tag: $TAG"
regctl tag delete "$REPO:$TAG"
fi
done <<< "$TAGS"