CDN エラーページの設定 cdn-error-pages
万が一、アドビが管理する CDN が AEM の接触チャネルに到達できない場合、CDN はデフォルトで、サーバーに到達できないことを示す、ブランド化されていない汎用のエラーページを表示します。Amazon S3 や Azure Blob Storage などの自己ホスト型ストレージで静的ファイルをホストし、Cloud Manager 設定パイプラインを使用してデプロイされた設定ファイルで静的ファイルを参照することで、デフォルトのエラーページを上書きできます。
設定 setup
デフォルトのエラーページを上書きする前に、次の作業を行う必要があります。
-
以下の構文の節を参照して、
cdn.yamlまたは類似の名前のファイルを作成します。 -
設定パイプラインの使用で説明されているように、config または類似の名前の最上位フォルダーの下のどこかにファイルを配置します。
-
設定パイプラインの使用の説明に従って、Cloud Manager で設定パイプラインを作成します。
-
設定をデプロイします。
構文 syntax
エラー ページはシングルページ アプリケーション（SPA）として実装され、以下の例に示すように、いくつかのプロパティを参照します。URL によって参照される静的ファイルは、Amazon S3 や Azure Blob Storage などのインターネットにアクセスできるサービス上でホストする必要があります。
設定例：
kind: "CDN"
version: "1"
metadata:
envTypes: ["dev"]
data:
errorPages:
spa:
title: the error page
icoUrl: https://www.example.com/error.ico
cssUrl: https://www.example.com/error.css
jsUrl: https://www.example.com/error.js
データノード上のプロパティの説明について詳しくは、設定パイプラインの使用を参照してください。kind プロパティの値は CDN に設定し、version プロパティは 1 に設定する必要があります。
サンプル生成 HTML sample-generated-html
CDN によって生成され、ブラウザーなどのクライアントに提供される HTML コードは、次のスニペットに似ています（ただし、同一ではありません）。
<!DOCTYPE html>
<html lang="en">
<head>
...
<title>the error page</title>
<link rel="icon" href="https://www.example.com/error.ico">
<link rel="stylesheet" href="https://www.example.com/error.css">
</head>
<body>
...
<div id="root" status="403"></div>
<script src="https://www.example.com/error.js"> </script>
</body>
</html>
テスト testing
テストの目的で、サポートされているエラーコードを使用して専用のエンドポイントを呼び出します。次に例を示します。
curl "https://publish-pXXXXX-eXXXXXX.adobeaemcloud.com/cdnstatus?code=403"
サポートされているコードは、403、404、406、500 および 503 です。
この方法で、CDN のエラーハンドラーを直接トリガーして、特定のエラーコードに対する合成応答をテストします。
チュートリアル
CDN で提供されるエラーページの作成、デプロイ、テストの手順については、CDN エラーページチュートリアルを参照してください。