DocumentazioneAEMGuida utente

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

Ultimo aggiornamento: 30 ottobre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Sviluppatore

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 il server MCP di AEM (consigliato).
Server MCP AEM
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 il server AEM MCP 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 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
guavaCache
Utilizzo della cache guava (com.google.common.cache.*) scambiato per la cache della caffeina supportata da Cloud Service
inputStream
Utilizzo di java.io.InputStream valutato in base al rischio: flussi non chiusi risolti automaticamente, memoria, file system e problemi di streaming binario proposti per la revisione
htlLint
data-sly-test avvisi di confronto costanti ridondanti nei modelli HTL
oakIndex (versione beta)
Definizioni legacy di _oak_index convertite in definizioni di indice Oak compatibili con AEM as a Cloud Service utilizzando il convertitore di indice di Adobe, rinominate con la denominazione di indice con versione Cloud Service (<name>-custom-<n>), con un controllo di compatibilità del tipo di dati
Configurazioni OSGi
Conversione .cfg.json, ambito modalità di esecuzione, estrazione segreti Cloud Manager/env-var, rilevamento modalità di esecuzione (URC) non supportato e riordinamento sicuro

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 degli strumenti di modernizzazione AEM, componenti e regole di riscrittura dei criteri generati. Rileva e classifica modelli statici legacy e personalizzati, incluse cartelle di modelli nidificati

Configurazione del Dispatcher

Pattern
Cosa corregge
dispatcherConversion
Configurazioni AMS o Apache HTTPD e Dispatcher on-premise convertite nella struttura AEM as a Cloud Service

Consulta Conversione Dispatcher per il flusso di lavoro.

Convalida della migrazione (versione beta)

Funzionalità
Effetto
Convalidare una migrazione
Genera e distribuisce il codice migrato a un SDK AEM as a Cloud Service locale, quindi controlla il contratto di migrazione e lo stato del bundle e dei componenti tramite AEM Quickstart MCP. Non modifica mai il codice sorgente.

Vedi Convalidare una migrazione per il flusso di lavoro.

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

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

  2. Apri il progetto AEM come directory principale dell’area di lavoro nell’IDE.

  3. Ottenere i risultati BPA: esporta un CSV da BPA o configura il server MCP di AEM (vedi sotto).

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

    Cache guava:

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

    FlussoInput:

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

    Conversione Dispatcher:

    code language-none 
    Convert my AMS / on-prem Dispatcher config to AEM as a Cloud Service.

    Conversione indice Oak (beta):

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

    Convalida una migrazione (versione beta):

    code language-none 
    Validate my scheduler migration on the local Cloud SDK.
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.

Funzionalità MCP di migrazione cloud cloud-migration-mcp

Le funzionalità di migrazione di AEM Cloud sono disponibili tramite il server AEM MCP Server, 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

  1. Nella configurazione MCP dell’IDE, aggiungere l’URL del server MCP di AEM: https://mcp.adobeaemcloud.com/adobe/mcp/aem oppure utilizzare una voce esistente con tale URL.
  2. Quando richiesto, accedi con il tuo Adobe ID per eseguire l’autenticazione su Cloud Acceleration Manager.
  3. 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 delle funzionalità di migrazione cloud del server AEM 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