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

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

Last update: Thu May 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Admin
  • Developer

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

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

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

前提条件：

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 への VCL のアップロード が含まれる Fastly 設定 セクション。

  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 環境内のディレクトリ。 クリックすると、このディレクトリ内のスニペットが自動的にアップロードされます vcl の Fastly へのアップロード Commerce Admin. 参照： カスタム VCL スニペットの導入を自動化 Magento 2 用 Fastly CDN モジュールのドキュメントを参照してください。

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

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

  2. クリック ストア > 設定 > 設定 > 詳細 > システム.

  3. を展開 フルページキャッシュ > Fastly 設定 > カスタム VCL スニペット.

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

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

  5. ページの再読み込み後、 Fastly への VCL のアップロード が含まれる Fastly 設定 セクション。

  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