設定CDN錯誤頁面 cdn-error-pages

Last update: Wed May 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Dispatcher

萬一發生下列罕見情況 Adobe管理的CDN 無法連線至AEM來源，CDN預設會提供不具品牌的一般錯誤頁面，指出無法連線至伺服器。您可以將靜態檔案託管於自行託管的儲存體(例如Amazon S3或Azure Blob儲存體)中，並在使用部署的設定檔案中參照這些檔案，藉此覆寫預設錯誤頁面。 Cloud Manager設定管道.

設定 setup

您必須先執行下列操作，才能覆寫預設錯誤頁面：

在您的Git專案的頂層資料夾中建立此資料夾和檔案結構：

config/
     cdn.yaml

此 cdn.yaml 設定檔案應同時包含中繼資料和下列範例所述的規則。此 kind 引數應設為 CDN 而版本應設為結構描述版本，目前為 1.
在Cloud Manager中建立目標部署設定管道。另請參閱設定生產管道和設定非生產管道.

附註

RDE目前不支援設定管道。
您可以使用 yq 在本機驗證設定檔的 YAML 格式 (例如 yq cdn.yaml)。

設定 configuration

錯誤頁面會實作為單頁應用程式(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

名稱

允許的屬性

含義

spa

標題

錯誤頁面的標題。

icoUrl

圖示檔案的URL。

cssUrl

CSS檔案的URL。

jsUrl

JavaScript檔案的URL。

範例產生的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的錯誤處理常式，以測試指定錯誤碼的綜合回應。

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab