Documentation AEM as a Cloud Service Guide de l’utilisateur

Configuration des pages d’erreur du réseau CDN

Dernière mise à jour : 6 février 2025

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

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

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é

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

À 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