DocumentationAEM as a Cloud ServiceGuide de l’utilisateur

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

Last update: Wed May 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Dans le cas improbable où la variable Réseau de diffusion de contenu géré par Adobe ne peut pas atteindre l’origine de l’AEM, le réseau de diffusion de contenu 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 de la variable Pipeline de configuration de Cloud Manager.

Configuration setup

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

  • Créez ce dossier et cette structure de fichiers dans le dossier de niveau supérieur de votre projet Git :
config/
     cdn.yaml

  • La variable cdn.yaml Le fichier de configuration doit contenir à la fois des métadonnées et les règles décrites dans les exemples ci-dessous. La variable kind doit être défini sur CDN et la version doit être définie sur la version du schéma, qui est actuellement 1.

  • Créez un pipeline de configuration de déploiement ciblé dans Cloud Manager. Voir configuration des pipelines de production et configuration des pipelines hors production.

Remarques

  • Les RDE ne prennent actuellement pas en charge le pipeline de configuration.
  • Vous pouvez utiliser yq pour valider localement le format YAML de votre fichier de configuration (par exemple, yq cdn.yaml).

Configuration configuration

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
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 de HTML généré sample-generated-html

Le code de 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