mordiford

memo:sakuracloud-container-registry

長い!

さくらのクラウド「コンテナレジストリ」を regclient で便利に使う

「コンテナレジストリ」「シンプル通知」CR版提供終了および正式サービス開始時期のお知らせ | さくらのクラウドニュース

いよいよさくらのクラウド「コンテナレジストリ」の無償テスト期間が終わり、有償の正式サービスが始まりましたね。
正式リリース前に作っていた組は年度末まで無償です。来年度からは基本料金+ストレージ超過分の従量課金なのですが、つまり年度内に減らせるものがあれば減らしたほうがいいですね。

私たちも独自に改変した Mastodon を運用しており、GitHub Actions によって Docker イメージをビルド、さくらのコンテナレジストリに保管して各サーバーからPullしています[1]。

latest 以外にも、検証用に様々なブランチを切ってはその場限りのタグを生成するので、結構な量が積もっているはずです。年度内になんとかしないといけません。
…しかし、コンパネからはどれだけのタグが生えてしまっているのかも、個別のタグの削除方法も分かりません。困りましたね。

コンパネで出来ないこと、regctl でやっちゃいましょう

さくらのコンテナレジストリは Docker Hub 互換を謳っています。つまり、OCI Distribution Specification あるいはそれ以前の Docker Registry HTTP API に準じた API は備わっていると考えるのが自然でしょう(間違ってたら教えて下さい)。

そこで今日の9割、これらのAPIを扱うクライアントである regclient の備える便利コマンド、 regctl のご紹介です。

regctl is 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. All regctl commands have a --help flag 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"

  1. なんでpublicじゃないかって?ロゴとか入れちゃってるので… ↩︎

  2. 面倒すぎてCopilotに書かせました。 ↩︎