CDN-foutpagina's configureren

Laatst bijgewerkt: 5 februari 2025

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 Cloud Manager config pijpleidingte gebruiken wordt opgesteld.

Instellen

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

  1. Maak een bestand met de naam cdn.yaml of een vergelijkbaar bestand en verwijs naar de onderstaande syntaxissectie.

  2. Plaats het dossier ergens onder een top niveauomslag genoemd config of gelijkaardig, zoals die in wordt beschreven Gebruikend Pijpleidingen Config.

  3. Creeer een configuratiepijpleiding in Cloud Manager, zoals die in wordt beschreven Gebruikend Pijpleidingen Config.

  4. Implementeer de configuratie.

Syntaxis

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

Zie Gebruikend Pijpleidingen Configvoor een beschrijving van de eigenschappen boven de gegevensknoop. De waarde van het typebezit zou CDN moeten zijn en het version bezit zou aan 1 moeten worden geplaatst.

NaamToegestane eigenschappenBetekenis
spatitelTitel voor de foutpagina.
icoUrlURL naar een pictogrambestand.
cssUrlURL naar een CSS-bestand.
jsUrlURL naar een JavaScript-bestand.

Monster van gegenereerde 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

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.

Zelfstudie

Verwijs naar de CDN foutenpagina'sleerprogramma voor geleidelijke instructies op om tot stand te brengen, op te stellen en te testen CDN diende foutenpagina's.