DocumentatieAEM as a Cloud ServiceHandboek

CDN-foutpagina's configureren cdn-error-pages

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

Gemaakt voor:

  • Beheerder

In de onwaarschijnlijke gebeurtenis dat Adobe-geleide CDNniet de AEM oorsprong kan bereiken, dient CDN door gebrek 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 de Opslag van Amazon S3 of van Azure Blob te ontvangen, en hen van verwijzingen te voorzien in een configuratiedossier dat door de Pijpleiding van de Configuratie van Cloud Manager te gebruikenwordt opgesteld.

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

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

  • Creeer een gerichte plaatsing config pijpleiding in Cloud Manager. Zie vormend productiepijpleidingenen vormend niet-productiepijpleidingen.

Nota's

  • RDEs steunt momenteel niet de configuratiepijplijn.
  • Met yq kunt u de YAML-opmaak van uw configuratiebestand lokaal 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