Perché una checklist e non un piano generico
Migrare da AEM 6.x on-premise o Managed Services ad AEM as a Cloud Service (AEMaaCS) non è un upgrade di versione: cambia il modello di deployment, il modo di gestire configurazioni e contenuti, e il processo di rilascio. I progetti che slittano di solito lo fanno per tre motivi: codice che scrive nel repository a runtime, configurazioni di Dispatcher non compatibili e sottostima del lavoro sui contenuti. Questa bozza raccoglie i controlli che facciamo in ordine, dall'analisi al go-live. Se cerchi il servizio, trovi il perimetro completo nella pagina migrazione AEM Cloud Service; per una visione d'insieme sulle nostre competenze parti dall'hub AEM.
Le date di fine supporto delle versioni 6.x e le scadenze contrattuali vanno sempre confermate con Adobe e con il proprio account team: [VERIFICARE: date EOS AEM 6.5 e Managed Services]. In questo articolo non le riportiamo come dato.
Fase 1 · Assessment: capire cosa c'è davvero
Il primo passaggio è un inventario. Il Best Practices Analyzer (BPA) analizza un'istanza esistente e produce un report con pattern non compatibili con il Cloud Service; il Cloud Acceleration Manager mostra lo stato di readiness di contenuti e codice. Il report è un punto di partenza, non un preventivo: va letto insieme a chi conosce il progetto, perché molti avvisi sono falsi allarmi e alcuni problemi reali non emergono.
- Inventario di componenti, template, servlet, scheduler, workflow e job personalizzati.
- Elenco delle integrazioni esterne (CRM, PIM, e-commerce, SSO) e dei metodi di autenticazione usati.
- Mappa dei contenuti: volume di pagine, asset e versioni, e contenuti obsoleti da non migrare.
- Replication agent personalizzati, che nel Cloud Service non sono supportati nello stesso modo.
- Versione di Java e dipendenze del progetto Maven. [VERIFICARE: versioni Java supportate dall'SDK corrente]
Fase 2 · Refactoring del codice per il repository immutabile
In AEMaaCS le aree /apps e /libs sono immutabili a runtime: il codice si distribuisce solo tramite pipeline di Cloud Manager. I contenuti e le configurazioni modificabili vivono in /content, /conf, /var e /home. Ogni punto in cui il codice o un utente scrive in /apps va riprogettato.
Gli strumenti di Adobe (Repository Modernizer, AEM Project Archetype aggiornato) aiutano a separare il progetto in pacchetti ui.apps, ui.config, ui.content e all. Il lavoro vero è decidere cosa è codice, cosa è configurazione e cosa è contenuto.
- Configurazioni OSGi: da file
.cfg.jsonin cartelle per run mode, ad esempioconfig.authoreconfig.publish, senza console web in produzione. - Segreti e URL ambiente: da variabili di ambiente di Cloud Manager, non nei file del repository.
- Indici Oak personalizzati: da definire nel codice e rispettare le convenzioni di nome del Cloud Service.
- Workflow di tipo DAM Update Asset: da valutare contro Asset Compute e i processing profile.
- Scheduler e job: da verificare su ambienti con più istanze, dove un job può girare in parallelo.
Fase 3 · Dispatcher e CDN
La configurazione del Dispatcher nel Cloud Service segue una struttura precisa e viene validata a ogni build. Le configurazioni scritte per 6.x raramente passano così come sono. Lo strumento Dispatcher Converter produce una prima versione, ma va rivista a mano, soprattutto su filtri, regole di rewrite e header. I dettagli su regole e cache sono nell'articolo configurare il Dispatcher AEM.
Nel Cloud Service davanti al Dispatcher c'è una CDN gestita: va deciso se usarla direttamente o metterne una propria davanti. Questo cambia come si gestiscono purge, certificati, WAF e header.
# Validazione locale della configurazione Dispatcher
# (con gli strumenti Dispatcher dell'AEM SDK)
./bin/validate.sh./dispatcher/src
# Prova in locale con il Dispatcher in container
./bin/docker_run.sh./dispatcher/src host.docker.internal:4503 8080Fase 4 · Migrazione dei contenuti
Il Content Transfer Tool (CTT) sposta contenuti e utenti dall'istanza di origine al Cloud Service in due modalità: estrazione completa e aggiunta incrementale (top-up). In un progetto reale si fanno più passaggi: una prima estrazione per validare tempi e problemi, poi top-up fino al go-live, con un content freeze breve e pianificato.
Prima di migrare conviene pulire: versioni accumulate, asset duplicati, pagine non più usate, workflow terminati. Un repository più piccolo riduce tempi di trasferimento e di indicizzazione. Per i siti con molti asset, valutate in anticipo l'impatto su Dynamic Media e sui rendition.
Fase 5 · Pipeline, test e SEO
Cloud Manager esegue controlli di qualità del codice, di sicurezza e di performance a ogni deploy, e può bloccare il rilascio. Meglio scoprire i blocchi nelle prime settimane che il giorno prima del go-live. Costruite almeno un ambiente di stage con contenuti realistici e usate test funzionali e di carico prima del taglio.
Il lato SEO è quello più trascurato. Se cambiano URL, struttura o dominio, serve una mappa di redirect completa, il controllo di canonical, sitemap e hreflang, e un monitoraggio di Search Console dopo il lancio. Le prestazioni vanno confrontate prima e dopo: vedi Core Web Vitals su AEM.
Checklist sintetica
- Report BPA e Cloud Acceleration Manager analizzati e discussi con il team.
- Inventario di integrazioni, workflow e job personalizzati completato.
- Progetto Maven separato in pacchetti per codice, configurazioni e contenuti.
- Configurazioni OSGi per run mode e variabili di ambiente al posto di valori fissi.
- Dispatcher convertito, validato in locale e rivisto a mano.
- Strategia CDN decisa: CDN gestita o CDN del cliente davanti.
- Almeno due passaggi del Content Transfer Tool prima del go-live.
- Pipeline di Cloud Manager verde su stage, con test di carico.
- Piano di redirect, canonical e monitoraggio SEO pronto.
- Piano di rollback e finestra di content freeze concordati.
Servizio correlato
Migrazione ad AEM as a Cloud ServicePanoramica di tutte le competenze: consulenza Adobe Experience Manager.
Stai pianificando una migrazione AEM?
Raccontaci versione attuale, volume di contenuti e integrazioni: ti proponiamo un assessment con un piano di lavoro per fasi.
Richiedi un assessment