설명서AEM as a Cloud Service사용 안내서

Edge Delivery Services를 위한 경로 매핑 path-mapping

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 사용자

AEM 작성 인스턴스에서 사용되는 페이지 경로를 웹 사이트에서 사용되는 공개 페이지 경로에 매핑하고 Edge Delivery Services에 게시되는 콘텐츠를 제어하는 방법을 알아봅니다.

개요 overview

AEM을 사용하여 WYSIWYG 콘텐츠를 작성하고 Edge Delivery Services에 게시하려면 프로젝트의 경로 매핑을 설정해야 합니다. 이 매핑에는 두 가지 목적이 있습니다.

  • AEM 작성 인스턴스에 사용되는 페이지 경로와 웹 사이트에 사용되는 공개 페이지 경로 간의 관계를 매핑하고 생성합니다.
  • Edge Delivery Services에 게시되는 콘텐츠(페이지, 시트, 자산 등)를 제어합니다.

경로 매핑은 각 프로젝트에 대해 개별적으로, 프로젝트의 콘텐츠 및 URL 구조에 따라 구성되어야 합니다. 콘텐츠 게시 중 및 범용 편집기에서 콘텐츠를 편집할 때 AEM에서 사용합니다.

구성 형식 configuration-format

경로 매핑 구성의 형식에는 다음 예제와 유사한 두 개의 섹션(mappings 및 includes)이 포함되어 있습니다.

{
  "mappings": [
    "/content/aem-boilerplate/:/",
    "/content/aem-boilerplate/configuration:/.helix/config.json"
  ],
  "includes:" [
    "/content/aem-boilerplate/"
  ]
}

매핑 mappings

mappings 구성에는 (AEM 작성 인스턴스의) 내부 경로와 (공개 웹 사이트의) 외부 URL 경로의 배열이 포함되어 있습니다.

형식은 <internal paths>:<external path>입니다. 일반적으로 최소 두 개의 항목으로 구성됩니다.

  1. 예제의 첫 번째 항목은 웹 사이트 페이지의 경로 매핑입니다.
  2. 두 번째 항목은 AEM 작성 저장소의 해당 스프레드시트 페이지에 대한 .helix/config.json 매핑을 제어합니다.

이 예제에서는 /content/aem-boilerplate/...에 저장된 모든 페이지를 https://main--my-site--org.aem.live/....에 있는 Edge Delivery Services 사이트에서 직접 공개적으로 액세스할 수 있습니다.

TIP
스프레드시트로 관리되는 모든 표 형식의 데이터(예: 메타데이터, 리디렉션 및 분류)는 일반적으로 Edge Delivery Services에서 .json API URL로 게시됩니다. 이를 위해서는 표 형식 데이터가 매핑 구성에 개별적으로 나열되어야 합니다.
자세한 내용은 스프레드시트를 사용한 표 형식 데이터 관리 문서를 참조하십시오.

포함 includes

includes 구성은 실제로 Edge Delivery Services에 복제되는 콘텐츠 경로를 제어합니다. 모든 경로 배열을 포함할 수 있으며 일반적으로 사이트 최상위 루트 페이지를 포함합니다.

Edge Delivery Services 페이지에서 사용되는 자산은 일반적으로 웹 페이지와 함께 게시됩니다. AEM 작성 인스턴스에서 Edge Delivery Services로 자동으로 내보냅니다.

TIP
Edge Delivery Services에 직접 자산을 게시하려는 사용 사례가 있는 경우(예: 페이지 컨텍스트 외부의 URL에서 이미지 또는 PDF에 직접 액세스하는 것을 원하는 경우), 구성의 includes 섹션에도 DAM 경로를 추가해야 합니다.
예를 들어 PDF 세트가 포함된 /content/dam/my-site/documents와 같은 자산 루트 폴더를 /assets/...를 통해 공개적으로 액세스 가능하도록 설정하려면, 구성의 includes 섹션에 항목을 추가해야 합니다.

구성하는 방법 how-to-configure

경로 매핑은 프로젝트 설정에 따라 두 가지 방법 중 하나로 구성할 수 있습니다.

  1. 프로젝트가 aem.live에 맞게 구성되어 있고 중앙 집중식 구성에 대해 구성 서비스를 사용하는 경우 각 사이트의 경로 매핑은 이 구성 서비스를 통해 구성됩니다.

    • 경로 매핑을 구성하기 위한 cURL 요청의 예는 다음과 같습니다.
    code language-text 
    curl --request POST \
  --url https://admin.aem.page/config/{org}/sites/{site}/public.json \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: ......' \
  --data '{
    "paths": {
    "mappings": [
      "/content/aem-boilerplate/:/",
      "/content/aem-boilerplate/configuration:/.helix/config.json"
    ],
    "includes": [
      "/content/aem-boilerplate/"
    ]
}
}'

  2. 프로젝트에서 구성 서비스를 사용하지 않는 경우, 경로 매핑은 프로젝트 GitHub 저장소의 paths.json 파일을 통해 구성됩니다.

두 경우 모두 경로 매핑을 구성한 후 공개적으로 액세스할 수 있는 구성 URL https://<branch>--<site>--<org>.aem.page/config.json을 통해 구성을 확인할 수 있습니다.

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