ドキュメントExperience Cloud KCS

AEM as a Cloud ServiceでのFastly CDN キャッシュの無効化

最終更新日： 2026年7月13日

Fastlyは常にAEM as a Cloud Serviceのコンテンツ配信パスの一部であり、削除することはできません。 予期しないキャッシュは、Cache-ControlまたはSurrogate-Control個のヘッダーが見つからないか、オーバーライドされているか、リソース間で一貫性のない適用が行われている場合に発生します。 顧客管理のCDNを使用する環境では、誤った転送ヘッダーがキャッシュ動作やリダイレクト処理に影響を与える可能性があります。

この問題を解決するには、cache-control個のヘッダーを正しく設定し、CDN設定を検証し、Fastly パススルー動作を検証します。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service （AEMaaCS）
  • 独自のCDN （BYOCDN）デプロイメントを持ち込む
  • Dispatcher設定
  • cdn.yamlを使用したCDN設定

問題/症状

  • キャッシュのバイパスが予想される場合、Fastly x-cache ヘッダーにMISSまたはSYNTHが表示されます。
  • 設定されたキャッシュ制御ヘッダーにもかかわらず、特定のファイルタイプをFastlyがキャッシュします。
  • Surrogate-ControlまたはSurrogate-Key個のヘッダーがエッジに表示されません。
  • パーソナライズされたコンテンツでは、キャッシュされたフラグメントが再利用されるので、一貫性のない動作が表示されます。
  • リクエストが複数のCDN レイヤーを通過すると、予期しないリダイレクトが発生します。

原因

Fastlyは、Adobe Experience Manager as a Cloud Serviceの配信アーキテクチャに不可欠な要素であり、常にリクエストパスに存在します。 Cache-ControlまたはSurrogate-Control個のヘッダーが見つからないか、不完全であるか、オーバーライドされているか、リソースタイプ間で一貫性のない場合、Fastlyはコンテンツをキャッシュします。 .vtt filesなどの一部のアセットタイプでは、明示的なキャッシュ制御ルールが必要です。 BYOCDN デプロイメントでは、誤ったX-Forwarded-HostまたはX-Forwarded-Proto ヘッダーが異なるキャッシュキーを作成する可能性があり、予期しないキャッシュまたはリダイレクト動作が発生します。

解決策 resolution

問題を解決するには、次の手順に従います

  1. 応答ヘッダーを確認し、影響を受ける応答にCache-ControlとSurrogate-Controlが表示されていることを確認します。
  2. Surrogate-Controlに、Fastlyのキャッシュを防ぐmax-age=0やno-storeなどの値が含まれていることを確認します。
  3. Dispatcher仮想ホスト設定を更新して、Cache-ControlおよびSurrogate-Control個のヘッダーがHTML、JSON、アセット、その他のリソースタイプ全体で一貫して適用されるようにします。 必要なヘッダーを継承しないリソースタイプに対して、明示的なルールを追加します。
  4. 顧客が管理するCDNがFastlyのキャッシュコントロールディレクティブを上書きしないことを確認します。
  5. CDN ログを確認し、Fastlyがパススルーモードで動作する間、顧客管理のCDNがキャッシュを実行することを確認します。
  6. ヘッダーベースのコントロールが期待される動作に達しない場合は、cdn.yamlでキャッシュ バイパスを設定します。 更新された設定をCloud Managerでデプロイし、デプロイメントが正常に完了したことを確認します。
  7. 元のHost ヘッダーとX-Forwarded-Proto ヘッダーがCDN チェーン全体で正しく転送されていることを確認して、マルチ CDN ルーティングを検証します。
  8. フラグメントのキャッシュ実装を確認し、パーソナライズされたフラグメントがキャッシュされないようにします。
  9. 動的な応答で、キャッシュできない適切なヘッダーが返されることを確認します。
  10. パージ ワークフローがキーベースの無効化に依存している場合は、Surrogate-Key ヘッダーを設定します。
  11. Fastlyのデバッグを有効にし、応答ヘッダーにサロゲートキーが表示されることを確認します。
  12. FastlyがPASSを返し、顧客が管理するCDNが期待どおりにキャッシュし、キャッシュパージ操作が正しく動作することを確認して、最終的な設定を検証します。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles