DocumentazioneAEMGuida utente

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

Ultimo aggiornamento: 28 maggio 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

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.

Pattern supportati supported-patterns

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

L’abilità delega tutti i passaggi di trasformazione del codice all’abilità best-practices 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 dall’archivio di competenze Adobe.

  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 l’MCP di migrazione cloud (vedi di seguito).

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

    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

  1. Nella configurazione MCP dell’IDE aggiungere l’URL del server MCP di migrazione cloud: https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration
  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 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