Documentazione AEM as a Cloud Service Guida utente

Configurazione delle pagine di errore CDN cdn-error-pages

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

Argomenti:
Dispatcher

Creato per:

Amministratore

Nel caso improbabile che la rete CDN gestita dall'Adobe non raggiunga l'origine dell'AEM, per impostazione predefinita la rete CDN fornisce una pagina di errore generica senza marchio che indica che il server non può essere raggiunto. È possibile ignorare la pagina di errore predefinita ospitando file statici nell'archiviazione self-hosted, ad esempio Amazon S3 o Azure Blob Storage, e facendo riferimento a tali file in un file di configurazione distribuito utilizzando la pipeline di configurazione di Cloud Manager.

Configurazione setup

Prima di poter sovrascrivere la pagina di errore predefinita, è necessario effettuare le seguenti operazioni:

Crea questa cartella e struttura di file nella cartella di livello principale del progetto Git:

config/
     cdn.yaml

Il file di configurazione cdn.yaml deve contenere sia i metadati che le regole descritte negli esempi seguenti. Il parametro kind deve essere impostato su CDN e la versione deve essere impostata sulla versione dello schema, attualmente 1.
Crea una pipeline di configurazione della distribuzione di destinazione in Cloud Manager. Consulta configurazione delle pipeline di produzione e configurazione delle pipeline non di produzione.

Note

Al momento gli RDE non supportano la pipeline di configurazione.
Puoi utilizzare yq per convalidare localmente la formattazione YAML del file di configurazione (ad es. yq cdn.yaml).

Configurazione configuration

La pagina di errore viene implementata come applicazione a pagina singola (SPA) e fa riferimento a una serie di proprietà, come illustrato nell’esempio seguente. I file statici a cui fanno riferimento gli URL devono essere ospitati da te su un servizio accessibile a Internet come Amazon S3 o Azure Blob Storage.

Esempio di configurazione:

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

Nome

Proprietà consentite

Significato

spa

titolo

Titolo della pagina di errore.

icoUrl

URL a un file di icona.

cssUrl

URL a un file CSS.

jsUrl

URL a un file JavaScript.

Esempio di HTML generato sample-generated-html

Il codice HTML generato dalla rete CDN e distribuito al client, ad esempio un browser, assomiglierà (ma non sarà identico) al seguente snippet:

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

Test testing

A scopo di test, chiama l’endpoint dedicato con il codice di errore supportato, ad esempio:

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

I codici supportati sono: 403, 404, 406, 500 e 503.

In questo modo, attivi direttamente il gestore degli errori della rete CDN per testare la risposta sintetica per un determinato codice di errore.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab