Aggiornamento del codice e delle personalizzazioni upgrading-code-and-customizations

Durante la pianificazione di un aggiornamento, è necessario esaminare e risolvere le seguenti aree di un’implementazione.

Panoramica overview

Prima di procedere con un aggiornamento, è necessario disporre di una base di codice dell'applicazione stabile che sia stata testata accuratamente rispetto a AEM 6.5 LTS.

Aggiorna base codice upgrade-code-base

Creazione di un ramo dedicato per il codice LTS 6.5 nel controllo della versione create-a-dedicated-branch-for-6.5-lts-code-in-version-control

Tutto il codice e le configurazioni necessari per l’implementazione di AEM devono essere gestiti utilizzando una qualche forma di controllo della versione. È necessario creare un ramo dedicato nel controllo della versione per gestire tutte le modifiche necessarie per la base di codice nella versione di destinazione di AEM. In questo ramo vengono gestiti i test iterativi della base di codice rispetto alla versione di destinazione di AEM e le successive correzioni di bug.

Aggiornare la versione di AEM Uber Jar update-the-aem-uber-jar-version

Il file jar di AEM Uber include tutte le API di AEM come una singola dipendenza in pom.xml del progetto Maven. È sempre consigliabile includere il file JAR Uber come una singola dipendenza invece di includere singole dipendenze API di AEM. Durante l’aggiornamento della base di codice, modifica la versione del Jar Uber in modo che punti alla versione 6.5 LTS di AEM. Aggiorna eventuali API o metodi obsoleti in modo che siano compatibili con la versione di destinazione di AEM. Ricompila la base di codice rispetto alla nuova versione del file JAR Uber.

<dependency>
    <groupId>com.adobe.aem</groupId>
    <artifactId>uber-jar</artifactId>
    <version>6.6.0</version>
    <classifier>apis</classifier>
    <scope>provided</scope>
</dependency>

JAR Uber per AEM 6.5

JAR Uber per AEM 6.5 LTS

Per AEM 6.5 LTS, esistono ancora due tipi di file JAR Uber:

Differenza chiave: AEM 6.5 rispetto ad AEM 6.5 LTS Uber Jars

Coordinate Maven per Jar API obsolete

<dependency>
    <groupId>com.adobe.aem</groupId>
    <artifactId>uber-jar</artifactId>
    <version>6.6.0</version>
    <classifier>deprecated-apis</classifier>
    <scope>provided</scope>
</dependency>

Note per sviluppatori developer-notes

Procedura di prova testing-procedure

Per testare gli aggiornamenti è necessario preparare un piano di test completo. Il test della base di codice e dell’applicazione aggiornate deve essere eseguito prima in ambienti inferiori. Eventuali bug trovati devono essere corretti in modo iterativo fino a quando la base di codice non è stabile, solo in questo caso gli ambienti di livello superiore dovrebbero essere aggiornati.

Verifica della procedura di aggiornamento testing-upgrade-procedure

La procedura di aggiornamento qui descritta deve essere testata in ambienti di sviluppo e controllo qualità come documentato nel manuale di esecuzione personalizzato (vedi Pianificazione dell'aggiornamento). La procedura di aggiornamento deve essere ripetuta fino a quando tutti i passaggi non sono documentati nel registro di esecuzione dell'aggiornamento e il processo di aggiornamento non è graduale.

Aree di prova dell’implementazione implementation-test-areas-

Di seguito sono riportate le aree critiche di qualsiasi implementazione di AEM che devono essere coperte dal piano di test dopo l’aggiornamento dell’ambiente e la distribuzione della base di codice aggiornata.

Documenta piano di test e risultati document-test-plan-and-results

È necessario creare un piano di test che copra le aree di test di implementazione di cui sopra. Spesso è utile separare il piano di test dagli elenchi delle attività Autore e Pubblica. Questo piano di test deve essere eseguito sugli ambienti di sviluppo, controllo qualità e staging prima dell’aggiornamento degli ambienti di produzione. I risultati dei test e le metriche delle prestazioni devono essere acquisiti in ambienti inferiori per fornire confronti durante l’aggiornamento degli ambienti di staging e produzione.