OpenNextのR2に溜まる古いビルドのキャッシュを、opennext-r2-janitorで掃除する
OpenNextでNext.jsをCloudflare Workersにデプロイしているサイトで、R2のincremental cacheに古いビルドのキャッシュが溜まり続けていました。掃除用のライブラリopennext-r2-janitorを作り、本番に導入するまでの流れを紹介します。
目次
Next.jsをOpenNextでCloudflare Workersにデプロイする場合、ISRなどで使うキャッシュ(incremental cache)をどこに保存するかを設定します。KVやR2などから選べるのですが、この選び方によって発生するコストの種類や大きさが変わります。
この記事では、OpenNextをつかったISRでたまったキャッシュファイルを掃除する方法についてまとめました。
KVを使うと、キャッシュが消えずに残り続けるらしい
きっかけはMeathill Studioの記事を読んだことでした。この記事によると、OpenNextのKV版incremental cacheはkv.put()にexpirationTtlを渡していないそうです。KVは有効期限を指定せずに書き込んだキーを自動では消さないため、デプロイのたびに新しいBuild IDでキャッシュが追加され、古いキャッシュはそのまま残り続けます。筆者の環境では、これが24GBまで膨らんだとのことでした。
自分のサイトもNext.jsをOpenNextでCloudflare Workersにデプロイしています。ただしキャッシュの保存先はR2なので、「KVと同じ課金の問題は起きないだろう」と思っていました。とはいえ念のため、R2のバケットも確認してみることにしました。
R2でも、古いビルドのキャッシュは残り続けていた
調べてみると、R2でも同じことが起きていました。OpenNextはR2のキーをincremental-cache/<buildId>/<hash>.<cacheType>という形式で作ります。これは@opennextjs/cloudflare 1.19.11のソースで確認しました。Build IDが変わると別のフォルダにキャッシュが書かれるため、古いビルドのフォルダは誰にも読まれないまま残ってしまいます。
2026/10/14時点のバケットには、143個のBuild IDのフォルダと、約7万9,000個のオブジェクトがありました。合計サイズは約10.8 GiBですが、そのうち実際に使われていたのは現行ビルドの約0.3 GiBだけです。
今すぐコストの問題になるわけではない
R2のStandardストレージは1 GBあたり月0.015ドルで、毎月10 GBまでは無料枠に収まります(R2の料金ページ)。10.8 GiBだと無料枠をわずかに超えますが、超過分は月数セント程度なので、今すぐ困るような金額ではありません。
ただ、デプロイするたびに確実に増えていきますし、放っておいて減ることもありません。デプロイ回数が多いプロジェクトほど、いずれ無視できない量になりそうです。
opennext-r2-janitorで古いビルドのキャッシュを掃除する
そこで、R2に残った古いビルドのキャッシュを削除するライブラリ「opennext-r2-janitor」を作り、npmで公開しました。
このライブラリは、Build IDのフォルダごとに削除してよいものを判定します。次のいずれかに当てはまるビルドは残し、それ以外を削除します。
- 現在配信しているビルド
- 直近14日以内に現行だったビルド(ロールバック先の保護)
- 直近14日以内に書き込みがあったビルド
キャッシュを削除する処理なので、誤って消さないための仕組みもいくつか用意しました。初期設定ではdry-runモードで動き、削除予定のビルドをログに出すだけです。また、現行ビルドのフォルダが見つからない場合や、想定と違う形式のキーを見つけた場合は、何も削除せずに処理を止めます。1回の実行で呼び出すR2のAPIは40回までに抑えているので、量が多い場合は次回の実行で続きを処理します。
Custom Workerにscheduledハンドラを追加する
自分のサイトでは、OpenNextのCustom Workerを使ってライブラリを組み込みました。OpenNextが生成する.open-next/worker.jsをラップして、Cron Triggerから呼ばれるscheduledハンドラを追加しています。
import { default as openNextWorker } from '../.open-next/worker.js'
import { type JanitorEnv, runR2Janitor } from './libs/r2Janitor'
export { DOQueueHandler } from '../.open-next/worker.js'
export default {
fetch: openNextWorker.fetch,
scheduled(_controller, env: JanitorEnv, ctx) {
ctx.waitUntil(runR2Janitor(env))
},
}
runR2Janitorの中でライブラリのcleanupOpenNextR2Cacheを呼び出し、結果をJSON形式でWorkers Logsに出力します。
wrangler.jsoncにCron Triggerと環境変数を追加する
wrangler.jsoncでは、エントリポイントのmainをこのファイルに差し替え、Cron Triggerと環境変数を追加しました。R2のバインディング(NEXT_INC_CACHE_R2_BUCKET)はOpenNextの設定ですでに用意していたものをそのまま使っています。
{
"main": "src/custom-worker.ts",
"triggers": {
"crons": ["17 3 * * *"]
},
"vars": {
"JANITOR_DRY_RUN": "false",
"JANITOR_KEEP_DAYS": "14"
}
}
JANITOR_DRY_RUNが"false"のときだけ実際に削除し、それ以外の値ではすべてdry-runとして動きます。JANITOR_KEEP_DAYSは残すビルドを判定するときの日数です。導入した直後はJANITOR_DRY_RUNを"true"にし、Cronも"17 * * * *"(1時間ごと)にしていました。
なお、掃除をやめたいときはcronsを[]にします。Cron Triggerはtriggersの設定を消したりコメントアウトしたりしただけでは止まらないので、この点は注意が必要です。
本番環境で古いキャッシュを削除してみた
いきなり削除するのは怖いので、まずはdry-runのまま1時間ごとのCronで動かしました。ログに出た削除予定のうち91フォルダをR2の実際の一覧と見比べたところ、すべてオブジェクト数が一致しており、14日以内に書き込まれたものもありませんでした。現行ビルドと直前まで配信していたビルドが「残す」と判定されていることも確認できています。
確認が終わったところで、実際に削除するモードへ切り替えました。1時間ごとに少しずつ削除が進み、切り替えた翌日には一通りの掃除が完了しています。145個あったフォルダは8個まで減り、残ったのは現行ビルドと、直近14日以内に使われたか書き込みがあったビルドだけです。期間中にも何度かデプロイしましたが、そのたびに新しい現行ビルドと直前のビルドはきちんと残っていました。
1回の実行にかかったCPU時間は、削除中で41〜156ミリ秒、掃除が終わった後は20ミリ秒前後です。サイトへのリクエストでエラーが増えることもなかったので、溜まっていた分を消し終えたタイミングでCronを1日1回に減らしました。
まとめ
KVを使っていないから大丈夫だろうと思っていたのですが、R2でも古いビルドのキャッシュは確実に溜まっていました。今のところは無料枠をわずかに超える程度なので、すぐにコストの問題になるわけではありません。
とはいえ、デプロイのたびに増え続けるものです。OpenNextとR2を組み合わせて使っている場合は、こういった掃除の仕組みを早めに入れておくのがよさそうです。