설명서AEM사용 안내서

AEM as a Cloud Service으로 AI 지원 코드 마이그레이션 cloud-migration-skill-overview

마지막 업데이트: 2026년 9월 17일
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • Developer

AEM 클라우드 마이그레이션 솔루션은 개발자에게 AEM 6.x, AMS 또는 온프레미스 Java 코드와 OSGi 구성을 AEM as a Cloud Service(AEMaaCS)(으)로 마이그레이션하는 과정을 안내하는 에이전트 기반 도구 집합입니다. 에이전트 기술과 모델 컨텍스트 프로토콜(MCP)을 지원하는 AI 지원 IDE 내에서 작동합니다.

다음 데모 비디오는 AEM 클라우드 마이그레이션 솔루션에 대한 간략한 설명을 제공하며 참조용으로 포함되어 있습니다.

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

솔루션은 다음 두 가지 구성 요소로 구성됩니다.

구성 요소
역할
마이그레이션 기술
마이그레이션 워크플로우를 조정하고 BPA(Best Practices Analyzer) 결과를 생성하며 프로젝트의 영향을 받는 파일을 식별하며 패턴별 코드 변환 패턴을 적용합니다. 로컬 BPA CSV 내보내기 또는 클라우드 마이그레이션 MCP(권장)와 함께 작동합니다.
클라우드 마이그레이션 MCP
IDE 에이전트를 CAM(Cloud Acceleration Manager)에 연결하여 CSV 내보내기 없이 직접 BPA 결과를 가져올 수 있습니다. 최신 결과를 얻으려면 로컬 CSV보다 권장됩니다.

사전 요구 사항 prerequisites

  • IDE에서 열려 있는 AEM 프로젝트(Maven 또는 Gradle)

  • 다음 BPA 검색 소스 중 하나(수동 흐름의 경우 필요하지 않은 것이 좋음).

    • AEM 인스턴스의 BPA CSV 내보내기
    • 업로드된 BPA 보고서와 클라우드 마이그레이션 MCP가 구성된 Cloud Acceleration Manager 프로젝트

마이그레이션 기술 migration-skill

마이그레이션 기술은 AI 지원 IDE에 대한 에이전트 기술입니다. 세션당 하나의 패턴 워크플로우를 조정합니다. 사용자가 수정할 패턴의 이름을 지정하고, BPA 결과를 에이전트로 지정하고, 에이전트가 관련 변환 규칙을 읽고, 영향을 받는 파일을 프로젝트에서 찾고, 5개의 배치로 변경 사항을 적용하고, 각 배치 후 검토를 일시 중지합니다.

마이그레이션 Runbook 시작 migration-runbook

수정하기 전에 에이전트에게 “AEMaaCS 마이그레이션에 대한 내 코드를 검토해 보십시오.” 스킬은 코드를 편집하는 대신 프로젝트 루트에 읽기 전용migration-runbook.md​을(를) 생성합니다. Runbook은 스킬이 처리할 수 있는 every 마이그레이션 패턴을 다루며, 영향을 받는 파일, 패턴별 검색 횟수 및 각 수정 사항을 시작하기 위한 복사-붙여넣기 메시지를 나열합니다.

Runbook은 전체 프로젝트 평가를 위한 권장 진입점입니다. 파일을 변경하기 전에 우선 순위가 지정되고 예기치 않은 마이그레이션 작업 상황을 파악할 수 있습니다. 나중에 패턴 세션을 시작할 때 에이전트는 Runbook에 이미 기록된 결과를 다시 사용하므로 다시 스캔할 필요가 없습니다.

NOTE
Runbook은 마이그레이션 기술에서 처리할 수 있는 패턴(지원되는 패턴 아래에 나열된 패턴)만 다룹니다. 저장소 구조 또는 컨텐츠 전송과 같이 이러한 기술 외부에서 처리되는 마이그레이션 작업은 포함되지 않습니다. 보완 도구는 마이그레이션 여정에 어떻게 적합한지를 참조하십시오.

지원되는 패턴 supported-patterns

코드 및 구성 패턴

패턴
수정 사항
scheduler
sling.commons.scheduler 기반 작업이 AEMaaCS의 상태 비저장 런타임과 호환되지 않음
resourceChangeListener
Cloud Service 업데이트가 필요한 ResourceChangeListener개 구현
replication
기존 Replicator API 호출이 ContentDistribution에 해당하는 호출로 대체되었습니다.
eventListener
AEMaaCS 이벤트 의미 체계에 대해 업데이트된 OSGi EventListener 구현
eventHandler
Cloud Service에 맞게 조정된 동기 OSGi EventHandler 서비스
assetApi
더 이상 사용되지 않는 AssetManager 및 DAM API 호출이 지원되는 해당 호출로 대체되었습니다.
guavaCache
Cloud Service에서 지원하는 카페인 캐시와 교환된 구아바 캐시(com.google.common.cache.*) 사용량
htlLint
HTL 템플릿의 data-sly-test개 중복 상수 비교 경고
OSGi 구성
.cfg.json 전환, 실행 모드 범위 지정, Cloud Manager 암호/env-var 추출, 지원되지 않는 실행 모드(URC) 감지 및 안전한 순서 재지정

레거시 UI 및 템플릿 현대화 패턴

