Documentation AEM as a Cloud Service Guide de l’utilisateur

Configuration des pages d’erreur du réseau CDN cdn-error-pages

Last update: Thu Feb 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Dispatcher

Créé pour :

Administration

Dans le cas peu probable où le réseau CDN géré par l’Adobe 🔗 ne pourrait pas atteindre l’origine AEM, le réseau 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 Cloud Manager config.

Configuration setup

Avant de pouvoir remplacer la page d’erreur par défaut, procédez comme suit :

Créez un fichier nommé cdn.yaml ou similaire, en vous référant à 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 la section Utilisation des pipelines de configuration.
Créez un pipeline de configuration dans Cloud Manager, comme décrit dans la section Utilisation de pipelines de configuration.
Déployez la configuration.

Syntaxe syntax

La page d’erreur est implémentée en tant qu’application sur une seule page (SPA) et fait 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 par 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

Voir Utilisation des pipelines de configuration pour une description des propriétés au-dessus du nœud de données. La valeur de la propriété kind 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 vers un fichier icône.

cssUrl

URL vers un fichier CSS.

jsUrl

URL vers un fichier JavaScript.

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

Le code d’HTML généré par le réseau CDN et diffusé au client, tel qu’un navigateur, ressemble (mais n’est 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 d’entrée 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 réseau CDN afin de tester la réponse synthétique pour un code d’erreur donné.

Tutoriel

Reportez-vous au tutoriel Pages d’erreur du réseau CDN pour obtenir des instructions détaillées sur la création, le déploiement et le test des pages d’erreur du réseau CDN.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab