Konfigurieren von CDN-Fehlerseiten cdn-error-pages
Im unwahrscheinlichen Fall, dass das Adobe-verwaltete CDN den AEM-Ursprung nicht erreichen kann, gibt das CDN standardmäßig eine ungebrandete, generische Fehlerseite aus, die angibt, dass der Server nicht erreicht werden kann. Sie können die standardmäßige Fehlerseite außer Kraft setzen, indem Sie statische Dateien einer selbstgehosteten Datenspeicherung wie Amazon S3 oder Azure Blob Storage hosten und darauf in einer Konfigurationsdatei verweisen, die mithilfe der Cloud Manager-Konfigurations-Pipeline bereitgestellt wird.
Setup setup
Bevor Sie die standardmäßige Fehlerseite außer Kraft setzen können, müssen Sie wie folgt vorgehen:
-
Erstellen Sie eine Datei mit dem Namen
cdn.yamloder ähnlich, die auf den nachfolgenden Syntax-Abschnitt verweist. -
Platzieren Sie die Datei unter einem Ordner der obersten Ebene mit dem Namen config oder ähnlich, wie in Verwenden von Konfigurations-Pipelines beschrieben.
-
Erstellen Sie in Cloud Manager eine Konfigurations-Pipeline, wie in Verwenden von Konfigurations-Pipelines beschrieben.
-
Stellen Sie die Konfiguration bereit.
Syntax syntax
Die Fehlerseite wird als Einzelseitenanwendung (Single Page Application, SPA) implementiert und verweist auf eine Handvoll von Eigenschaften, wie im folgenden Beispiel gezeigt. Die statischen Dateien, auf die von den URLs verwiesen wird, sollten von Ihnen in einem über das Internet zugänglichen Dienst wie Amazon S3 oder Azure Blob Storage gehostet werden.
Konfigurationsbeispiel:
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
Eine Beschreibung der Eigenschaften oberhalb des Datenknotens finden Sie unter Verwenden von Konfigurations-Pipelines. Der Eigenschaftswert „kind“ sollte CDN sein, und die Eigenschaft version sollte auf 1 festgelegt werden.
Generierte Beispiel-HTML sample-generated-html
Der HTML-Code, der vom CDN generiert und dem Client bereitgestellt wird, z. B. einem Browser, ähnelt dem folgenden Snippet (ist aber nicht identisch mit diesem):
<!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>
Testen testing
Rufen Sie zu Testzwecken den dedizierten Endpunkt mit dem unterstützten Fehler-Code auf, z. B.:
curl "https://publish-pXXXXX-eXXXXXX.adobeaemcloud.com/cdnstatus?code=403"
Folgende Codes werden unterstützt: 403, 404, 406, 500 und 503.
Auf diese Weise können Sie den Fehler-Handler des CDN direkt auslösen, um die synthetische Antwort auf einen bestimmten Fehler-Code zu testen.
Tutorial
Eine schrittweise Anleitung zum Erstellen, Bereitstellen und Testen der vom CDN bereitgestellten Fehlerseiten finden Sie im Tutorial CDN-Fehlerseiten.