패턴
수정 사항
lui(대화 상자 마이그레이션)
클래식 UI/ExtJS(cq:Dialog) 및 Coral 2 대화 상자를 Coral 3 Touch UI 대화 상자로 변환
cdw(사용자 지정 디자인 위젯)
Coral 3 또는 Granite UI 구성 요소로 스캐폴딩되는 사용자 지정 ExtJS 위젯(cq:Widget개의 xtype)
템플릿 현대화
AEM 현대화 도구 구조, 구성 요소 및 정책 재작성 규칙이 생성되어 편집 가능한 템플릿으로 변환된 정적 템플릿. 중첩된 템플릿 폴더를 포함하여 기존 및 사용자 지정 정적 템플릿을 모두 감지하고 분류합니다.

Dispatcher 구성

패턴
수정 사항
dispatcherConversion
AEM as a Cloud Service 구조로 전환된 AMS 또는 온프레미스 Apache HTTPD 및 Dispatcher 구성

워크플로에 대해서는 Dispatcher 전환을(를) 참조하십시오.

이 스킬은 모든 코드 변환 단계를 code-assessment 스킬에 위임합니다. 둘 다 aem-cloud-service 스킬 패키지로 함께 배포됩니다. 둘 다 가져오려면 패키지를 한 번 설치하십시오.

시작하기 getting-started-skill

  1. Adobe 스킬 저장소에서 aem-cloud-service 스킬 패키지(마이그레이션 및 code-assessment 스킬 모두 포함)를 설치합니다. IDE별 설치 명령에 대해서는 AI 도구를 사용한 로컬 개발을 참조하십시오.

  2. AEM 프로젝트를 IDE에서 작업 영역 루트로 엽니다.

  3. BPA 결과 얻기: BPA에서 CSV를 내보내거나 클라우드 마이그레이션 MCP를 구성합니다(아래 참조).

  4. 다음 프롬프트 중 하나를 사용하여 에이전트로 세션을 시작합니다.

    먼저 전체 프로젝트 평가(읽기 전용 Runbook 생성):

    code language-none 
    Review my code for AEMaaCS migration

    BPA CSV:

    code language-none 
    Use the migration skill: scheduler only, BPA CSV at ./reports/bpa.csv

    MCP를 통한 CAM:

    code language-none 
    Fix replictaion findings from project <projectname>/<projectId>.

    수동(BPA 없음):

    code language-none 
    Migrate event listener in core/src/main/java/com/example/Listener.java

    OSGi 구성:

    code language-none 
    Scan my config files and create Cloud Manager environment secrets or variables.

    HTL lint:

    code language-none 
    Fix htlLint in ui.apps - scan for data-sly-test redundant constant warnings.

    구아바 캐시:

    code language-none 
    Fix guavaCache findings using BPA CSV at ./reports/bpa.csv

    Dispatcher 전환:

    code language-none 
    Convert my AMS / on-prem Dispatcher config to AEM as a Cloud Service.
NOTE
이 기술은 세션당 한 패턴을 처리합니다. BPA 보고서에 여러 패턴이 포함되어 있는 경우 에이전트는 시작하기 전에 하나를 선택하라는 메시지를 표시합니다.

전체 패턴 참조 및 세션 관리 지침은 클라우드 마이그레이션 기술 사용을 참조하십시오.

클라우드 마이그레이션 MCP cloud-migration-mcp

AEM 클라우드 마이그레이션 MCP​는 IDE 에이전트를 Cloud Acceleration Manager에 연결하는 모델 컨텍스트 프로토콜 서버입니다. 구성된 경우 마이그레이션 기술은 CSV 다운로드 없이 CAM 프로젝트에서 직접 BPA 결과를 가져올 수 있습니다.

MCP가 제공하는 사항 mcp-tools

도구
설명
fetch-cam-bpa-findings-by-pattern
CAM 프로젝트의 최신 BPA 보고서에서 특정 코드 마이그레이션 패턴에 대한 BPA 결과를 반환합니다.
fetch-cam-bpa-findings-by-importance
개수별로 정렬된 특정 심각도(CRITICAL, MAJOR, ADVISORY, INFO)의 모든 BPA 검색 결과를 반환합니다. 먼저 작업할 패턴의 우선 순위를 정하는 데 유용합니다.

이러한 도구는 마이그레이션 기술에 의해 자동으로 호출되므로 직접 호출하지 않습니다.

시작하기 getting-started-mcp

  1. IDE의 MCP 구성에서 클라우드 마이그레이션 MCP 서버 URL https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration을(를) 추가합니다.
  2. 메시지가 표시되면 Adobe ID으로 로그인하여 Cloud Acceleration Manager에 대해 인증합니다.
  3. 마이그레이션 기술은 이제 CAM 프로젝트에서 직접 BPA 결과를 가져올 수 있습니다.

자세한 설정 및 문제 해결은 클라우드 마이그레이션 MCP 사용을 참조하십시오.

마이그레이션 여정에 적합한 방식 migration-journey

기술 및 MCP는 구현 단계​의 다른 도구를 보완합니다.

  • 모범 사례 분석기: 스킬을 유도하는 검색 결과를 생성합니다. 모범 사례 분석기 사용을 참조하세요.
  • Cloud Acceleration Manager: BPA를 호스팅하고 전체 마이그레이션 진행 상황을 추적합니다. CAM 시작하기를 참조하십시오.
  • 리팩터링 도구: 리포지토리 구조 및 Dispatcher 구성 현대화 작업을 처리합니다. 리팩터링 도구 개요를 참조하세요.
  • 컨텐츠 전송 도구: 저장소 컨텐츠를 AEM 6.x에서 AEMaaCS로 마이그레이션합니다.

전체 그림을 보려면 구현 단계 개요를 참조하십시오.

recommendation-more-help
experience-manager-cloud-service-help-main-toc