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

Last update: Tue Oct 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Dispatcher

建立對象：

管理員

萬一Adobe管理的CDN無法連線至AEM來源，CDN預設會提供不記名的一般錯誤頁面，指出無法連線至伺服器。您可以在自行託管的儲存體(例如Amazon S3或Azure Blob儲存體)中託管靜態檔案，並在使用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。

名稱

允許的屬性

含義

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

教學課程

請參閱CDN錯誤頁面教學課程，以取得如何建立、部署和測試CDN提供的錯誤頁面的逐步指示。

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab