Documentación AEM as a Cloud Service Guía del usuario

Configuración de páginas de error de CDN cdn-error-pages

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Dispatcher

Creado para:

Administrador

En el improbable caso de que CDN administrado por el Adobe AEM no pueda alcanzar el origen de la, la CDN proporciona de forma predeterminada una página de error genérica sin marca que indica que no se puede llegar al servidor. Puede anular la página de error predeterminada alojando archivos estáticos en un almacenamiento autoalojado como Amazon S3 o Azure Blob Storage y haciendo referencia a ellos en un archivo de configuración que se implementa mediante la canalización de configuración de Cloud Manager.

Configuración setup

Para poder anular la página de error predeterminada, debe hacer lo siguiente:

Cree esta carpeta y estructura de archivos en la carpeta de nivel superior del proyecto Git:

config/
     cdn.yaml

El archivo de configuración cdn.yaml debe contener metadatos y las reglas descritas en los ejemplos siguientes. El parámetro kind debe establecerse en CDN y la versión debe establecerse en la versión de esquema, que actualmente es 1.
Cree una canalización de configuración de implementación de destino en Cloud Manager. Consulte configuración de canalizaciones de producción y configuración de canalizaciones que no son de producción.

Notas

Actualmente, los RDE no admiten la canalización de configuración.
Puede utilizar yq para validar localmente el formato YAML del archivo de configuración (por ejemplo, yq cdn.yaml).

Configuración configuration

SPA La página de error se implementa como una aplicación de una sola página () y hace referencia a un puñado de propiedades, como se muestra en el ejemplo siguiente. Los archivos estáticos a los que hacen referencia las direcciones URL deben alojarse en un servicio accesible por Internet como Amazon S3 o Azure Blob Storage.

Ejemplo de configuración:

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

Nombre

Propiedades permitidas

Significado

spa

Título

Título de la página de error.

icoUrl

URL de un archivo de icono.

cssUrl

URL de un archivo CSS.

jsUrl

URL de un archivo JavaScript.

Ejemplo de HTML generado sample-generated-html

El código de HTML generado por la CDN y entregado al cliente, como un explorador, se parecerá (pero no es idéntico) al siguiente fragmento:

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

Pruebas testing

Para realizar pruebas, llame al punto final dedicado con el código de error admitido, por ejemplo:

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

Los códigos admitidos son: 403, 404, 406, 500 y 503.

De este modo, se almacena directamente en déclencheur el controlador de error de CDN para probar la respuesta sintética de un código de error determinado.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab