Documentation AEM as a Cloud Service Guide de l’utilisateur

Configuration des pages d’erreur CDN cdn-error-pages

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Dispatcher

Créé pour :

Administration

Dans le cas improbable où le CDN géré par l'Adobe ne peut pas atteindre l'origine de l'AEM, le CDN diffuse par défaut une page d'erreur générique sans marque qui indique que le serveur ne peut pas être atteint. Vous pouvez remplacer la page d’erreur par défaut en hébergeant des fichiers statiques dans un stockage auto-hébergé tel qu’Amazon S3 ou Azure Blob Storage, et en les référençant dans un fichier de configuration déployé à l’aide du pipeline de configuration Cloud Manager.

Configuration setup

Avant de pouvoir remplacer la page d’erreur par défaut, vous devez effectuer les opérations suivantes :

Créez un fichier nommé cdn.yaml ou similaire, en référençant la section de syntaxe ci-dessous.
Placez le fichier quelque part sous un dossier de niveau supérieur nommé config ou similaire, comme décrit dans l’ article du pipeline de configuration.
Créez un pipeline de configuration dans Cloud Manager, comme décrit dans l’ article sur le pipeline de configuration.
Déployez la configuration.

Syntaxe syntax

La page d’erreur est implémentée sous la forme d’une application d’une seule page (SPA) et référence quelques propriétés, comme illustré dans l’exemple ci-dessous. Les fichiers statiques référencés par les URL doivent être hébergés par vous sur un service accessible sur Internet tel qu’Amazon S3 ou Azure Blob Storage.

Exemple de configuration :

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

Pour obtenir une description des propriétés situées au-dessus du noeud de données, reportez-vous à l’ article sur le pipeline de configuration . La valeur de la propriété type doit être CDN et la propriété version doit être définie sur 1.

Nom

Propriétés autorisées

Signification

spa

title

Titre de la page d’erreur.

icoUrl

URL d’un fichier d’icône.

cssUrl

URL vers un fichier CSS.

jsUrl

URL d’un fichier JavaScript.

Exemple d’HTML généré sample-generated-html

Le code d’HTML généré par le réseau de diffusion de contenu et diffusé au client, tel qu’un navigateur, ressemblera (mais ne sera pas identique) au fragment de code suivant :

<!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>

Tests testing

À des fins de test, appelez le point de terminaison dédié avec le code d’erreur pris en charge, par exemple :

curl "https://publish-pXXXXX-eXXXXXX.adobeaemcloud.com/cdnstatus?code=403"

Les codes pris en charge sont : 403, 404, 406, 500 et 503.

Ainsi, vous déclenchez directement le gestionnaire d’erreurs du CDN afin de tester la réponse synthétique pour un code d’erreur donné.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab