Migrazione del codice assistito da IA ad AEM as a Cloud Service cloud-migration-skill-overview

Ultimo aggiornamento: 2 settembre 2026

Si applica a:
Experience Manager as a Cloud Service

Argomenti:
Migration

Creato per:

Developer

La soluzione AEM Cloud Migration è un set di strumenti basato su agenti che guida gli sviluppatori attraverso la migrazione del codice Java e delle configurazioni OSGi AEM 6.x, AMS oppure on-premise in AEM as a Cloud Service (AEMaaCS). Funziona all’interno di qualsiasi IDE abilitato all’intelligenza artificiale che supporta le abilità dell’agente e il protocollo MCP (Model Context Protocol).

Il seguente video dimostrativo fornisce una guida rapida end-to-end della soluzione AEM Cloud Migration ed è incluso come riferimento.

https://video.tv.adobe.com/v/3491446?captions=ita&learn=on

La soluzione è costituita da due componenti:

Componente

Ruolo

Abilità di migrazione

Orchestrazione del flusso di lavoro di migrazione, ricerca i risultati di Best Practices Analyzer (BPA), identifica i file interessati nel progetto e applica le trasformazioni del codice in base al modello. Funziona con un’esportazione CSV locale BPA o con Cloud Migration MCP (consigliato).

MCP migrazione cloud

Collega l’agente IDE a Cloud Acceleration Manager (CAM), consentendogli di recuperare i risultati BPA direttamente senza un’esportazione CSV. Consigliato tramite un file CSV locale per i risultati più aggiornati.

Prerequisiti prerequisites

Un progetto AEM (Maven o Gradle) aperto nell’IDE
Una delle seguenti fonti di reperimento di BPA (fortemente consigliata, non necessaria per i flussi manuali):
- Un’esportazione CSV BPA dalla tua istanza AEM
- Un progetto Cloud Acceleration Manager con un report BPA caricato e l’MCP di migrazione cloud configurato

L’abilità di migrazione migration-skill

L’abilità di migrazione è un’abilità agente per gli IDE abilitati per l’intelligenza artificiale. Ordina un flusso di lavoro di un modello per sessione: assegna un nome al modello da correggere, indirizza l’agente ai risultati BPA e l’agente legge le regole di trasformazione pertinenti, individua i file interessati nel progetto e applica le modifiche in batch di cinque, mettendo in pausa la revisione dopo ogni batch.

Iniziare con un Runbook di migrazione migration-runbook

Prima di risolvere il problema, chiedere all’agente di “Rivedere il codice per la migrazione di AEMaaCS.” Invece di modificare il codice, l’abilità genera un migration-runbook.mddi sola lettura nella directory principale del progetto. Il runbook copre ogni pattern di migrazione che l’abilità può risolvere, elencando i file interessati, i conteggi di ricerca per pattern e un prompt di copia e incolla per avviare ogni correzione.

Il runbook è il punto di ingresso consigliato per una valutazione dell’intero progetto: offre un’immagine prioritaria e senza sorprese dello sforzo di migrazione prima che qualsiasi file venga modificato. Quando successivamente avviate una sessione di pattern, l’agente riutilizza i risultati già registrati nel runbook, pertanto non è necessario ripetere la scansione.

NOTE

Il runbook copre solo i modelli che l'abilità di migrazione può risolvere (elencati in Modelli supportati). Il lavoro di migrazione gestito al di fuori di queste competenze, ad esempio la struttura dell’archivio, la configurazione del dispatcher o il trasferimento dei contenuti, non è incluso. Consulta Come si adattano al Percorso di migrazione per gli strumenti complementari.

Pattern supportati supported-patterns

Codice e modelli di configurazione

Pattern

Cosa corregge

scheduler

sling.commons.scheduler processi non compatibili con il runtime senza stato di AEMaaCS

resourceChangeListener

ResourceChangeListener implementazioni che richiedono aggiornamenti Cloud Service

replication

Chiamate API legacy Replicator sostituite da ContentDistribution equivalenti

eventListener

Implementazioni OSGi EventListener aggiornate per la semantica degli eventi AEMaaCS

eventHandler

Sincrona servizi OSGi EventHandler adattati per Cloud Service

assetApi

Le chiamate API AssetManager e DAM obsolete sono state sostituite con equivalenti supportati

htlLint

data-sly-test avvisi di confronto costanti ridondanti nei modelli HTL

Configurazioni OSGi

Conversione .cfg.json, ambito modalità di esecuzione ed estrazione segreti/env-var Cloud Manager

Interfaccia utente legacy e modelli di modernizzazione

Pattern

Cosa corregge

lui (migrazione finestre di dialogo)

Interfaccia classica / finestre di dialogo ExtJS (cq:Dialog) e Coral 2 convertite in finestre di dialogo Interfaccia utente touch Coral 3

cdw (widget di progettazione personalizzati)

Widget ExtJS personalizzati (cq:Widget xtypes) mappati a Coral 3 o scaffoldati come componenti dell’interfaccia utente Granite

Modernizzazione dei modelli

Modelli statici convertiti in modelli modificabili, con struttura, componente e regole di riscrittura dei criteri generati dagli strumenti di modernizzazione AEM

L’abilità delega tutti i passaggi di trasformazione del codice all’abilità code-assessment correlata. Entrambi sono distribuiti insieme come pacchetto di competenze aem-cloud-service. Installare il pacchetto una sola volta per ottenere entrambi.

Guida introduttiva getting-started-skill

Installa il pacchetto di competenze aem-cloud-service (che include sia la migrazione che le competenze code-assessment) dall’archivio delle competenze Adobe. Per i comandi di installazione per IDE, vedere Sviluppo locale con strumenti di IA.
Apri il progetto AEM come directory principale dell’area di lavoro nell’IDE.
Ottenere i risultati BPA: esporta un CSV da BPA o configura l’MCP di migrazione cloud (vedi di seguito).

Avvia una sessione con l’agente utilizzando uno dei seguenti prompt:

Valuta prima l’intero progetto (genera il runbook di sola lettura):

code language-none
`Review my code for AEMaaCS migration`

CSV BPA:

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

CAM tramite MCP:

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

Manuale (nessun BPA):

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

Configurazioni OSGi:

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

Collegamento HTL:

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

NOTE

L’abilità elabora un pattern per sessione. Se il report BPA contiene più pattern, l'agente richiede di sceglierne uno prima di iniziare.

Per istruzioni complete sulla gestione di sessioni e riferimenti ai modelli, consulta Utilizzo dell’abilità di migrazione cloud.

MCP di migrazione cloud cloud-migration-mcp

AEM Cloud Migration MCP è un server Model Context Protocol che connette l’agente IDE a Cloud Acceleration Manager. Una volta configurata, l’abilità di migrazione può recuperare i risultati BPA direttamente dal progetto CAM senza richiedere il download CSV.

Informazioni fornite da MCP mcp-tools

Strumento

Descrizione

fetch-cam-bpa-findings-by-pattern

Restituisce i risultati BPA per un pattern di migrazione del codice specifico dall’ultimo rapporto BPA in un progetto CAM.

fetch-cam-bpa-findings-by-importance

Restituisce tutti i risultati BPA a una determinata gravità (CRITICAL, MAJOR, ADVISORY, INFO), ordinati in base al conteggio. Utile per assegnare priorità ai pattern su cui lavorare per primi.

Questi strumenti vengono richiamati automaticamente dall’abilità di migrazione; non li chiami direttamente.

Guida introduttiva getting-started-mcp

Nella configurazione MCP dell’IDE aggiungere l’URL del server MCP di migrazione cloud: https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration
Quando richiesto, accedi con il tuo Adobe ID per eseguire l’autenticazione su Cloud Acceleration Manager.
L’abilità di migrazione ora può recuperare i risultati BPA direttamente dai progetti CAM.

Per informazioni dettagliate sulla configurazione e la risoluzione dei problemi, vedere Utilizzo di Cloud Migration MCP.

Come si adattano al Percorso di migrazione migration-journey

L’abilità e MCP completano gli altri strumenti nella fase di implementazione:

Best Practices Analyzer: genera i risultati che determinano l’abilità. Consulta Utilizzo di Best Practices Analyzer.
Cloud Acceleration Manager: ospita i report BPA e tiene traccia dell’avanzamento complessivo della migrazione. Consulta Guida introduttiva a CAM.
Strumenti di refactoring: gestisce la struttura dell’archivio e la modernizzazione della configurazione del dispatcher. Vedi Panoramica sugli strumenti di refactoring.
Strumento Content Transfer: esegue la migrazione del contenuto dell’archivio da AEM 6.x ad AEMaaCS.

Per l’immagine completa, vedere la panoramica della fase di implementazione.

recommendation-more-help

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