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

마지막 업데이트: 2026년 5월 28일

적용 대상:
Experience Manager as a Cloud Service

주제:
Migration

작성 대상:

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개의 배치로 변경 사항을 적용하고, 각 배치 후 검토를 일시 중지합니다.

지원되는 패턴 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 호출이 지원되는 해당 호출로 대체되었습니다.

htlLint

HTL 템플릿의 data-sly-test개 중복 상수 비교 경고

OSGi 구성

.cfg.json 전환, 실행 모드 범위 지정 및 Cloud Manager secrets/env-var 추출

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

시작하기 getting-started-skill

Adobe 기술 저장소에서 aem-cloud-service 기술 패키지를 설치하십시오.
AEM 프로젝트를 IDE에서 작업 영역 루트로 엽니다.
BPA 결과 얻기: BPA에서 CSV를 내보내거나 클라우드 마이그레이션 MCP를 구성합니다(아래 참조).

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

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.`

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

IDE의 MCP 구성에서 클라우드 마이그레이션 MCP 서버 URL https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration을(를) 추가합니다.
메시지가 표시되면 Adobe ID으로 로그인하여 Cloud Acceleration Manager에 대해 인증합니다.
마이그레이션 기술은 이제 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