Konfigurera CDN-felsidor cdn-error-pages

Om det osannolika skulle inträffa att det Adobe-hanterade CDN inte kan nå AEM ursprung, visas som standard en allmän felsida utan varumärke som anger att servern inte kan nås. Du kan åsidosätta standardfelsidan genom att lagra statiska filer i värdbaserat lagringsutrymme som Amazon S3 eller Azure Blob Storage och referera till dem i en konfigurationsfil som distribueras med Cloud Manager config pipeline.

Inställningar setup

Innan du kan åsidosätta standardfelsidan måste du göra följande:

  1. Skapa en fil med namnet cdn.yaml eller liknande, och referera till syntaxavsnittet nedan.

  2. Placera filen någonstans under en mapp på den översta nivån med namnet config eller liknande, enligt beskrivningen i Använda konfigurationsförlopp.

  3. Skapa en konfigurationspipeline i Cloud Manager enligt beskrivningen i Använda konfigurationsförlopp.

  4. Distribuera konfigurationen.

Syntax syntax

Felsidan implementeras som ett program med en sida (SPA) och refererar till en handfull egenskaper, vilket visas i exemplet nedan. De statiska filer som URL-adresserna refererar till bör lagras hos dig på en Internettillgänglig tjänst som Amazon S3 eller Azure Blob Storage.

Konfigurationsexempel:

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

Se Använda konfigurationsförlopp för en beskrivning av egenskaperna ovanför datanoden. Egenskapsvärdet för sort ska vara CDN och egenskapen version ska vara 1.

Namn
Tillåtna egenskaper
Betydelse
spa
title
Felsidans titel.
icoUrl
URL till en ikonfil.
cssUrl
URL till en CSS-fil.
jsUrl
URL till en JavaScript-fil.

Sample Generated HTML sample-generated-html

Den HTML-kod som genereras av CDN och skickas till klienten, t.ex. en webbläsare, liknar (men är inte identisk med) följande kodutdrag:

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

Testning testing

I testsyfte anropar du den dedikerade slutpunkten med den felkod som stöds, till exempel:

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

Följande koder stöds: 403, 404, 406, 500 och 503.

På så sätt utlöser du CDN:ens felhanterare direkt för att testa det syntetiska svaret för en viss felkod.

Självstudiekurs

Se självstudiekursen CDN-felsidor för steg-instruktioner om hur du skapar, distribuerar och testar de CDN-hanterade felsidorna.

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