Cloudflare Pagesのビルド回数を確認する — 月500回制限と使用状況の見方

自分のブログを Cloudflare Pages で動かしていて、毎日 cron から自動コミットを流している。先月、何気なくダッシュボードを開いたら、ビルドの履歴が想像よりずいぶん長く伸びていてヒヤッとした。Free プランには月500回のビルド上限があり、知らない間に届いていてもおかしくない^[1]。数えてみたら案外コミットが積まれていたので、確認の手順をメモしておく。

月500回というのはどういう制限か

Cloudflare Pages の Free プランでは「Builds per month」が500回までと決まっている^[1:1]。月をまたぐとリセットされる。

Cloudflare Pages のビルドは、git push で起動されるデプロイや、ダッシュボードから手動で実行する再デプロイの1回ずつをカウントしたもの。複数ブランチを持っていれば、それぞれの push が個別のビルドになる。

単純に30日で割ると、1日あたりおよそ16回。普通の個人開発なら余裕に見えるが、cron で自動コミットを流す運用や、CI/CD で何度も挙動を試している期間には急に近づく。プレビュー用のブランチでも本番と同じ枠を消費する点には注意したい。

自分の使用状況を見る

集計画面が用意されていないので、履歴を眺めるか API で数えるかの二択になる。

ダッシュボードの Deployments タブ

Cloudflare ダッシュボードにログインし、対象アカウントから Workers & Pages → 該当プロジェクトを開くと、Deployments というタブがある。ここに過去のビルドが新しい順に並んでいて、日付ごとの粒度で消費状況が見える。

ただし「今月N回目」のような数値表示は無い。スクロールしながら自分で月初までさかのぼって数えることになるので、ざっくり把握する用途と割り切るのがいい。

API で月初からの件数を数える

数えるのが面倒なら、API を叩いたほうが速い^[2]。Pages > Projects > Deployments > list のエンドポイントから過去のデプロイを取得して、created_on を月でフィルタする。

ACCOUNT_ID="your-account-id"
PROJECT="your-project-name"
TOKEN="your-api-token"
MONTH=$(date +%Y-%m)

curl -s "https://api.cloudflare.com/client/v4/accounts/${ACCOUNT_ID}/pages/projects/${PROJECT}/deployments?per_page=100" \
  -H "Authorization: Bearer ${TOKEN}" \
  | jq --arg m "$MONTH" '[.result[] | select(.created_on | startswith($m))] | length'