エラーページとメンテナンスページのカスタマイズ

Fastly オリジンへのリクエストが失敗した場合、Fastly は、ユーザーにとって混乱を招く可能性のある、基本的な形式と一般的なメッセージングを含むデフォルトの応答ページを返します。 例えば、Fastly オリジンへのリクエストが 503 エラーが原因で失敗した場合、Fastly は次のデフォルトのエラーページを返します。

Fastly デフォルトエラーページ

次の例に示すように、Adobe Commerce ストアの設定を更新して、デフォルトの応答ページの一部を、より使いやすいメッセージ機能と改善されたHTMLスタイルを持つページに置き換えることができます。

Fastly カスタムエラーページ

現在、クラウドインフラストラクチャプロジェクト上のAdobe Commerceについて、次の Fastly 応答ページをカスタマイズできます。

HTMLのコーディング要件:

カスタムページのHTMLコードは、次の要件を満たす必要があります。

  • コンテンツには、最大 65,535 文字を含めることができます。
  • HTMLソース内のすべての CSS をインラインで指定します。
  • Fastly がオフラインでも表示されるように、base64 を使用してHTMLページに画像をバンドルします。 参照: css-tricks サイトのデータ URI.

503 エラーページのカスタマイズ

次の場合、デフォルトの 503 エラーページが表示されます。

  • Fastly オリジンへのリクエストが 500 より大きい応答ステータスを返す場合
  • タイムアウト、メンテナンスアクティビティ、正常性の問題など、Fastly オリジンがダウンしている場合

デフォルトページをカスタマイズするには、以下のHTMLコードを適応させて、Adobe Commerce Store のテーマに合わせたスタイル設定を行い、必要に応じてタイトルとメッセージングを変更します。

<!DOCTYPE html>
<html>
   <head>
      <meta charset="UTF-8">
         <title>503</title>
   </head>
   <body>
      <p>Service unavailable</p>
   </body></html>

変更したソースがブラウザーに正しく表示されていることを確認します。 次に、カスタマイズしたHTMLコードを Fastly 設定に追加します。

Fastly 設定にカスタム応答ページを追加するには:

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

  2. を選択 ストア > 設定 > 設定 > 詳細 > システム.

  3. 右側のパネルで、を展開します フルページキャッシュ > Fastly 設定 > カスタム合成ページ.

    503 エラーページの編集

  4. を選択 HTMLを設定.

  5. カスタムHTMLページのソースコードをコピーして、「レスポンス」フィールドに貼り付けます。

    503 エラーページを更新

  6. を選択 Upload ページの上部で、カスタマイズしたHTMLソースを Fastly サーバーにアップロードします。

  7. を選択 設定を保存 ページの上部で、更新した設定ファイルを保存します。

  8. キャッシュを更新します。

    • ページ上部の通知で、 キャッシュ管理 リンク。

    • キャッシュ管理ページで、 Magentoキャッシュのフラッシュ.

WAF エラーページのカスタマイズ

Fastly オリジンへのリクエストがで失敗した場合、お客様には次のデフォルトの WAF エラーページが表示されます。 403 Forbidden エラーの原因: WAF ブロッキングイベント。

WAF エラーページ

次のコードサンプルに、デフォルトページのHTMLソースを示します。

<html>
  <head>
    <title>Magento 403 Forbidden</title>
  </head>
  <body>
    <p>The requested URL was rejected.</p>
    <p>For additional information, please contact support and provide this reference ID:</p>
    <p>"} req.http.x-request-id {"</p>
    <p><button onclick='history.back();'>Go Back</button></p>
  </body>
</html>

を使用できます カスタム合成ページ > WAF ページの編集 fastly 設定メニューの「」オプションを使用して、クラウドインフラストラクチャプロジェクト上のAdobe Commerceのデフォルトコードをカスタマイズします。 コードを編集する際は、WAF ブロッキングイベントの参照 ID を提供する次の行を保持します。

<p>"} req.http.x-request-id {"</p>
NOTE
「WAF を編集」オプションを使用できるのは、Managed Cloud WAF サービスがクラウドインフラストラクチャプロジェクト上のAdobe Commerceで有効になっている場合のみです。

WAF エラーページを編集するには:

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

  2. を選択 ストア > 設定 > 設定 > 詳細 > システム.

  3. 右側のパネルで、を展開します フルページキャッシュ > Fastly 設定 > カスタム合成ページ.

    「WAF エラーページを編集」オプション

  4. を選択 WAF ページの編集.

  5. フィールドに入力して、HTMLを更新します。

    WAF エラーページを更新

    • ステータス – を選択します。 403 Forbidden ステータス。
    • MIME タイプ — タイプ text/html.
    • コンテンツ — デフォルトのHTML応答を編集してカスタム CSS を追加し、必要に応じてタイトルとメッセージを更新します。
  6. を選択 Upload ページの上部で、カスタマイズしたHTMLソースを Fastly サーバーにアップロードします。

  7. を選択 設定を保存 ページの上部で、更新した設定ファイルを保存します。

  8. キャッシュを更新します。

    • ページ上部の通知で、 キャッシュ管理 リンク。

    • キャッシュ管理ページで、 Magentoキャッシュのフラッシュ.

エラーレポート番号を表示

デフォルトでは、Fastly はAdobe Commerce エラーをすべて 503 サービスを利用できません エラー。 エラーログレポートの番号を表示して、ログでエラーの詳細を確認できるようにするには、次の手順に従って、Fastly を省略して web サイトを開きます。

  1. ストアの IP アドレスを取得します。

    • ステージング環境および実稼動環境の場合:

      code language-bash
      nslookup {your_project_id}.ent.magento.cloud
      
    • Pro 統合環境およびスターター環境の場合:

      code language-bash
      nslookup gw.{your_region}.magentosite.cloud
      
  2. ローカルワークステーションの hosts ファイルにアプリケーションドメインと IP アドレスを追加します。

    code language-text
    {server_IP} {store_domain}
    
  3. ブラウザーのキャッシュと Cookie をクリアします(または匿名モードに切り替えます)。

  4. ストアの web サイトを再度開いて、エラーコードを表示します。

  5. エラーコードを使用して、エラーレポートファイルの詳細を見つけます。

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26