DocumentatieAEM as a Cloud ServiceHandboek

CDN-foutpagina's configureren cdn-error-pages

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

In het onwaarschijnlijke geval dat CDN met beheerde Adobe kan niet de AEM oorsprong bereiken, CDN door gebrek dient een unbranded, generische foutenpagina die erop wijst dat de server niet kan worden bereikt. U kunt de standaardfoutenpagina met voeten treden door statische dossiers in zelf-ontvangen opslag zoals Amazon S3 of Azure Blob Storage te ontvangen, en van verwijzingen te voorzien in een configuratiedossier dat door het gebruiken van wordt opgesteld Cloud Manager Configuration Pipeline.

Instellen setup

Voordat u de standaardfoutpagina kunt overschrijven, moet u het volgende doen:

  • Maak deze map en bestandsstructuur in de map op hoofdniveau van uw Git-project:
config/
     cdn.yaml

  • De cdn.yaml Het configuratiebestand moet zowel metagegevens als de regels bevatten die in de onderstaande voorbeelden worden beschreven. De kind parameter moet worden ingesteld op CDN en de versie moet worden ingesteld op de schemaversie die momenteel is 1.

  • Maak een gerichte configuratiepijplijn voor implementatie in Cloud Manager. Zie productiepijpleidingen configureren en configureren van niet-productiepijpleidingen.

Notities

  • RDEs steunt momenteel niet de configuratiepijplijn.
  • U kunt yq om de opmaak van uw configuratiebestand lokaal te valideren (bijvoorbeeld yq cdn.yaml).

Configuratie configuration

De foutpagina wordt geïmplementeerd als een toepassing van één pagina (SPA) en verwijst naar een handvol eigenschappen, zoals in het onderstaande voorbeeld wordt getoond. De statische bestanden waarnaar wordt verwezen door de URL's, moeten door u worden gehost op een service die toegankelijk is voor internet, zoals Amazon S3 of Azure Blob Storage.

Voorbeeld van configuratie:

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
Naam
Toegestane eigenschappen
Betekenis
spa
titel
Titel voor de foutpagina.
icoUrl
URL naar een pictogrambestand.
cssUrl
URL naar een CSS-bestand.
jsUrl
URL naar een JavaScript-bestand.

Monster van gegenereerde HTML sample-generated-html

De code van HTML die door CDN wordt geproduceerd en aan de cliënt zoals browser wordt gediend zal (maar niet identiek aan) het volgende fragment lijken:

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

Testen testing

Voor testdoeleinden, roep het specifieke eindpunt met de gesteunde foutencode, bijvoorbeeld:

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

De volgende codes worden ondersteund: 403, 404, 406, 500 en 503.

Op deze manier activeert u rechtstreeks de fouthandler van de CDN om de synthetische reactie op een bepaalde foutcode te testen.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab