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

CAM(Repository Modernizer) repo-modernizer-cam

Last update: Tue Jun 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager as a Cloud Service
  • 주제:

작성 대상:

  • 관리자

Repository Modernizer 는 Adobe Experience Manager as a Cloud Service에 대해 정의된 프로젝트 구조와 호환될 수 있도록 콘텐츠와 코드를 개별 패키지로 분리하여 기존 프로젝트 패키지를 재구성하도록 개발된 유틸리티입니다.

소개 introduction

Adobe Experience Manager as a Cloud Service은 AEM 프로젝트에 많은 새로운 기능과 가능성을 제공합니다. 그러나 Adobe Experience Manager Maven 프로젝트가 AEM Cloud Service와 호환되도록 하려면 몇 가지 변경 사항이 필요합니다. 높은 수준에서 AEM에서는 변경 가능한 콘텐츠와 변경 불가능한 콘텐츠 사이의 분할을 준수하도록 콘텐츠 ​와(과) 코드 ​을(를) 개별 하위 패키지로 분리해야 합니다. Cloud Service의 새 AEM 프로젝트 구조에 대한 자세한 내용은 AEM 프로젝트 구조를 참조하십시오.

Repository Modernizer는 다음 배포 구조를 생성하여 호환되는 AEM Cloud Service 프로젝트 구조를 만듭니다.

  • ui.apps 패키지가 /apps에 배포되고 모든 코드를 포함합니다.

  • ui.content 패키지가 런타임 쓰기 가능 영역(예: /content, /conf, /home 또는 /apps이(가) 아닌 모든 영역)에 배포되며 모든 콘텐츠 및 구성을 포함합니다.

  • all 패키지는 하위 패키지 ui.apps 및 ui.content이(가) 포함된 컨테이너 패키지입니다.

NOTE
프로젝트 구조는 패키지 및 해당 pom.xml/filter.xml files의 Archetype 48 ​을(를) 기반으로 합니다. 자세한 내용은 Archetype 48을(를) 참조하십시오.

Repository Modernizer 는 이제 다음 프로젝트 유형도 지원합니다.

  • MULTI_PROJECT: 공통 상위 POM, Dispatcher 및 모든 모듈이 없는 다중 모듈 프로젝트를 나타냅니다.
  • SINGLE_PROJECT: 단일 프로젝트를 나타냅니다.
  • NESTED_PROJECT: 공통 상위 POM, Dispatcher 및 모든 모듈이 있는 다중 모듈 프로젝트를 나타냅니다.
  • MONOLITHIC_PROJECT: 하나 이상의 하위 프로젝트가 있는 기본 프로젝트를 나타냅니다.

Repository Modernizer 사용 using-repo-modernizer

video poster

https://video.tv.adobe.com/v/3412962/?quality=12&learn=on&captions=kor

  • 이제 리팩터링 작업 탭 아래의 리팩터링 서비스에서 Repository Modernizer를 자동으로 호출합니다. 고객은 프로젝트를 업로드하고 리팩터링 작업을 트리거하면 되므로 추가 설정이 필요하지 않습니다.

오류 코드 참조

Repository Modernizer를 사용하는 동안 오류 코드가 발생하면 아래 표에서 자세한 내용 및 권장 작업을 참조하십시오.

오류 코드
메시지
설명
사용자 작업이 필요하십니까?
RM-
OSGi 구성 파일 {0}을(를) .cfg.json 형식으로 변환하는 동안 오류가 발생했습니다. 기존 구성 파일의 유효성을 확인한 후 다시 시도하십시오.
이 오류는 OSGi 구성 파일을 .cfg.json 형식으로 변환하는 동안 문제가 발생할 때 발생합니다.
예
RM-
다음에서 콘텐츠를 복사하는 중 오류 발생:
이 오류는 지정된 소스에서 콘텐츠를 복사하는 동안 오류가 발생하는 경우 발생합니다.
아니요
RM-
{0} 파일을 {1}에서 {2}(으)로 이동하는 동안 오류가 발생했습니다.
이 오류는 파일을 한 위치에서 다른 위치로 이동하는 데 문제가 있을 때 발생합니다.
아니요
RM-
지정한 경로를 올바른 파일로 확인할 수 없습니다.
이 오류는 지정된 위치에서 파일을 찾을 수 없을 때 발생합니다.
아니요
RM-
{0}의 내용을 반복하는 동안 오류가 발생했습니다.
이 오류는 파일 또는 디렉터리를 트래버스하는 동안 발생하며, 이는 콘텐츠에 액세스하거나 처리하는 데 문제가 있음을 나타냅니다.
아니요
RM-
XML 파일을 구문 분석하는 동안 오류가 발생했습니다. {0}. XML 파일의 유효성을 검사한 후 다시 시도하십시오.
이 오류는 XML 파일을 구문 분석하지 못할 때 발생합니다.
예
RM-
XML 파일에 쓰는 동안 오류가 발생했습니다. {0}.
이 오류는 XML 파일에 쓰는 데 문제가 있을 때 발생합니다.
아니요
RM-
기존 프로젝트에서 컨텐츠 패키지를 찾을 수 없습니다. {0}. 올바른 프로젝트가 업로드되었는지 확인하십시오.
이 오류는 기존 프로젝트에서 컨텐츠 패키지를 찾을 수 없음을 나타냅니다.
예
RM-
예상 경로 {0}에서 POM 파일을 찾을 수 없습니다. 프로젝트 또는 모듈의 POM 파일은 하위 파일로 해당 디렉터리 내에 직접 있어야 합니다.
이 오류는 POM 파일을 예상 위치에서 찾을 수 없을 때 발생합니다.
예
RM-
pom.xml 파일을 구문 분석하는 동안 오류가 발생했습니다. {0}. pom 파일의 유효성을 확인한 후 다시 시도하십시오.
이 오류는 pom.xml 파일을 구문 분석하는 데 문제가 있을 때 발생합니다.
예
RM-
pom.xml 파일에 쓰는 동안 오류가 발생했습니다. {0}.
이 오류는 pom 파일에 쓰는 데 문제가 있을 때 발생합니다.
아니요
RM-
보고서 파일에 쓰는 동안 오류가 발생했습니다.
이 오류는 보고서 파일에 쓰는 동안 오류가 발생할 때 발생합니다.
아니요
RM-
({1})의 저장소 구조 pom 파일에서 {0}을(를) 찾을 수 없습니다.
이 오류는 AEM Project Archetype 템플릿에서 예상 구성을 찾을 수 없을 때 발생합니다.
아니요
RM-
AEM Project Archetype 템플릿을 대상에 복사하는 도중 오류가 발생했습니다.
이 오류는 AEM Project Archetype 템플릿을 대상에 복사하는 데 문제가 있을 때 발생합니다.
아니요
RM-
Azure Blob Storage에 연결하는 동안 오류가 발생했습니다.
이 오류는 Azure Blob Storage에 연결하는 데 문제가 있을 때 발생합니다.
아니요
RM-
파일 {0}을(를) Azure Blob Storage에 업로드하는 동안 오류가 발생했습니다.
이 오류는 Azure Blob Storage에 파일을 업로드하는 데 문제가 있을 때 발생합니다.
아니요
RM-
Azure Blob 저장소에서 파일 {0}을(를) 다운로드하는 동안 오류가 발생했습니다.
이 오류는 Azure Blob 저장소에서 파일을 다운로드하는 데 문제가 있을 때 발생합니다.
아니요
RM-
처리하는 동안 I/O 오류가 발생했습니다. {0}.
이 오류는 프로젝트 파일을 읽거나 쓰는 데 문제가 있을 때 발생합니다.
아니요
RM-
Azure에 업로드할 결과를 보관하는 동안 I/O 오류가 발생했습니다.
이 오류는 프로세스에서 생성된 결과를 보관하는 동안 오류가 발생할 때 발생합니다.
아니요
RM-
제공 프로젝트 zip을 보관 해제하는 동안 I/O 오류가 발생했습니다. 제공된 프로젝트 zip이 유효한지 확인하십시오.
이 오류는 제공된 고객 프로젝트를 보관 해제하는 동안 오류가 발생할 때 발생합니다.
예
RM-
구성 파일에 쓰는 동안 오류가 발생했습니다.
이 오류는 구성 파일에 쓰는 동안 오류가 발생할 때 발생합니다.
아니요
RM-
지원되지 않는 요청 유형: {0}.
이 오류는 요청 유형이 시스템에서 지원되지 않을 때 발생합니다. 요청 유형을 확인하고 다시 시도하십시오.
아니요

결과 보고서 우선 순위 이해

Repository Modernizer 도구에서 생성한 결과 보고서를 다운로드하면 각 결과에 우선 순위 ​가 지정됩니다. 이러한 우선 순위를 통해 각 문제의 긴급성과 영향을 이해할 수 있습니다.

우선 순위
설명
위험
프로젝트를 성공적으로 빌드하려면 문제를 해결해야 합니다.
높음
AEM에서 기능이 손상되지 않도록 해결해야 합니다.
표준
현대화의 전체적인 온전성과 완전성을 보장하기 위해 해결되어야 한다.
낮음
수동 확인의 경우, 이러한 결과는 정보 제공용이므로 즉각적인 조치가 필요하지 않을 수 있습니다.
NOTE
원활한 현대화 및 배포 프로세스를 위해 우선 순위가 높은 결과를 먼저 해결하는 것이 좋습니다.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab