Utilizzo dell’abilità di migrazione ad AEM Cloud using-cloud-migration-skill

Ultimo aggiornamento: 27 maggio 2026

Si applica a:
Experience Manager as a Cloud Service

Argomenti:
Migration

Creato per:

Developer

Questa documentazione descrive ogni modello di migrazione supportato, come fornire i risultati BPA e come gestire le sessioni in un progetto di grandi dimensioni. Per un’introduzione e le istruzioni di installazione, vedere la panoramica.

Funzionamento di una sessione workflow-overview

Ogni sessione di migrazione segue questa sequenza:

Denomina il pattern: specifica un pattern (ad esempio, scheduler)
Fornisci risultati: da un file BPA CSV, CAM tramite MCP o percorsi di file specifici
L’agente legge le regole di trasformazione: l’abilità legge le regole di trasformazione pertinenti dall’abilità code-assessment associata prima di apportare modifiche al codice
Primo batch di cinque: l’agente trasforma fino a cinque risultati e segnala le modifiche apportate
Rivedi e continua: dopo aver esaminato ogni batch, rispondi continue per passare al successivo

L’agente elabora un modello e un batch alla volta. Non procede automaticamente; ogni batch richiede la tua conferma.

Modelli di migrazione patterns

Modulo di pianificazione scheduler

Esegue il targeting delle classi Java utilizzando l’iniezione di sling.commons.scheduler o Scheduler incompatibili con il runtime AEMaaCS senza stato e containerizzato.

ID pattern BPA: scheduler

L’agente converte Scheduler processi inseriti in @Component implementazioni di Runnable utilizzando @Designate, sostituendo la registrazione dell’utilità di pianificazione basata sul costruttore con i metodi del ciclo di vita @Activate / @Deactivate.

ResourceChangeListener resource-change-listener

Destinazioni delle implementazioni del listener ResourceChangeListener o ResourceChange che richiedono aggiornamenti per AEMaaCS.

ID pattern BPA: resourceChangeListener

Replica replication

Destinazione classi che importano com.day.cq.replication.Replicator o API di replica correlate, non supportate in AEMaaCS. L’agente li sostituisce con equivalenti basati su ContentDistribution e aggiorna i riferimenti del servizio OSGi corrispondenti.

ID pattern BPA: replication

Listener di eventi event-listener

Ha come target le implementazioni OSGi EventListener o EventHandler che devono essere aggiornate per la semantica di elaborazione degli eventi AEMaaCS.

ID pattern BPA: eventListener

Gestore di Evento event-handler

Ha come target i servizi OSGi EventHandler sincroni che devono essere adattati per AEMaaCS.

ID pattern BPA: eventHandler

API Asset asset-api

Consente di eseguire il targeting delle classi utilizzando API DAM AssetManager, DAMEvent o non supportate. L’agente li sostituisce con gli equivalenti API di AEM Assets supportati.

ID pattern BPA: assetApi

Lint HTL (data-sly-test) htl-lint

Esegue il targeting dei modelli HTL in ui.apps che generano data-sly-test: redundant constant value comparison avvisi di lint. L’agente rileva i modelli interessati analizzando direttamente il pacchetto di contenuti; questo modello non richiede una connessione BPA CSV o CAM.

ID pattern BPA: htlLint

NOTE

htlLint risultati non vengono visualizzati nelle esportazioni CSV BPA. L'agente li rileva mediante l'analisi diretta dei file quando si avvia una sessione per questo modello.

Configurazioni OSGi per Cloud Manager osgi-cloud-manager

Converte le configurazioni OSGi in ui.config nel formato .cfg.json compatibile con Cloud Manager con una gestione completa specifica dell’ambiente. Questo riguarda due attività correlate:

Conversione formato configurazione

AEMaaCS richiede che le configurazioni OSGi siano memorizzate come file .cfg.json, con configurazioni specifiche per l’ambiente nelle cartelle con ambito di runmode (config.author/, config.publish/, config.dev/ e così via). L’agente:

Converte le configurazioni OSGi esistenti di .config, .cfg e in formato XML in .cfg.json
Suddivide le configurazioni contenenti valori specifici dell’autore e della pubblicazione in file con ambito di modalità di esecuzione separati
Convalida i tipi di proprietà in base alla specifica del metatipo OSGi (stringhe, interi, booleani, array)
Segnala i PID di proprietà di Adobe per la revisione manuale anziché per la conversione automatica

Segreti e variabili di ambiente

Sposta i segreti di testo normale e i valori specifici dell’ambiente dai file di configurazione salvati e li sostituisce con i segnaposto di Cloud Manager:

$[secret:NAME]: per password, token e altri valori sensibili
$[env:NAME]: per valori non sensibili che differiscono per ambiente (ad esempio, URL del servizio)

Le variabili e i segreti corrispondenti vengono applicati in Cloud Manager e inseriti in fase di runtime; nessun valore viene memorizzato nel controllo del codice sorgente.

IMPORTANT

L'agente non restituisce mai valori segreti nella conversazione. Tutti i dati sensibili vengono scritti in un file handoff ignorato da applicare tramite l’API o l’interfaccia utente di Cloud Manager.

Questo modello non utilizza CSV o CAM BPA. Avvia una sessione con:

Scan my config files and create Cloud Manager environment secrets or variables.

Opzioni Source BPA bpa-source

Origine

Quando utilizzare

File CSV BPA

Hai esportato un file CSV dalla tua istanza di AEM o da Cloud Acceleration Manager. Immetti il percorso del file all’avvio della sessione.

CAM tramite MCP

Hai configurato AEM Cloud Migration MCP. L’agente elenca i progetti CAM, l’utente conferma quale utilizzare e i risultati vengono recuperati direttamente. Vedi Utilizzo di Cloud Migration MCP.

Percorsi file manuali

Desideri eseguire la migrazione di file specifici senza un rapporto BPA. Fornisci i percorsi direttamente nella richiesta.

Gestione degli errori MCP mcp-errors

Se la connessione MCP restituisce un errore (inclusi errori di autenticazione o di progetto non trovato), l’agente si arresta e mostra l’errore. Non passa automaticamente a un’altra sorgente. Dallo stato di arresto, è possibile:

Conferma il progetto corretto dall’elenco visualizzato dall’agente
Fornire un percorso CSV BPA in alternativa
Fornire percorsi di file Java specifici per una migrazione manuale

Gestione delle sessioni in report di grandi dimensioni large-reports

Per i rapporti BPA con molti risultati, l’approccio batch per batch consente di convalidare in modo incrementale:

Esamina le differenze per ciascun batch
Eseguire il commit del batch con un messaggio di commit con ambito pattern
Rispondi continue per avviare il batch successivo
Ripeti l’operazione finché l’agente non segnala che tutti i risultati del modello sono stati completati

Un pattern per commit mantiene la cronologia Git leggibile e, se necessario, semplifica il ripristino delle singole trasformazioni del pattern.

NOTE

Se si termina una sessione prima dell'elaborazione di tutti i risultati, riavviare con lo stesso pattern e la stessa origine BPA in una nuova sessione. L'agente riprende dal punto in cui era stato interrotto.

Ambito Workspace workspace-scope

L’agente cerca e modifica i file solo all’interno delle cartelle aperte dell’area di lavoro IDE. Non esegue la scansione delle directory principali, delle cartelle di pari livello o di altre posizioni su disco.

Se un risultato BPA fa riferimento a un percorso di file che non esiste nell’area di lavoro, l’agente si arresta e indica i percorsi mancanti. Apri la cartella del progetto corretta o fornisci i percorsi in modo esplicito per continuare.

recommendation-more-help

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