Show Menu
TÓPICOS×

Planejamento da atualização

Visão geral do projeto AEM

O AEM é usado com frequência em implantações de alto impacto que podem servir a milhões de usuários. Na maioria dos casos, existem aplicativos personalizados que são implantados nas instâncias, o que aumenta a complexidade. Qualquer esforço de atualização dessa implantação deve ser feito de forma metódica.
Este guia ajuda a estabelecer objetivos, fases e resultados ao planejar sua atualização. Centra-se na execução e orientações gerais do projeto. Embora forneça uma visão geral das etapas de atualização reais, ela se refere aos recursos técnicos disponíveis, quando adequado. Deve ser utilizado em conjugação com os recursos técnicos disponíveis referidos no documento.
O processo de atualização do AEM precisa de fases de planejamento, análise e execução cuidadosamente manipuladas com os principais resultados finais definidos para cada fase.
Observe que é possível atualizar diretamente do AEM versões 6.0 e até 6.4. Os clientes com 5.6.x ou menos precisam atualizar primeiro para a versão 6.0 ou superior, sendo recomendado o 6.0(SP3). Além disso, o novo formato OAK Segment Tar é usado agora para o Segment Node Store desde 6.3, e a migração do repositório para esse novo formato é obrigatória mesmo para 6.0, 6.1 e 6.2.
Se você estiver atualizando do AEM 6.2 para o 6.3, é necessário atualizar das versões ( 6.2-SP1-CFP1 - -6.2SP1-CFP12.1 ) ou 6.2SP1-CFP15 em diante. Caso contrário, se você estiver atualizando de 6.2SP1-CFP13/6.2SP1CFP14 para AEM 6.3, também deverá atualizar para pelo menos a versão 6.3.2.2 . Caso contrário, o AEM Sites falharia após a atualização.

Escopo e requisitos de atualização

Abaixo, você encontrará uma lista das áreas afetadas em um projeto de atualização típico do AEM:
Componente Impacto Descrição
Sistema Operacional Efeitos incertos, mas sutis No momento da atualização do AEM, talvez seja hora de atualizar o sistema operacional também e isso pode causar algum impacto.
Java Runtime Impacto moderado O AEM 6.3 requer JRE 1.7.x (64 bits) ou posterior. O JRE 1.8 é a única versão atualmente suportada pela Oracle.
Hardware Impacto moderado A Limpeza de revisão online requer espaço livre em disco igual a 25% do tamanho do repositório e 15% de espaço livre no heap para ser concluída com êxito. Talvez seja necessário atualizar seu hardware para garantir recursos suficientes para que a Limpeza de revisão online seja totalmente executada. Além disso, ao atualizar de uma versão anterior ao AEM 6, pode haver requisitos adicionais de armazenamento.
Repositório de conteúdo (CRX ou Oak) Elevado impacto A partir da versão 6.1, o AEM não oferece suporte ao CRX2, portanto, uma migração para Oak (CRX3) é necessária se você atualizar de uma versão anterior. O AEM 6.3 implementou uma nova Loja de Nó de Segmento que também exige uma migração. A ferramenta crx2oak é usada para essa finalidade.
Componentes/conteúdo do AEM Impacto moderado /libs e /apps são facilmente manipulados por meio da atualização, mas /etc geralmente exigem uma reaplicação manual das personalizações.
Serviços AEM Baixo impacto A maioria dos serviços principais do AEM é testada para atualização. Esta é uma área de baixo impacto.
Serviços de aplicativos personalizados Baixo a alto impacto Dependendo do aplicativo e da personalização, pode haver dependências em JVM, versões do sistema operacional e algumas alterações relacionadas à indexação, já que os índices não são gerados automaticamente no Oak.
Conteúdo personalizado do aplicativo Baixo a alto impacto É possível fazer backup do conteúdo que não será manipulado por meio da atualização antes que a atualização ocorra e, em seguida, ser movido de volta para o repositório. A maioria dos conteúdos pode ser feita por meio da ferramenta de migração.
É importante garantir que você esteja executando um sistema operacional suportado, Java runtime, httpd e Dispatcher version. Para obter mais informações, consulte a página Requisitos técnicos do AEM 6.4. A atualização desses componentes precisará ser contabilizada no plano do projeto e deve ocorrer antes da atualização do AEM.

