ドキュメントCommerceクラウドインフラストラクチャー上の Commerce に関するガイド

Fastly キャッシュをバイパスするカスタム VCL

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • 開発者

カスタム VCL スニペットを作成して、Fastly キャッシュをバイパスし、オリジンサーバーへのリクエストトラフィックのトラブルシューティングを行うことができます。 例えば、スニペットを作成して、サイトの問題がキャッシュに起因するものかどうかを判断したり、ヘッダーのトラブルシューティングを行ったりできます。

特定の IP アドレスまたは URL からのリクエストに対して Fastly のキャッシュをバイパスするように、スニペットを設定できます。

NOTE
カスタム VCL 設定を実稼動環境に結合する前に、必ずステージング環境でコードをテストしてください。

前提条件：

  • Fastly CDN を使用するように環境を設定する必要があります。 詳しくは、Fastly サービスの設定を参照してください。

  • Magento 2 の Fastly CDN モジュールが最新バージョンであることを確認してください。 Fastly モジュールのアップグレードを参照してください。

  • Fastly サービスの環境設定を確認します。 Fastly キャッシュの確認を参照してください。

  • ステージング環境と実稼動環境にアクセスするには、管理者資格情報が必要です。

IP アドレスまたは URL に基づいて Fastly キャッシュをバイパスするには:

  1. 管理者に ログインします。

  2. ストア/設定/設定/詳細/システム をクリックします。

  3. フルページキャッシュ/Fastly 設定/カスタム VCL スニペット の順に展開します。

  4. カスタムスニペットを作成 をクリックします。

  5. VCL スニペットの値を追加します。

    • 名前 — bypass_fastly

    • 種類 — recv

    • 優先度 — 5

    • VCL スニペットコンテンツ —

      次の例では、特定の IP アドレスの Fastly をバイパスしています。

      code language-conf 
      if (client.ip == "<Your IPv4 IP address>" || client.ip == "<Your IPv6 IP address>") {
  return(pass);
}

      次の例では、特定の URL パターンに対して Fastly をバイパスしています。

      code language-conf 
      if (req.url ~ "/media/feeds/GoogleShoppingHiVisNew.xml") {  return (pass);}

      URL が完全に一致する場合は、~ 演算子の代わりに == 演算子を使用します。 詳しくは、[Fastly VCL リファレンス ] を参照してください。

  6. 作成 をクリックします。

    Fastly バイパス VCL スニペットの作成

  7. ページのリロード後、「Fastly 設定 セクションの ​Fastly に VCL をアップロード をクリックします。

  8. アップロードが完了したら、ページ上部の通知に従ってキャッシュを更新します。

    Fastly は、アップロード処理中に更新された VCL バージョンを検証します。 検証に失敗した場合は、カスタム VCL スニペットを編集して問題を修正します。 次に、VCL を再度アップロードします。

VCL スニペットを追加した後、cURL コマンドを使用して、次の例に示すように、指定した IP アドレスまたは URL からオリジンサーバーにリクエストを送信できます。

curl -svo /dev/null www.example.com/index.html

次に、応答を調べて、キャッシュされていないコンテンツに関する問題のトラブルシューティングを行います。

NOTE
カスタム VCL スニペットを手動でアップロードする代わりに、環境内の $MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom ディレクトリにスニペットを追加できます。 Commerce Admin で VCL を Fastly にアップロード をクリックすると、このディレクトリ内のスニペットが自動的にアップロードされます。 Magento 2 ドキュメントの Fastly CDN モジュールの 自動カスタム VCL スニペットのデプロイメントを参照してください。

カスタム VCL スニペットの変更

  1. 管理者に ログインします。

  2. ストア/設定/設定/詳細/システム をクリックします。

  3. フルページキャッシュ/Fastly 設定/カスタム VCL スニペット の順に展開します。

    カスタム VCL スニペットの管理

  4. アクション 列で、編集するスニペットの横にある設定アイコンをクリックします。

  5. ページのリロード後、「Fastly 設定 _セクションの ​Fastly に VCL をアップロード_ をクリックします。

  6. アップロードが完了したら、ページ上部の通知に従ってキャッシュを更新します。

WARNING
「カスタム VCL スニペット UI オプションには、Adobe Commerce管理を通じて追加されたスニペットのみが表示されます。 Fastly API を使用してスニペットを追加する場合は、API を使用して スニペットを管理します。

カスタム VCL スニペットの削除

  1. 管理者に ログインします。

  2. ストア/設定/設定/詳細/システム をクリックします。

  3. フルページキャッシュ/Fastly 設定/カスタム VCL スニペット の順に展開します。

    カスタム VCL スニペットの管理

  4. アクション 列で、削除するスニペットの横にあるごみ箱アイコンをクリックします。

  5. 次のモーダルウィンドウで、「DELETE」をクリックし 新しいバージョンをアクティベートします。

WARNING
「カスタム VCL スニペット UI オプションには、Adobe Commerce管理を通じて追加されたスニペットのみが表示されます。 Fastly API を使用してスニペットを追加する場合は、API を使用して スニペットを管理します。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26