画像キャッシュとは?
画像キャッシュは、取得または生成した画像レスポンスを保存し、後続のリクエストで再利用する仕組みです。通常はブラウザーや、閲覧者に近い CDN エッジに保存します。エントリーが追い出しや無効化の対象にならず、鮮度ポリシーでも再利用が許可されている間は、同じリクエストが繰り返されても、オリジンからの転送や変換処理を省けます。
画像キャッシュの仕組み
画像は、ブラウザー、アプリケーション、変換サービス、CDN、または複数の階層で同時にキャッシュできます。再利用する対象は元のファイルの場合もあれば、寸法、クロップ、ピクセル密度、品質、ネゴシエーションで決まる形式に応じて選ばれた派生画像の場合もあります。キーと鮮度ポリシーを明確に定義すると、同一の変換リクエストで同じ結果を共有できます。また、再検証や無効化によって、元のアセットの変更をその結果に反映できます。
要点
- キャッシュキーには何を含めるべきでしょうか?レスポンスを変えるリクエスト値はすべて含め、変えない値は含めません。変換エンドポイントでは、少なくとも出力バイト列を変えるすべての入力が対象です。クロップモード、焦点、向き、品質を省くと、有効ではあっても意図と異なる派生画像が返るおそれがあります。一方、レスポンスに影響しない値を含めると、重複が保存され、ヒット率が低下します。CDN ごとにデフォルトが異なるため、パラメーターがどこで渡されるかを確認してください。Amazon CloudFront のデフォルトのキャッシュキーは、ディストリビューションのドメイン名と URL パスです。そのため、キャッシュポリシーでクエリ文字列を追加するまでは、
?w=300と?w=600が同じキャッシュオブジェクトを共有します。Cloudflare のデフォルトキーにはクエリ文字列全体が含まれます。Google Cloud CDN のバックエンドバケットでは、デフォルトで Cloud Storage が認識するクエリパラメーターのみが含まれ、それ以外は包含リストで追加します。 Acceptによる形式ネゴシエーションでは、すべてのキャッシュがその値に応じてエントリーを分ける必要があります。同じ URL がリクエストのAcceptヘッダーに応じて AVIF、WebP、JPEG を返す場合は、Vary: Acceptを送信し、経路上の各キャッシュにレスポンスがそのヘッダーに依存することを伝えてください。さらに、CDN がVaryの処理または明示的な形式キーによって、実際に形式を分けて保持していることを確認してください。そうしないと、別のクライアント向けに選ばれたエンコード形式をキャッシュが返すおそれがあります。CDN 側のキーだけでは、CDN より下流のキャッシュには何も伝わりません。対応状況は一様ではありません。Cloudflare は、デフォルトではAccept-Encodingを除き、Varyを考慮せず、別途 Vary for Images 設定を提供しています。Google Cloud CDN はVary: Acceptに従い、Acceptの異なる値ごとに個別のエントリーを保持します。ただし、Acceptは値の種類が多いため、キャッシュキーヘッダーとして設定できません。形式を URL に含めれば、この依存関係を避けられます。その場合、たとえばpicture要素で、それぞれがtypeを宣言するソースの中から、ブラウザーが選択できます。- 同じパスの元画像を置き換えても派生画像の URL は変わらないため、派生画像を保持する各キャッシュは、エントリーがパージされるか、有効期限が切れて再検証されるまで、その画像を配信し続けることがあります。
stale-while-revalidateなどの古いコンテンツを配信するポリシーがあると、その期間はさらに延びます。元画像のパージで派生画像も削除されるかどうかは、プロバイダーによって異なります。Fastly Image Optimizer は、一度のリクエストで元画像とすべての派生画像をパージします。Cloudflare の画像変換では、元画像の URL をパージするとその画像の最適化版がパージされ、個別にはパージされません。派生画像がこのような関連付けなしに独立した URL としてキャッシュされる場合は、プロバイダーが対応するタグ、プレフィックス、または明示的な URL によるパージを使用してください。CDN のパージはブラウザーキャッシュには届きません。派生画像に新しい URL を使えば、ブラウザーを含むすべてのキャッシュを回避できます。元画像のバージョンまたはコンテンツハッシュをパスかキャッシュキーに含まれるクエリパラメーターに入れ、ページから新しい URL を参照するようにしてください。Cloudflare のように変換レイヤーが元画像もキャッシュする場合は、元画像もパージするかバージョンを付けてください。そうしないと、新しい派生画像が古い画像から生成されるおそれがあります。 - キャッシュされた派生画像は、保存済みファイルとは異なります。ブラウザーキャッシュが再度配信できるのは同じユーザーに対してだけです。そのため、出力のコピーを保持しない変換サービスは、他の閲覧者向けの処理を省くために、手前にある共有キャッシュ(通常は CDN)に依存します。CDN は、他のコンテンツ用の空きを確保するため、有効期限前にエントリーを追い出すことがあります。また、各エッジ拠点が独自のキャッシュを構築するため、オリジンまたは変換サービスは、どの派生画像でもいつでも再生成できる必要があり、元画像も利用可能な状態に保つ必要があります。どのキャッシュ階層も応答できないリクエストでは、取得と変換のコストが再び発生します。派生画像はそれぞれ別のエントリーです。たとえば Cloudflare は、元画像とパラメーターの一意の組み合わせごとに個別にキャッシュします。CDN に上位階層がある場合は、その階層でこの負担を軽減できます。Fastly Image Optimizer は、エッジに加えてシールドにも変換済み画像をキャッシュします。
画像キャッシュが重要になる場面
変換済みのバリアントをキャッシュすると、同じ寸法や形式へのリクエストが繰り返された際の遅延、処理負荷、帯域幅の使用量を削減できます。変換の入力条件をキーに含めてください。含めないと、別のリクエスト向けのバリアントが配信される場合があります。
画像キャッシュでの Transloadit の活用
Transloadit の Smart CDN は、このキャッシュ機能を組み込んだ画像変換レイヤーです。tlcdn.com の URL には、Workspace、Template、ソースファイルのパス、変換パラメーターを指定します。キャッシュミス時には Template の Assembly が実行され、結果がキャッシュされます。キャッシュヒット時には、再実行せずにエッジから応答します。パラメーターの選択が異なれば URL も異なるため、変換結果はそれぞれ別にキャッシュされます。Robot の /file/serve で、ブラウザーと CDN が結果を保持する期間を設定します。
Smart CDN は、ストレージではなく変換・配信レイヤーとして説明されています。元のファイルは自身のストレージに保持してください。リンク先のページには、パージ操作や、パスを変更せずに元のファイルを置き換えた際のキャッシュ済み結果の扱いは記載されていません。この動作を前提にする前に、自身の Workspace で検証してください。
出典
- RFC 9111、セクション 4.1:Vary ヘッダーフィールドを用いたキャッシュキーの算出
- MDN:Vary ヘッダーリファレンス
- Amazon CloudFront:キャッシュキーの理解
- Cloudflare:キャッシュキー(デフォルトキーとカスタムキー)
- Cloudflare:最適化したコンテンツの配信(Vary for Images)
- Google Cloud CDN:キャッシュの概要(キャッシュキー、Vary ヘッダー、古いコンテンツ、追い出し)
- Fastly Image Optimizer リファレンス:シールドキャッシュと画像およびそのバリアントのパージ
- Cloudflare Images:最適化済み画像のキャッシュとパージ
- MDN:HTTP キャッシュ(画像などのサブリソースのキャッシュバスティング)
- MDN:picture 要素(配下の source 要素の type 属性)