Atualização de código e personalizações upgrading-code-and-customizations

Ao planejar uma atualização, as seguintes áreas de uma implementação devem ser investigadas e abordadas.

Visão geral overview

Antes de continuar com uma atualização, você deve ter uma base de código de aplicativo estável que foi totalmente testada contra o AEM 6.5 LTS.

Atualizar a base de código upgrade-code-base

Criar uma ramificação dedicada para o código LTS 6.5 no controle de versão create-a-dedicated-branch-for-6.5-lts-code-in-version-control

Todos os códigos e configurações necessários para a implementação do AEM devem ser gerenciados usando alguma forma de controle de versão. Uma ramificação dedicada no controle de versão deve ser criada para gerenciar todas as alterações necessárias à base de código na versão de destino do AEM. O teste iterativo da base de código em relação à versão de destino do AEM e correções de erros subsequentes é gerenciado nessa ramificação.

Atualizar a versão do AEM Uber Jar update-the-aem-uber-jar-version

O jar do AEM Uber inclui todas as APIs do AEM como uma única dependência no pom.xml do seu projeto Maven. É sempre uma prática recomendada incluir o Uber Jar como uma única dependência, em vez de incluir dependências individuais da API do AEM. Ao atualizar a base de código, altere a versão do Uber Jar para apontar para a versão 6.5 LTS do AEM. Atualize quaisquer APIs ou métodos obsoletos para que sejam compatíveis com a versão de destino do AEM. Recompile a base de código em relação à nova versão do Uber Jar.

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

Uber Jars para AEM 6.5

Uber Jars para AEM 6.5 LTS

Para o AEM 6.5 LTS, há novamente dois tipos de Uber Jars:

Diferença principal: AEM 6.5 vs. AEM 6.5 LTS Uber Jars

Coordenadas Maven para Jar de APIs obsoletos

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

Notas do desenvolvedor developer-notes

Procedimento de teste testing-procedure

Um plano de teste abrangente deve ser preparado para testar as atualizações. O teste da base de código e do aplicativo atualizados deve ser feito primeiro em ambientes inferiores. Quaisquer bugs encontrados devem ser corrigidos de forma iterativa até que a base de código seja estável, somente então os ambientes de nível superior devem ser atualizados.

Testando o procedimento de atualização testing-upgrade-procedure

O procedimento de atualização descrito aqui deve ser testado em ambientes de Desenvolvimento e Controle de Qualidade, conforme documentado no seu manual de execução personalizado (consulte Planejando sua atualização). O procedimento de atualização deve ser repetido até que todas as etapas sejam documentadas no livro de execução de atualização e o processo de atualização seja tranquilo.

Áreas de teste de implementação implementation-test-areas-

Abaixo estão áreas críticas de qualquer implementação do AEM que devem ser cobertas pelo seu plano de teste depois que o ambiente for atualizado e a base de código atualizada for implantada.

Documentar o plano de teste e os resultados document-test-plan-and-results

Deve ser criado um plano de teste que abranja as áreas de teste de implementação acima. Geralmente, faz sentido separar o plano de teste por Listas de tarefas Autor e Publicar. Esse plano de teste deve ser executado em ambientes de Desenvolvimento, Controle de qualidade e Preparo antes da atualização dos ambientes de Produção. Os resultados dos testes e as métricas de desempenho devem ser capturados em ambientes inferiores para fornecer comparação ao atualizar ambientes de Preparo e Produção.