AEM 클라우드 마이그레이션 기술 사용 using-cloud-migration-skill
이 참조서에서는 지원되는 각 마이그레이션 패턴, BPA 검색 결과를 제공하는 방법 및 대규모 프로젝트에서 세션을 관리하는 방법을 다룹니다. 소개 및 설정 지침은 개요를 참조하십시오.
세션 작동 방식 workflow-overview
모든 마이그레이션 세션은 다음 시퀀스를 따릅니다.
- 패턴 이름 지정: 패턴 하나를 지정하십시오(예:
scheduler). - 검색 결과 제공: BPA CSV 파일, MCP를 통한 CAM 또는 특정 파일 경로에서
- 에이전트가 변환 규칙을 읽습니다: 스킬이 코드를 변경하기 전에
code-assessment스킬에서 관련 변환 규칙을 읽습니다. - 5개의 첫 번째 일괄 처리: 에이전트는 최대 5개의 검색 결과를 변환하고 변경 내용을 보고합니다
- 검토 후 계속 진행: 각 일괄 처리를 검토한 후
continue에 회신하여 다음 단계로 진행합니다.
에이전트는 한 번에 하나의 패턴과 하나의 배치를 처리합니다. 자동으로 진행되지 않습니다. 각 배치에 확인이 필요합니다.
마이그레이션 패턴 patterns
스케줄러 scheduler
AEMaaCS의 상태 비저장 컨테이너화된 런타임과 호환되지 않는 sling.commons.scheduler 또는 Scheduler 삽입을 사용하는 Java 클래스를 타깃팅합니다.
BPA 패턴 ID: scheduler
에이전트는 @Designate을(를) 사용하여 Scheduler개의 주입 작업을 Runnable의 @Component 구현으로 전환하고 생성자 기반 스케줄러 등록을 @Activate/@Deactivate 라이프사이클 메서드로 바꿉니다.
ResourceChangeListen resource-change-listener
AEMaaCS에 대한 업데이트가 필요한 ResourceChangeListener 또는 ResourceChange 수신기 구현을 대상으로 합니다.
BPA 패턴 ID: resourceChangeListener
복제 replication
com.day.cq.replication.Replicator 또는 관련 복제 API를 가져오는 대상 클래스이며, AEMaaCS에서 지원되지 않습니다. 에이전트는 이 항목을 ContentDistribution 기반 항목으로 바꾸고 해당 OSGi 서비스 참조를 업데이트합니다.
BPA 패턴 ID: replication
이벤트 리스너 event-listener
AEMaaCS 이벤트 처리 의미 체계에 대해 업데이트해야 하는 OSGi EventListener 또는 EventHandler 구현을 대상으로 합니다.
BPA 패턴 ID: eventListener
이벤트 핸들러 event-handler
AEMaaCS에 맞게 조정해야 하는 동기 OSGi EventHandler 서비스를 대상으로 합니다.
BPA 패턴 ID: eventHandler
자산 API asset-api
더 이상 사용되지 않는 AssetManager, DAMEvent 또는 지원되지 않는 DAM API를 사용하는 타겟 클래스입니다. 에이전트는 이를 지원되는 AEM Assets API 동등한 기능으로 대체합니다.
BPA 패턴 ID: assetApi
HTL Lint(data-sly-test) htl-lint
data-sly-test: redundant constant value comparison개의 lint 경고를 생성하는 ui.apps 아래의 HTL 템플릿을 대상으로 합니다. 에이전트는 콘텐츠 패키지를 직접 스캔하여 영향을 받는 템플릿을 검색합니다. 이 패턴은 BPA CSV 또는 CAM 연결이 필요하지 않습니다.
BPA 패턴 ID: htlLint
htlLint 결과가 BPA CSV 내보내기에 표시되지 않습니다. 에이전트는 이 패턴에 대한 세션을 시작할 때 직접 파일 검색을 통해 이를 검색합니다.Cloud Manager에 OSGi 구성 osgi-cloud-manager
ui.config의 OSGi 구성을 전체 환경별 처리를 통해 Cloud Manager 호환 .cfg.json 형식으로 변환합니다. 여기에는 두 가지 관련 작업이 포함됩니다.
구성 형식 변환
AEMaaCS에서는 실행 모드 범위 폴더(config.author/, config.publish/, config.dev/ 등)에 환경별 구성을 사용하여 OSGi 구성을 .cfg.json 파일로 저장해야 합니다. 에이전트:
- 기존
.config,.cfg및 XML 형식 OSGi 구성을.cfg.json(으)로 전환합니다. - 작성자 및 게시자 관련 값이 모두 포함된 구성을 별도의 실행 모드 범위 파일로 분할합니다.
- OSGi 메타타입 사양(문자열, 정수, 부울, 배열)에 대해 속성 형식을 확인합니다.
- Adobe 소유 PID를 자동 변환하지 않고 수동으로 검토하도록 플래그 지정
암호 및 환경 변수
커밋된 구성 파일에서 일반 텍스트 암호 및 환경별 값을 이동하고 Cloud Manager 자리 표시자로 대체합니다.
$[secret:NAME]: 암호, 토큰 및 기타 중요한 값의 경우$[env:NAME]: 환경별로 다른 민감하지 않은 값(예: 서비스 URL)의 경우
해당 변수와 비밀은 Cloud Manager에 적용되고 런타임에 삽입되며 값은 소스 제어에 저장되지 않습니다.
이 패턴은 BPA CSV 또는 CAM을 사용하지 않습니다. 다음으로 세션 시작:
Scan my config files and create Cloud Manager environment secrets or variables.
BPA Source 옵션 bpa-source
MCP 오류 처리 mcp-errors
MCP 연결이 오류(프로젝트를 찾을 수 없음 또는 인증 실패 포함)를 반환하는 경우 에이전트가 중지되고 오류를 표시합니다. 자동으로 다른 소스로 전환되지 않습니다. 정지됨 상태에서 다음을 수행할 수 있습니다.
- 표시된 에이전트 목록에서 올바른 프로젝트를 확인합니다
- 대안으로 BPA CSV 경로 제공
- 수동 마이그레이션을 위한 특정 Java 파일 경로 제공
대형 보고서에서 세션 관리 large-reports
많은 검색 결과가 있는 BPA 보고서의 경우, 일괄 처리 접근 방식을 사용하여 점진적으로 확인할 수 있습니다.
- 각 배치에 대한 차이 검토
- 패턴 범위 커밋 메시지로 배치 커밋
- 다음 일괄 처리를 시작하려면
continue에 회신 - 에이전트가 패턴에 대한 모든 검색 결과가 완료되었다고 보고할 때까지 반복합니다
커밋당 하나의 패턴을 사용하면 git 기록을 읽을 수 있으며 필요한 경우 개별 패턴 변환을 쉽게 되돌릴 수 있습니다.
Workspace 범위 workspace-scope
에이전트는 열려 있는 IDE 작업 영역 폴더 내에서만 파일을 검색하고 편집합니다. 디스크의 상위 디렉터리, 동일 수준의 폴더 또는 다른 위치를 검사하지 않습니다.
BPA 검색 결과가 작업 공간에 없는 파일 경로를 참조하는 경우 에이전트는 중지하고 누락된 경로를 알려줍니다. 올바른 프로젝트 폴더를 열거나 계속하려면 명시적으로 경로를 제공하십시오.