Salta al contenuto principale
Servizi

Migrare ad AEM as a Cloud Service: la checklist tecnica

Dall'assessment al go-live: cosa controllare su codice, repository, Dispatcher, contenuti e SEO quando si passa da AEM 6.x al Cloud Service.

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.json in cartelle per run mode, ad esempio config.author e config.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 8080

Fase 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 Service

Panoramica 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