キャッシュ無効化とは?
キャッシュの無効化とは、通常の有効期限を迎える前に、キャッシュ内のエントリーを削除するか、古い状態としてマークすることです。その後のリクエストでは、新たな取得やオリジンでの再検証が行われます。古い状態としてマークされただけのエントリーは、キャッシュポリシーによっては、その間も配信される場合があります。
キャッシュ無効化の仕組み
無効化により、配信者は鮮度の有効期間が過ぎるのを待たずにキャッシュの状態を変更できます。HTTP 自体が提供する仕組みは限られています。PUT、POST、DELETE など、安全でないメソッドによるリクエストが成功し、キャッシュを通過すると、その URL が無効化されます。ただし、影響するのはそのリクエストの経路上にあるキャッシュだけです。また、どの Cache-Control ディレクティブでも、保存済みのレスポンスを消去することはできません。そのため、CDN は独自の制御プレーンを公開しており、特定の URL、プレフィックス、タグ、またはディストリビューション全体を対象にできる場合があります。その後、対象ノードがオブジェクトを削除するか、再検証を必須にします。ハードパージはオブジェクトを削除するため、次のリクエストはキャッシュミスとなり、オブジェクト全体を取得して再びキャッシュします。ソフトパージはオブジェクトを保持したまま古い状態としてマークするため、次のリクエストで再検証が行われ、オリジンが 304 Not Modified を返すと、保存済みの本文を再利用できます。呼び方はプロバイダーによって異なります。Cloudflare はソフト操作を無効化、ハード操作をパージと呼びますが、Amazon CloudFront と Google Cloud CDN が無効化と呼ぶ操作では、オブジェクトが削除されます。
要点
- 元の URL をパージすると、リサイズや形式変換した派生版も削除されますか?削除されるのは、プロバイダーがそれらを一つのオブジェクトとして扱う場合か、まとめて対象に指定した場合だけです。まず、派生版の URL が元の URL とどう異なるかを確認してください。Fastly CDN サービスでは、パージリクエストに変換パラメーターがなければ、Image Optimizer が元の画像とすべての派生版をパージします。Fastly Compute サービスでは、共通のサロゲートキーを指定し、Purge API を通じて同じ範囲をパージします。Cloudflare は、Vary for Images 機能を使用する画像 URL の、キャッシュ済みのすべての派生版をパージします。一方、Amazon CloudFront では、ディストリビューションがクエリ文字列をオリジンに転送する場合、無効化パスにクエリ文字列を含めるか、末尾にワイルドカード
*を付けてすべてのクエリ文字列を対象にする必要があります。一つの URL を指定したパージは、別のパスで公開された派生版には適用されません。別のホスト名も対象になるかどうかはプロバイダーによって異なります。Google Cloud CDN のパス無効化は、ホストを指定しない限り、ロードバランサー上のすべてのホスト名に適用されます。選択条件に含まれない派生版には、共通のキャッシュタグやサロゲートキー、プレフィックスによるパージ、または明示的なリストが必要です。 - どの順序で実行し、成功をどう確認すればよいでしょうか?まずオリジンのコンテンツを修正してください。Cloudflare と Google Cloud CDN はどちらも、そうしないと次のリクエストで古いバージョンが再びキャッシュされる可能性があると警告しています。API の成功レスポンスは、削除の証明にはなりません。Cloudflare のドキュメントによると、パージリクエストに対する HTTP 200 は受信の確認であり、何かがキャッシュされていたことや、キャッシュから削除されたことを示すものではありません。同社は、アセットをリクエストし、
CF-Cache-StatusがもはやHITではないことを確認するよう案内しています。このヘッダーは補助的な判断材料であり、証明ではありません。パージ後の最初のリクエストではMISSが報告され、以降のリクエストでは、再充填されたコピーについてHITが報告されます。一方、STALEまたはUPDATINGは、保存されていた期限切れのコピーが配信されたことを意味します。ローカルキャッシュのないクライアントで元のファイルと影響を受ける各派生版をリクエストし、返された内容が置き換え後のものであることを確認してください。各レスポンスが示すのは、一つのキャッシュの状態です。Google Cloud CDN によると、ごく一部のキャッシュで処理が済んでいなくても、無効化が完了と報告されることがあります。これはまれな状態で、自然に解消されます。CloudFront では送信済みの無効化をキャンセルできないため、送信前にパスを確認してください。 - CDN のパージでブラウザー内のコピーも更新されますか?いいえ、更新されません。Google Cloud CDN は、無効化がウェブブラウザーのキャッシュや、第三者のインターネットサービスプロバイダーが運用するキャッシュのコピーには影響しないと明記しています。CloudFront のガイドでも、これらのキャッシュで期限が切れるまで、ユーザーには古いバージョンが表示され続ける可能性があるとしています。こうしたコピーをより早く回避するには、修正したファイルを新しいファイル名またはパスで公開し、参照元のページを更新してください。これは、頻繁に更新するファイルについて、CloudFront が無効化よりもバージョン付きファイル名を推奨する理由の一つです。古い URL で保存されたコピーが削除されるわけではありません。新しい URL を参照するページが、古いコピーをリクエストしなくなるだけです。クエリ文字列だけの変更は、より確実性が低い方法です。経路上のすべてのキャッシュがキャッシュキーにクエリ文字列を含めている場合にしか機能しないためです。たとえば Cloudflare の「Ignore Query String」キャッシュレベルでは、クエリ文字列だけが異なる URL は一つのキャッシュオブジェクトを共有します。URL を変更できず、同じ URL のまま内容を修正する可能性がある場合は、ブラウザーでのキャッシュ有効期間を長く設定しないでください。
- ハードパージとソフトパージのどちらを、どの範囲に適用すべきでしょうか?すべてをハードパージすると、キャッシュが再充填されるまでリクエストはオリジンから配信されます。Cloudflare は、アセットが多くトラフィックの多いサイトでは、オリジンへのリクエストが急増し、サイトの速度低下やオリジンの過負荷を招く可能性があると警告しています。Google も、必要なものだけを無効化するよう勧めています。ソフトパージでは、次のリクエストで再検証し、保存済みの本文を再利用できます。ただし、これはオリジンが
ETagまたはLast-Modifiedを送信し、条件付きリクエストに応答する場合に限られます。Cloudflare は、共通のキャッシュタグを持つアセット群など、変更されていない可能性があるコンテンツの更新に、この方法を勧めています。その反面、期限切れとマークされたコンテンツが閲覧者に届く可能性は残ります。Fastly は、ソフトパージしたオブジェクトは更新版の取得中に古いまま配信されると説明しています。Cloudflare も、オリジンが 5xx エラーを返す場合や到達不能な場合には、無効化したコンテンツを古いまま配信することがあります。古いコンテンツを二度と配信してはならない場合は、ハードパージを使用してください。リクエストの集約とオリジンシールド層により、オリジンに届く再充填リクエストの数を減らせます。
キャッシュ無効化が重要になる場面
有効期間が切れる前に緊急の修正を反映する必要がある場合は、アセットのキャッシュを無効化します。CDN で無効化しても、ブラウザーや下流のキャッシュがすでに保持しているコピーには反映されないため、定期的に変更されるコンテンツは、バージョン付きのファイル名で公開する方が適しています。パージの対象は、変更を反映するために必要な最小限の範囲に絞ってください。広範囲にパージすると、削除したすべてのコンテンツを、リクエストが届くたびにオリジンから再取得する必要があります。
キャッシュ無効化における Transloadit の役割
Transloadit の Smart CDN は、変換結果ごとに、その tlcdn.com URL でキャッシュします。ドキュメントでは、結果を再利用する期間を事前に制限する設定について説明しています。Robot /file/serve の cache_duration パラメーターは、結果とともに送信するブラウザーおよび共有キャッシュの有効期間を設定します。署名付き URL では、実際のキャッシュ有効期間は署名の残りの有効期間に制限されます。
ここでリンクしているページには、Smart CDN のパージや無効化の操作についての説明はありません。また、ファイルパスを変えずに元のファイルを置き換えた場合に、キャッシュ済みの結果がどうなるかも説明されていません。Smart CDN の URL は、ソースファイルと、Template が読み取る変換パラメーターを指定します。そのため、ファイルパスを変えるか、これらのパラメーターのいずれかの値を変えると、別の変換版をリクエストします。これらのページには、無関係なパラメーターを追加すればキャッシュ済みの結果を回避できるとは記載されていません。パスを変更しない場合の動作に依存する前に、自分の Workspace で検証してください。
出典
- RFC 9111、4.4 節:保存済みレスポンスの無効化
- MDN:HTTP キャッシュ(保存済みレスポンスの削除と管理対象キャッシュ)
- Amazon CloudFront:ファイルの無効化によるコンテンツの削除
- Amazon CloudFront:パスの無効化に関する注意点
- Cloudflare:キャッシュのパージ(方法と検証)
- Cloudflare:キャッシュ済みコンテンツの無効化(パージと無効化の違い)
- Cloudflare:キャッシュレスポンス(CF-Cache-Status の値)
- Cloudflare:キャッシュキー(クエリ文字列とキャッシュキー)
- Fastly:パージの基本(ソフトパージ、ハードパージ、サロゲートキー)
- Fastly Image Optimizer リファレンス:画像と派生版のパージ
- Google Cloud CDN:キャッシュ無効化の概要