Fase di implementazione implementation-phase
Nella fase di implementazione del percorso, esplorerai gli strumenti attraverso i quali puoi rendere il codice e il contenuto pronti per essere spostati su AEM as a Cloud Service.
Percorso affrontato finora story-so-far
Nelle parti precedenti del percorso, sei passato attraverso la conoscenza delle modifiche in AEM as a Cloud Service e hai stabilito se la tua distribuzione è pronta per essere spostata nel cloud con la fase di preparazione.
Questo articolo continua con consigli su come utilizzare gli strumenti forniti da Adobe per assicurarsi che il codice e il contenuto siano pronti per essere spostati nel cloud.
Obiettivo objective
Il presente documento si prefigge di:
- Presenta Cloud Manager, il framework di integrazione e consegna continua dell’AEM utilizzato per distribuire il codice in AEM as a Cloud Service
- Scopri come usare lo strumento per il trasferimento dei contenuti
- Descrivi gli strumenti di refactoring del codice da utilizzare per modernizzare il codice per AEM as a Cloud Service
Utilizzo di Cloud Manager using-cloud-manager
Prima di iniziare, devi acquisire familiarità con Cloud Manager, in quanto è l’unico meccanismo per distribuire il codice in AEM as a Cloud Service.
Cloud Manager consente alle organizzazioni di gestire autonomamente AEM nel cloud. Include un framework di integrazione continua e distribuzione continua (CI/CD, Continuous Integration/Continuous Delivery) che consente ai team IT e ai partner dell’implementazione di accelerare la distribuzione di personalizzazioni o aggiornamenti senza compromettere prestazioni o sicurezza.
Per acquisire familiarità con l’utilizzo di Cloud Manager, consulta le risorse seguenti:
-
Percorso di onboarding per comprendere le risorse di supporto autonomo sull'onboarding, ad Experience Manager l'as a Cloud Service.
-
Integrazione di Git con Adobe Cloud Manager per informazioni sull’utilizzo di un archivio Git singolo per implementare il codice.
-
Configurazione di Adobe Experience as a Cloud Service per informazioni sulla gestione dei prodotti e dell’accesso degli utenti in Admin Console.
Utilizza l’Adobe fornito di strumenti per rendere pronti i contenuti e Code Cloud use-tools-to-make-code-and-content-cloud-ready
I passaggi esatti della transizione al Cloud Service dipendono dai sistemi acquistati e dalle procedure di sviluppo software seguite.
La figura seguente mostra i passaggi principali della fase che comporta la conversione del codice e del contenuto per l’utilizzo con AEM as a Cloud Service:
Inizieremo a specificare gli strumenti da utilizzare per ottenere questo risultato nei capitoli seguenti.
Migrazione dei contenuti content-migration
Per migrare il contenuto dall’istanza AEM corrente all’istanza di Cloud Service, puoi utilizzare lo strumento Content Transfer (Trasferimento contenuti) di Adobe.
Con questo strumento, puoi specificare il sottoinsieme di contenuti che desideri trasferire dall’istanza AEM sorgente all’istanza AEM Cloud Service.
La migrazione dei contenuti è un processo in più fasi che richiede pianificazione, tracciamento e collaborazione tra team diversi.
Per informazioni dettagliate sul funzionamento dello strumento e sulle modalità di utilizzo consigliate dall'Adobe, vedere la documentazione dello strumento Content Transfer.
Refactoring del codice code-refactor
Configurazione per lo sviluppo set-up-for-development
È ora di iniziare a rieseguire il factoring delle funzioni esistenti per renderle compatibili con i Cloud Service.
Per prima cosa, consulta la documentazione che descrive gli strumenti di base e inizia a rieseguire il factoring del codice:
- Durante la pianificazione, è consigliabile disporre di un elenco di aree che devono essere reimpostate per essere compatibili con AEM as a Cloud Service. Puoi consultare le Linee guida per lo sviluppo per ulteriori dettagli su come eseguire il refactoring del codice e ottimizzarlo per il Cloud Service.
- Scopri come gestire le configurazioni in AEM as a Cloud Service.
- Scopri come impostare un ambiente di sviluppo locale scaricando l'SDK per AEM as a Cloud Service
- Infine, acquisisci familiarità con API Java di AEM as a Cloud Service.
Inoltre, puoi anche:
-
Guarda questo video per comprendere come installare localmente l’SDK di Dispatcher:
embed -
Guarda questo video per comprendere come configurare l’SDK per Dispatcher:
embed
Un cambio di mentalità a-change-in-mindset
Lo sviluppo e l’esecuzione del codice in AEM as a Cloud Service richiedono un cambiamento di mentalità. Il codice deve essere resiliente, soprattutto poiché un’istanza potrebbe essere arrestata in qualsiasi momento. Il codice in esecuzione in Cloud Service deve tener conto di essere sempre in esecuzione in un cluster. Ciò significa che ci sono sempre in esecuzione più di un’istanza.
Per rendere i progetti AEM Maven compatibili con il cloud sono necessarie alcune modifiche. AEM as a Cloud Service richiede una separazione di content e code in pacchetti distinti per la distribuzione nell'AEM:
-
/appse/libssono considerate aree immutabili dell'AEM in quanto non possono essere modificate dopo l'avvio dell'AEM (ovvero in fase di runtime). Ciò include le operazioni di creazione, aggiornamento o eliminazione. Eventuali tentativi di modifica di un’area immutabile in fase di runtime avranno esito negativo. -
Tutte le altre aree del repository (ad esempio,
/content,/conf,/var,/home,/etc,/oak:index,/system,/tmp) sono mutabili, il che significa che possono essere modificate in fase di esecuzione.
Per ulteriori informazioni, consulta la documentazione sulla struttura consigliata dei pacchetti.
Strumenti di migrazione per cloud cloud-migration-tools
Adobe fornisce diversi strumenti per accelerare alcune delle attività di refactoring del codice. Comprendere questi strumenti e i problemi che risolvono ridurrà la complessità e i tempi della migrazione.
- Migrazione dei flussi di lavoro delle risorse, uno strumento utilizzato per migrare automaticamente i flussi di lavoro di elaborazione delle risorse
- Dispatcher Converter, uno strumento che converte le configurazioni esistenti di Dispatcher in un formato pronto per AEM as a Cloud Service.
- Repository Modernizer, uno strumento che accetta un progetto multimodale AEM come input e lo converte in un progetto AEM as a Cloud Service
- Convertitore indice, uno strumento che converte gli indici in un modulo compatibile con AEM as a Cloud Service
- Strumenti di modernizzazione, una suite di utilità che può essere utilizzata per convertire le funzionalità legacy dell'AEM nelle funzionalità moderne e supportate di AEM as a Cloud Service.
Dopo aver configurato l'ambiente di sviluppo locale, acquisisci familiarità con l'SDK di AEM as a Cloud Service consultando la documentazione.
Pianificare un blocco del codice schedule-a-code-freeze
Per gestire lo sviluppo del codice in corso sull’AEM attivo insieme alle attività di refactoring del codice come parte del percorso di transizione, Adobe consiglia di pianificare un periodo di blocco del codice fino a quando non avrai completato la ristrutturazione del progetto Maven per renderlo compatibile con AEM as a Cloud Service.
Al termine della ristrutturazione del progetto, puoi riprendere lo sviluppo del nuovo codice in base a questa nuova struttura. Questo riduce gli errori della pipeline Cloud Manager durante la distribuzione e il test del codice.
Best practice per l’implementazione e il test del codice best-practices
La pipeline di Cloud Manager supporta l’esecuzione di test nell’ambiente di staging.
Segui le best practice riportate nei documenti seguenti relativi al test della qualità del codice:
- Test di qualità del codice, un documento che descrive il processo di scrittura degli script di test e spiega il concetto di copertura consigliata di almeno il 50%.
- Regole per la qualità del codice personalizzato che descrive le regole per la qualità del codice personalizzato eseguite da Cloud Manager e create in base alle best practice indicate dal team ingegneristico dell'AEM.
Preparazione per il lancio preparing-for-go-live
La preparazione del sistema di origine per la migrazione prevede attività a livello di sistema e di amministratore AEM. Puoi iniziare verificando che l'archivio dei contenuti sia in uno stato di manutenzione corretto controllando lo stato dell'attività pulizia revisioni e raccolta di oggetti inattivi dell'archivio dati. Se esegui la versione 6.3 dell’AEM (poiché lo strumento Content Transfer (Trasferimento contenuti) è compatibile dalla versione 6.3 in poi), si consiglia di eseguire la compattazione offline, seguita dalla raccolta di oggetti inattivi dell’archivio dati.
La verifica di coerenza dei dati è consigliata in tutte le versioni AEM per garantire che l'archivio dei contenuti sia in buono stato per avviare le attività di migrazione.
Per installare e configurare AZCopy è necessario disporre dell'accesso a livello di amministratore di sistema
È inoltre consigliabile rivedere eventuali Assets, pagine, progetti AEM, utenti e gruppi inutilizzati per risparmiare tempo durante la migrazione. Consulta la sezione Integrità dell'archivio dei contenuti.
Integrità archivio contenuti repository-health
Una volta stabilito l'accesso a un clone di produzione, procedere con la verifica dello stato dell'archivio. Come indicato nella sezione precedente, l’obiettivo è pulire e compattare l’archivio sull’origine prima di avviare la migrazione. Questo passaggio potrebbe risparmiare molto tempo altrimenti, una volta avviata la migrazione, si occuperà della risoluzione dei problemi.
Raccolta dei dati gathering-data
La raccolta dei dati può essere utile per pianificare le attività di migrazione e le attività associate. I tempi di estrazione e di acquisizione sono particolarmente utili perché i punti dati possono essere associati a una dimensione specifica del set di migrazione. Di conseguenza, questi punti di dati possono essere estrapolati per ottenere un piano:
- Tempo totale impiegato per estrazione
- Tempo totale impiegato per l'acquisizione
- Tempo totale impiegato per estrazione integrativa
- Tempo totale impiegato per l'acquisizione integrativa di 🔗
Questi punti dati possono inoltre essere utili per stabilire i KPI e altre attività correlate alla migrazione.
Piano di migrazione migration-plan
In base ai punti dati raccolti (vedere sopra), è possibile creare un piano di migrazione che può essere integrato in un piano di progetto macro. Questo passaggio consentirà a tutte le principali parti interessate di visualizzare e pianificare le attività di migrazione.
Nella tabella seguente viene illustrato un tipico piano di migrazione:
Come illustrato nella tabella precedente, è utile seguire un formato di denominazione specifico per identificare le iterazioni di migrazione, ad esempio: PRDCLONE per l'ambiente AEM di origine, AUTHOR/PUBLISH per l'ambiente AEM as a Cloud Service, CSSTAGE-AUTHOR per l'istanza AEM as a Cloud Service e così via.
Alcuni dettagli importanti che influenzano il piano di migrazione:
Numero totale di estrazioni richieste
- Le estrazioni di authoring e Publish in ambienti specifici sono considerate due estrazioni parallele in quanto sono indipendenti l’una dall’altra.
- Numero di estrazioni integrative basate sulla crescita dell’archivio in periodi di tempo specifici.
Numero totale di acquisizioni richieste
- È importante acquisire questo elemento nel piano, poiché un set estratto può essere acquisito in più ambienti di Cloud Service.
- Numero di acquisizioni integrative.
- La migrazione del contenuto dall’istanza di authoring di Source all’istanza di authoring di Cloud Service e da Source Publish a Publish di Cloud Service è la best practice per evitare di acquisire tutti i contenuti di authoring nel Publish di Cloud Service.
Tracciamento migrazione migration-tracker
Puoi utilizzare il tracciatore della migrazione per annotare i tempi sia per le esecuzioni iniziali che per quelle integrative. Questi punti dati ti aiuteranno a formulare requisiti realistici di blocco dei contenuti prima dell’integrazione finale.
Il tracker ti aiuterà anche a:
- Identifica eventuali deviazioni dal planner che richiedono adeguamenti nei timeline del piano o del lancio
- Fornire uno stato realistico che possa essere utilizzato in tutte le comunicazioni necessarie
- Pianificare migrazioni di backup iniziali o future
La tabella seguente illustra un tracker di migrazione funzionale:
Strategia e tempistica di migrazione dei contenuti content-strategyand-timeline
Nella sezione seguente sono illustrati i passaggi importanti e le attività associate che è possibile utilizzare per formulare una strategia e una tempistica di migrazione dei contenuti.
Filtraggio fitment
-
Eseguire la pulizia delle revisioni, la raccolta di oggetti inattivi dell’archivio dati e i controlli di coerenza dei dati. Vedi anche Preparazione per il lancio
-
Raccogli statistiche sull'archivio di origine AEM:
- Dimensione archivio segmenti
- Dimensione archivio indice
- Numero di pagine
- Numero di risorse
- Numero di utenti e gruppi
-
Scopri se le seguenti funzioni sono abilitate nell’origine dell’AEM (necessaria anche in AEM as a Cloud Service):
- Applicazione di tag avanzati
- Ricerca per affinità
- Cerca il testo che contiene nei documenti Word e Pdf
-
Raccogli il report Best Practice Analyzer
-
Importa in Cloud Acceleration Manager
- Rivedi i consigli di analisi automatica per assicurarti che AEM as a Cloud Service possa gestire i requisiti di storage.
-
Crea un ticket di supporto Adobe per eventuali chiarimenti prima di continuare con il piano di migrazione.
Prova della migrazione proof-of-migration
-
Richiedi un clone di produzione che:
- Si trova nella stessa area di rete
- Fornirà contenuti di produzione come utenti e gruppi
- Cloni authoring e pubblicazione: un nodo ciascuno in caso di cluster o farm di pubblicazione
-
Scegli un sottoinsieme del contenuto di cui eseguire la migrazione in modo che:
- È una combinazione di tutti i tipi di contenuto disponibili
- Contiene tutti gli utenti e i gruppi
-
Include il 25% del contenuto o fino a 1 TB, a seconda di quale dei due valori è minore.
-
Esegui almeno una migrazione completa e integrativa dal clone di produzione all'ambiente non di produzione AEM as a Cloud Service
-
Risolvi eventuali problemi come:
- Spazio su disco nell'origine AEM
- Connettività tra la sorgente dell’AEM e AEM as a Cloud Service
- Qualsiasi limitazione relativa all'acquisizione.
-
Registra il tempo impiegato per l'estrazione e l'acquisizione:
- Conoscere la quantità di contenuti aggiunti alla settimana
- Estrapolare i tempi misurati dalla bozza di migrazione per creare un piano di migrazione.
Passaggio successivo what-is-next
Dopo aver compreso appieno come valutare se l'installazione dell'AEM è pronta per essere spostata sul cloud, mentre impariamo a utilizzare gli strumenti necessari per prepararla, è ora di passare alla fase di pubblicazione.