Salta al contenuto principale
Servizi

Migrazione ad AEM as a Cloud Service: piano, codice e contenuti

Dal Best Practices Analyzer al go-live: refactoring del repository, Dispatcher, Content Transfer Tool e pipeline Cloud Manager gestiti come un unico progetto.

La migrazione AEM as a Cloud Service non è un aggiornamento di versione. È un cambio di modello operativo, e come tale va pianificata. Il codice deve rispettare la separazione tra contenuto immutabile e mutabile, le configurazioni OSGi devono essere gestite per ambiente, gli indici Oak devono essere consegnati come codice, il Dispatcher deve superare la validazione dell'SDK e il rilascio passa esclusivamente da Cloud Manager. Chi affronta il progetto come un semplice porting scopre i problemi tardi, quando correggerli costa di più.

Il nostro approccio alla migrazione AEMaaCS è per fasi, con criteri di uscita espliciti. Si parte da un assessment basato su Best Practices Analyzer e analisi manuale, si prosegue con il refactoring del repository e del codice, si imposta il nuovo processo di delivery e solo dopo si trasferiscono i contenuti con Content Transfer Tool, in più passaggi per ridurre la finestra di congelamento editoriale. Ogni fase termina con evidenze verificabili.

La data di fine supporto della versione AEM in uso, e le scadenze contrattuali che ne derivano, vanno verificate sui canali ufficiali Adobe e sul proprio contratto [VERIFICARE]. Non usiamo scadenze di terzi per giustificare un progetto: partiamo dallo stato reale dell'installazione e dagli obiettivi di business, e costruiamo un calendario che il team può sostenere.

Assessment pre-migrazione con BPA

Il Best Practices Analyzer, disponibile tramite Cloud Acceleration Manager, analizza un'istanza esistente e segnala pattern che richiedono intervento prima del passaggio: uso di aree del repository non più modificabili, configurazioni incompatibili, API non supportate, workflow e agenti di replica da rivedere. Il report è un ottimo punto di partenza ma non stabilisce priorità: due segnalazioni con lo stesso livello possono avere sforzi molto diversi.

Per questo affianchiamo al BPA una lettura manuale del progetto, che include moduli Maven, dipendenze, overlay di /libs, servlet registrati su percorsi, integrazioni con sistemi esterni e job pianificati. Il risultato è un piano di refactoring con stime e dipendenze, in cui le decisioni architetturali aperte, come cosa dismettere invece di migrare, sono messe in evidenza e discusse con il cliente prima di iniziare.

Refactoring del repository e struttura del progetto

Sul cloud il codice viene deployato in /apps e /libs come contenuto immutabile, mentre /content, /conf, /var e /home restano mutabili. Tutto ciò che il codice scrive in aree immutabili a runtime deve essere spostato. Si adotta la struttura dell'AEM Project Archetype, con moduli separati per bundle, componenti, configurazioni, contenuti iniziali e front-end, e con un pacchetto contenitore unico che Cloud Manager può costruire in modo riproducibile.

Strumenti come Repository Modernizer aiutano a separare il contenuto mutabile da quello immutabile, mentre Index Converter e Dispatcher Converter automatizzano parte della conversione di indici e configurazioni. Vanno trattati come acceleratori, non come soluzioni: l'output va sempre rivisto. Prestiamo particolare attenzione agli indici personalizzati, perché un indice scritto male o mancante in produzione si traduce in query lente che nessuno vedrà finché il traffico non cresce.

Configurazioni OSGi, Dispatcher e Cloud Manager

Le configurazioni OSGi si organizzano per run mode e ambiente, i segreti e i valori variabili passano per le variabili di Cloud Manager, e le dipendenze dall'istanza locale vanno eliminate. Gli ambienti di sviluppo, stage e produzione devono differire solo per valori di configurazione, mai per codice. Il Dispatcher va portato su una struttura compatibile con l'SDK, validata in locale con lo strumento di validazione prima di ogni pipeline.

In Cloud Manager si definiscono pipeline separate per il codice applicativo, per il front-end e per la configurazione del livello web, con quality gate su qualità del codice, sicurezza e performance. Una pipeline lenta o instabile è un rischio per il progetto quanto un bug applicativo, per cui la sua progettazione fa parte del piano e viene collaudata in anticipo, non il giorno prima del go-live.

Trasferimento dei contenuti con Content Transfer Tool

Il Content Transfer Tool (CTT) estrae i contenuti dall'istanza di origine e li carica nell'ambiente cloud. Per repository di grandi dimensioni si pianificano un'estrazione completa iniziale e successivi trasferimenti differenziali (top-up), così che la finestra di congelamento dei contenuti si limiti all'ultimo passaggio. I risultati delle prove si registrano e si confrontano, perché il comportamento reale dipende da dimensione, struttura e qualità dei dati.

Prima del trasferimento conviene ripulire: versioni obsolete, asset duplicati, contenuti di test e rami non più usati. Dopo l'ingestione si verificano permessi, riferimenti, workflow in sospeso, URL e redirect, e si esegue una validazione editoriale a campione. Il go-live include il cambio DNS, la configurazione della CDN con i domini personalizzati e un piano di rollback concordato con chi gestisce l'infrastruttura.

Dopo il go-live

Il periodo successivo al passaggio è quello in cui emergono le differenze rispetto all'ambiente precedente: tempi di replica diversi, comportamenti di cache, log da consultare in modo nuovo, abitudini editoriali da adattare. Pianifichiamo una fase di stabilizzazione con monitoraggio dei log, controllo dei cache hit e verifica delle pipeline sotto carico di rilascio reale, e formiamo il team sul nuovo modo di diagnosticare problemi.

Da qui la migrazione si collega naturalmente al supporto evolutivo: aggiornamenti continui della piattaforma richiedono dipendenze aggiornate, test di regressione automatici e un backlog gestito. Tempi e costi di una migrazione dipendono da dimensione del repository, numero di siti, integrazioni e qualità del codice di partenza, e vanno stimati dopo un assessment.

FAQ

Domande frequenti sulla migrazione AEMaaCS

Dipende da dimensione del repository, qualità del codice, integrazioni e numero di siti. Non diamo durate generiche: dopo un assessment con Best Practices Analyzer e analisi manuale è possibile stimare fasi e calendario.

Non necessariamente. Spesso è un'occasione per dismettere siti, versioni e asset non più usati. La decisione su cosa trasferire va presa prima del CTT, perché influisce su durata dei trasferimenti e costi di storage.

Estrae i contenuti dall'istanza di origine e li ingerisce nell'ambiente cloud. Si usa in più passaggi, con trasferimenti differenziali, per ridurre il tempo in cui gli editor non possono lavorare. Non sostituisce il refactoring del codice né la configurazione di Dispatcher e pipeline.

Quasi mai senza modifiche. Il cloud richiede una struttura di configurazione specifica e superare la validazione dell'SDK. Dispatcher Converter aiuta, ma la configurazione finale va rivista a mano, in particolare filtri, regole di cache e riscritture.

La data va verificata sui canali ufficiali Adobe e sul vostro contratto [VERIFICARE]. Non la citiamo come argomento commerciale: preferiamo costruire il piano su stato dell'installazione e obiettivi di business.

Pianifica la migrazione ad AEM as a Cloud Service

Condividi versione attuale, modello di hosting e dimensione del repository. Ti proponiamo un assessment pre-migrazione con perimetro e output chiari.

Richiedi un piano di migrazione