DokumentationAEM as a Cloud ServiceAnvändarhandbok

Konfigurera CDN-felsidor cdn-error-pages

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

Skapat för:

  • Administratör

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 ett självvärdbaserat lagringsutrymme som Amazon S3 eller Azure Blob Storage och referera till dem i en konfigurationsfil som distribueras med Cloud Manager Configuration Pipeline.

Inställningar setup

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

  • Skapa den här mappen och filstrukturen i den översta mappen i Git-projektet:
config/
     cdn.yaml

  • Konfigurationsfilen cdn.yaml ska innehålla både metadata och reglerna som beskrivs i exemplen nedan. Parametern kind ska anges till CDN och versionen ska anges till schemaversionen, som för närvarande är 1.

  • Skapa en riktad distributionskonfigurationspipeline i Cloud Manager. Se konfigurera produktionspipelines och konfigurera icke-produktionspipelines.

Anteckningar

  • De lokala lagringsplatserna stöder för närvarande inte konfigurationsflödet.
  • Du kan använda yq för att lokalt validera YAML-formateringen av konfigurationsfilen (till exempel yq cdn.yaml).

Konfiguration configuration

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

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