설명서

AEMaaCS로 마이그레이션한 후 온-프레미스 슬링 매핑이 실패함

Last update: Mon Aug 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

On-Premise AEM 설정에서 Adobe Experience Manager as a Cloud Service(AEMaaCS)로 sling 매핑을 마이그레이션하면 클라우드 환경의 변경할 수 없는 특성으로 인해 호환성 문제가 발생합니다. 이 문제를 해결하려면 지원되는 클라우드 호환 형식을 사용하여 sling 매핑을 재구성하고 배포합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service(AEMaaCS) - 사이트

문제/증상

  • 여러 경로 및 도메인에 대한 매핑이 올바른 URL을 생성하지 못합니다.
  • /etc/map의 정방향 및 역방향 매핑이 AEMaaCS에서 작동하지 않습니다.
  • 보내는 URL이 올바르지 않은 것으로 보이지만 올바른 대상으로 리디렉션합니다.
  • 들어오는 URL은 올바르게 작동하지만 나가는 동작이 일관적이지 않습니다.
  • AEMaaCS의 불변성 때문에 AEMaaCS는 코드를 통해 Sling 매핑을 배포해야 합니다.

해결 방법 resolution

AEMaaCS와 호환되는 sling 매핑을 변환하고 배포하려면 다음 단계를 따르십시오.

  1. 온-프레미스 /etc/map 디렉터리에서 .zip 패키지로 기존 Sling 매핑을 내보냅니다.

  2. 내보낸 .zip 패키지를 your_project/ui.content/src/main/content/jcr_root/ 아래의 프로젝트 코드 베이스에 추가합니다.

  3. etc 디렉터리 내의 맵 폴더의 이름을 map.publish(으)로 바꾸십시오.

  4. /etc/map.publish을(를) 매핑 위치로 참조하도록 Apache Sling Resource Resolver 구성을 업데이트합니다.

    1. PID org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl에 대해 OSGi 구성 JSON을 만들거나 업데이트합니다.
    2. resource.resolver.map.location을(를) /etc/map.publish(으)로 설정합니다.
    3. JCR에서 매핑 논리를 마이그레이션하는 경우 resource.resolver.mapping을(를) 사용자 지정 배열 값으로 업데이트하십시오.

  5. 모든 변경 사항을 저장하고 Adobe Cloud Manager을 사용하여 업데이트된 코드베이스를 배포하여 변경 사항을 AEMaaCS에 푸시합니다.

  6. 프로덕션에 배포하기 전에 들어오는 URL과 나가는 URL이 모두 올바르게 동작하도록 개발 및 스테이징 환경에서 매핑을 철저히 테스트합니다.

관련 읽기

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f