CDN キャッシュを有効にする方法
AEM as a Cloud Service の CDN で HTTP 応答のキャッシュを有効にする方法を説明します。応答のキャッシュは、Cache-Control、Surrogate-Control、または Expires HTTP 応答キャッシュヘッダーによって制御されます。
これらのキャッシュヘッダーは、通常、mod_headers を使用して、AEM Dispatcher のホスト設定で行われますが、AEM パブリッシュ自体で実行されるカスタム Java™ コードで設定することもできます。
新しいデフォルトのキャッシュ動作
カスタム設定が存在しない場合は、デフォルト値が使用されます。次のスクリーンショットに、AEM Publish とオーサーのデフォルトのキャッシュ動作を示します。AEM Project Archetype ベース mynewsite AEM プロジェクトがデプロイされます。
詳しくは、AEM パブリッシュ - デフォルトのキャッシュ有効期間および AEM オーサー - デフォルトのキャッシュ有効期間 を確認してください。
つまり、AEMas a Cloud Service は、ほとんどのコンテンツタイプ（HTML、JSON、JS、CSS およびアセット）を AEM パブリッシュに、および一部のコンテンツタイプ（JS、CSS）を AEM オーサーにキャッシュします。
キャッシュを有効にする
デフォルトのキャッシュ動作を変更するには、2 つの方法でキャッシュヘッダーを更新します。
- Dispatcher vhost の設定： AEM パブリッシュでのみ使用できます。
- カスタム Java™コード： AEM パブリッシュとオーサーの両方で使用できます。
これらの各オプションを確認してみましょう。
Dispatcher フィルター設定
キャッシュを有効にする場合は、このオプションを使用することをお勧めしますが、このオプションは AEM パブリッシュでのみ使用できます。キャッシュヘッダーを更新するには、mod_headers モジュールと <LocationMatch> Apache HTTP Server の vhost ファイル内のディレクティブを使用します。一般的な構文は次のとおりです。
<LocationMatch "$URL$ || $URL_REGEX$">
# Removes the response header of this name, if it exists. If there are multiple headers of the same name, all will be removed.
Header unset Cache-Control
Header unset Surrogate-Control
Header unset Expires
# Instructs the web browser and CDN to cache the response for 'max-age' value (XXX) seconds. The 'stale-while-revalidate' and 'stale-if-error' attributes controls the stale state treatment at CDN layer.
Header set Cache-Control "max-age=XXX,stale-while-revalidate=XXX,stale-if-error=XXX"
# Instructs the CDN to cache the response for 'max-age' value (XXX) seconds. The 'stale-while-revalidate' and 'stale-if-error' attributes controls the stale state treatment at CDN layer.
Header set Surrogate-Control "max-age=XXX,stale-while-revalidate=XXX,stale-if-error=XXX"
# Instructs the web browser and CDN to cache the response until the specified date and time.
Header set Expires "Sun, 31 Dec 2023 23:59:59 GMT"
</LocationMatch>
次に、それぞれの ヘッダー の目的とヘッダーに適用可能な 属性 をまとめます。
| Web ブラウザー | CDN | 説明 | |
|---|---|---|---|
| Cache-Control | ✔ | ✔ | このヘッダーは、web ブラウザーと CDN キャッシュの有効期間を制御します。 |
| Surrogate-Control | ✘ | ✔ | このヘッダーは、CDN キャッシュの有効期間を制御します。 |
| 有効期限 | ✔ | ✔ | このヘッダーは、web ブラウザーと CDN キャッシュの有効期間を制御します。 |
- max-age：この属性は、応答コンテンツの TTL（「有効期間」）を秒単位で制御します。
- stale-while-revalidate：この属性は、受信したリクエストが秒単位で指定された期間内にある場合に、CDN レイヤーでの応答コンテンツの 古い状態 の処理を制御します。古い状態 とは、TTL が切れてから、応答が再検証されるまでの期間です。
- stale-if-error：この属性は、オリジンサーバーが利用できず、受信したリクエストが指定された期間内に秒単位で送信された場合に、CDN レイヤーにおける応答コンテンツの 古い状態 の処理を制御します。
詳しくは、失効と再検証についての情報を参照してください。