CDN 오류 페이지 구성

마지막 업데이트: 2025년 2월 6일

작성 대상:

  • 관리자

Adobe 관리 CDN이(가) AEM 원본에 도달할 수 없는 경우에는 기본적으로 CDN에 서버에 도달할 수 없음을 나타내는 브랜드가 없는 일반 오류 페이지가 표시됩니다. Amazon S3 또는 Azure Blob Storage와 같은 자체 호스팅 저장소에서 정적 파일을 호스팅하고 Cloud Manager 구성 파이프라인을 사용하여 배포된 구성 파일에서 참조하여 기본 오류 페이지를 재정의할 수 있습니다.

설정

기본 오류 페이지를 재정의하려면 먼저 다음을 수행해야 합니다.

  1. 아래 구문 섹션을 참조하여 이름이 cdn.yaml이거나 유사한 파일을 만드십시오.

  2. 구성 파이프라인 사용에 설명된 대로 파일을 config 또는 유사한 최상위 폴더 아래에 배치합니다.

  3. 구성 파이프라인 사용에 설명된 대로 Cloud Manager에서 구성 파이프라인을 만듭니다.

  4. 구성 배포.

구문

오류 페이지는 단일 페이지 애플리케이션(SPA)으로 구현되며 아래 예와 같이 몇 가지 속성을 참조합니다. URL에서 참조하는 정적 파일은 Amazon S3 또는 Azure Blob Storage와 같이 인터넷에 액세스할 수 있는 서비스에서 호스팅해야 합니다.

구성 예:

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

데이터 노드 위의 속성에 대한 설명은 구성 파이프라인 사용을 참조하십시오. 종류 속성 값은 CDN ​이어야 하며 version 속성은 1(으)로 설정해야 합니다.

이름허용된 속성의미
spa제목오류 페이지 제목
icoUrl아이콘 파일에 대한 URL.
cssUrlCSS 파일의 URL.
jsUrlJavaScript 파일에 대한 URL.

샘플 생성 HTML

CDN에서 생성되어 브라우저와 같이 클라이언트에 제공되는 HTML 코드는 다음 코드 조각과 비슷하지만 동일하지는 않습니다.

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

테스트

테스트 목적으로 지원되는 오류 코드와 함께 전용 엔드포인트를 호출하십시오. 예:

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

지원되는 코드는 403, 404, 406, 500 및 503입니다.

이러한 방식으로, 주어진 오류 코드에 대한 합성 응답을 테스트하기 위해 CDN의 오류 핸들러를 직접 트리거합니다.

튜토리얼

CDN 제공 오류 페이지를 만들고 배포하고 테스트하는 방법에 대한 단계별 지침은 CDN 오류 페이지 자습서를 참조하십시오.

Experience Manager