Fases do projeto

Muito trabalho é feito para planejar e executar uma atualização do AEM. A fim de clarificar os diferentes esforços desenvolvidos neste processo, dividimos os exercícios de planeamento e execução em fases separadas. Nas seções abaixo, cada fase resulta em um material de entrega que geralmente é aproveitado por uma fase futura do projeto.

Planejamento para treinamento de autor

Com qualquer nova versão, há possíveis alterações na interface do usuário e nos fluxos de trabalho do usuário que podem ser introduzidas. Além disso, novas versões apresentam novos recursos que podem ser benéficos para a empresa aproveitar. Recomendamos a revisão das alterações funcionais que foram introduzidas e a organização de um plano para treinar seus usuários a aproveitá-las de forma eficaz.
Novos recursos do AEM 6.4 podem ser encontrados na seção AEM do adobe.com . Anote todas as alterações feitas nas interfaces de usuário ou nos recursos do produto que geralmente são usados em sua organização. Conforme você olha pelos novos recursos, também anote qualquer item que possa ser valioso para sua organização. Depois de examinar o que mudou no AEM 6.4, desenvolva um plano de treinamento para seus autores. Isso pode envolver o aproveitamento de recursos disponíveis gratuitamente, como vídeos de recursos helpx ou treinamento formal oferecido pelos Serviços de aprendizado digital da Adobe.

Criação de um plano de teste

A implementação do AEM por cada cliente é exclusiva e foi personalizada para atender às suas necessidades de negócios. Como resultado, é importante determinar todas as personalizações feitas no sistema para que possam ser incluídas em um plano de teste. Esse plano de teste acionará o processo de QA que executamos na instância atualizada.
O ambiente de produção exato precisa ser duplicado e os testes devem ser executados nele após a atualização para garantir que todos os aplicativos e código personalizado ainda sejam executados conforme desejado. Você precisa recuperar toda a sua personalização e executar testes de desempenho, carga e segurança. Ao organizar seu plano de teste, certifique-se de cobrir todas as personalizações feitas no sistema, além das interfaces de usuário e fluxos de trabalho prontos para uso que são aproveitados em suas operações diárias. Eles podem incluir serviços e servlets OSGI personalizados, integrações à Adobe Marketing Cloud, integrações com terceiros por meio de conectores AEM, integrações personalizadas de terceiros, componentes e modelos personalizados, sobreposições de interface personalizadas no AEM e fluxos de trabalho personalizados. Para clientes que migram de uma versão anterior ao AEM 6, quaisquer consultas personalizadas devem ser analisadas, pois podem precisar ser indexadas. Para os clientes que já estão em uma versão AEM 6.x, essas consultas ainda devem ser testadas para garantir que seus índices continuem a funcionar com eficácia após a atualização.

Determinando as mudanças de arquitetura e infraestrutura necessárias

Durante a atualização, é possível que você também precise atualizar outros componentes na pilha técnica, como o sistema operacional ou JVM. Além disso, é possível que, devido a alterações na configuração do repositório, seja necessário hardware adicional. Isso geralmente só ocorre para clientes que migram de instâncias anteriores ao 6.x, mas é importante considerar. Por fim, pode haver mudanças necessárias em suas práticas operacionais, incluindo monitoramento, manutenção e processos de backup e recuperação de desastres.
Examine os requisitos técnicos do AEM 6.4 e verifique se seu hardware e software atuais serão suficientes. Para obter possíveis alterações nos processos operacionais, consulte os seguintes documentos:
Monitorização e manutenção:
Backup/restauração e recuperação de desastres:

Considerações sobre reestruturação de conteúdo

O AEM 6.4 introduziu alterações na estrutura do repositório que ajudarão a tornar as atualizações mais simples. As alterações envolvem mover o conteúdo da pasta /etc para pastas, incluindo /libs, /apps e /content, com base no fato de a Adobe ou um cliente possuir o conteúdo, limitando assim as chances de sobrescrever o conteúdo durante as versões. A reestruturação do repositório foi feita de forma que não precisasse de alterações de código no momento da atualização do 6.4, embora seja recomendável rever os detalhes na reestruturação do repositório no AEM 6.4 enquanto planeja uma atualização.

Avaliação da complexidade da atualização

Devido à grande variedade na quantidade e na natureza das personalizações que nossos clientes aplicam aos seus ambientes AEM, é importante passar algum tempo adiantado para determinar o nível geral de esforço que deve ser esperado em sua atualização.
Existem duas abordagens que você pode adotar para avaliar a complexidade da atualização, uma fase preliminar pode apenas usar o Detector de padrão recém-introduzido que está disponível para ser executado nas instâncias do AEM 6.1, 6.2 e 6.3. O detector de padrões é a maneira mais fácil de avaliar a complexidade geral da atualização que é esperada usando padrões relatados. O relatório do detector de padrões inclui padrões para identificar APIs indisponíveis que estão em uso pela base de código personalizada (isso foi feito usando verificações de compatibilidade de pré-atualização na seção 6.3).
Após a avaliação inicial, uma etapa seguinte mais abrangente poderia ser a realização de uma atualização em uma instância de teste e a realização de alguns testes básicos de fumaça. A Adobe também fornece alguns . Além disso, a lista de Recursos removidos e obsoletos deve ser revisada não apenas para a versão para a qual você está atualizando, mas também para qualquer versão entre as versões de origem e de destino. Por exemplo, se você atualizar do AEM 6.2 para o 6.4, é importante revisar os recursos obsoletos e removidos do AEM 6.3, além dos do AEM 6.4.
O Detector de padrão introduzido na versão 6.4 deve fornecer uma estimativa bastante precisa do que esperar durante uma atualização na maioria dos casos. No entanto, para personalizações e implantações mais complexas em que você tenha alterações incompatíveis, é possível atualizar uma instância de desenvolvimento para o AEM 6.4 de acordo com as instruções em Realizar uma atualização no local. Depois de concluído, faça alguns testes de fumaça de alto nível neste ambiente. O objetivo deste exercício não é completar exaustivamente o inventário do caso de teste e produzir um inventário formal de defeitos, mas fornecer uma estimativa aproximada da quantidade de trabalho que será necessária para atualizar o código para a compatibilidade com o 6.4. Quando combinada com a Detecção de padrões e as alterações arquitetônicas que foram determinadas na seção anterior, uma estimativa aproximada pode ser fornecida à equipe de gerenciamento do projeto para planejar a atualização.

Criando o Runbook Upgrade e Rollback

Embora a Adobe tenha documentado o processo de atualização de uma instância do AEM, o layout de rede, a arquitetura de implantação e as personalizações de cada cliente exigirão o ajuste e a personalização dessa abordagem. Por esse motivo, recomendamos que você reveja toda a documentação que fornecemos e use-a para informar um runbook específico do projeto que descreve os procedimentos específicos de atualização e reversão que você seguirá em seu ambiente. Se você estiver atualizando do CRX2, certifique-se de avaliar quanto tempo a migração de conteúdo levará ao mudar do CRX2 para o Oak. Para grandes repositórios, poderia ser substancial.
Fornecemos procedimentos de atualização e reversão no procedimento de atualização, bem como instruções passo a passo para aplicar a atualização em Realizar uma atualização no local . Essas instruções devem ser analisadas e levadas em consideração com a arquitetura do sistema, as personalizações e a tolerância ao tempo de inatividade para determinar os procedimentos apropriados de alternância e reversão que você executará durante a atualização. Quaisquer alterações na arquitetura ou no tamanho do servidor devem ser incluídas ao criar seu runbook personalizado. É importante notar que este aspecto deve ser tratado como um primeiro projeto. À medida que sua equipe conclui seus ciclos de controle de qualidade e desenvolvimento e implanta a atualização para o ambiente de preparo temporário, é provável que a necessidade de algumas etapas adicionais seja necessária. Idealmente, este documento deve conter informações suficientes para que, se ele for entregue a um membro da equipe de operações, ele possa concluir a atualização completamente a partir das informações contidas nele.

Desenvolver um plano de projeto

Podemos usar o resultado dos exercícios anteriores para criar um plano de projeto que cubra os prazos esperados para nossos esforços de teste ou desenvolvimento, treinamento e execução de atualização real.
Um plano de projeto abrangente deve incluir:
  • Finalização dos planos de desenvolvimento e teste
  • Atualização dos ambientes de desenvolvimento e controle de qualidade
  • Atualização da base de código personalizada para o AEM 6.4
  • Um teste de QA e um ciclo de correção
  • Atualização do ambiente de preparo
  • Integração, desempenho e teste de carga
  • Certificação ambiental
  • Ir ao vivo

Execução do desenvolvimento e controle de qualidade

Fornecemos procedimentos para que o Código de atualização e as Personalizações sejam compatíveis com o AEM 6.4. Como esse processo iterativo é executado, as alterações devem ser feitas no runbook conforme necessário. Consulte também Compatibilidade com versões anteriores no AEM 6.4 para obter informações sobre como suas personalizações podem permanecer compatíveis com versões anteriores na maioria dos casos, sem necessidade de desenvolvimento imediatamente após a atualização.
O processo de desenvolvimento e teste costuma ser iterativo. Devido às personalizações, as alterações feitas durante a atualização podem tornar potencialmente inutilizável uma seção inteira do produto. Depois que os desenvolvedores abordarem a causa básica do problema e a equipe de teste tiver acesso para testar esses recursos, há o potencial para descobrir problemas adicionais. À medida que forem detectados problemas que exijam ajustes no processo de atualização, adicione-os ao seu runbook de atualização personalizado. Após várias iterações de teste e correção, a base de código deve ser totalmente validada e pronta para implantação no ambiente de preparo.

Teste final

Recomendamos uma rodada final de testes depois que a base de códigos tiver sido certificada pela equipe de controle de qualidade de sua organização. Esta ronda de testes envolverá a validação do runbook em um ambiente de preparo, seguido de rondas de aceitação pelo usuário, desempenho e teste de segurança.
Essa etapa é vital, pois é a única vez que você pode validar as etapas no runbook em relação a um ambiente semelhante à produção. Depois que o ambiente for atualizado, é importante permitir que os usuários finais façam logon e passem pelas atividades que fazem ao usar o sistema em suas atividades diárias. Não é raro os usuários aproveitarem uma parte do sistema que não foi considerada anteriormente. Encontrar e corrigir problemas nessas áreas antes de entrar em operação pode ajudar a evitar interrupções dispendiosas na produção. Como uma nova versão do AEM contém mudanças significativas na plataforma subjacente, também é importante executar testes de desempenho, carga e segurança no sistema como se o iniciássemos pela primeira vez.

Execução da atualização

Depois de receber o logoff final de todas as partes interessadas, é tempo de executar os procedimentos do runbook que foram definidos. Fornecemos etapas para atualização e reversão no procedimento de atualização e etapas de instalação em Realização de uma atualização Execução de uma atualização no local no local como ponto de referência.
Fornecemos algumas etapas nas instruções de atualização para a validação do ambiente. Isso inclui verificações básicas, como a verificação dos registros de atualização e verificação de que todos os pacotes OSGi foram iniciados corretamente, mas recomendamos também a validação com seus próprios casos de teste, com base nos processos de negócios. Também recomendamos verificar o cronograma da Limpeza online de revisão do AEM e as rotinas relacionadas para garantir que elas ocorrerão durante um período de silêncio para sua empresa. Essas rotinas são essenciais para o desempenho a longo prazo do AEM.