Fase de implementação implementation-phase
Na fase de implementação da jornada, você explorará as ferramentas através das quais pode preparar seu código e conteúdo para serem transferidos para o AEM as a Cloud Service.
A história até agora story-so-far
Nas partes anteriores da jornada, você passou por familiarizando-se com as alterações no AEM as a Cloud Service e determinou se a implantação está pronta para ser movida para a nuvem na fase de preparação.
Este artigo continua com conselhos sobre como usar as ferramentas fornecidas pelo Adobe para garantir que seu código e conteúdo estejam prontos para serem movidos para a nuvem.
Objetivo objective
Este documento tem como objetivo:
- Apresentar o Cloud Manager, integração contínua do AEM e estrutura de entrega usada para implantar código no AEM as a Cloud Service
- Atualize-se com a ferramenta de transferência de conteúdo
- Descreva as ferramentas de refatoração de código que você precisa usar para modernizar seu código para o AEM as a Cloud Service
Utilização do Cloud Manager using-cloud-manager
Antes de começar, você deve se familiarizar com o Cloud Manager, pois ele é o único mecanismo para implantar código no AEM as a Cloud Service.
O Cloud Manager permite que as organizações gerenciem automaticamente o AEM na Nuvem. Inclui uma estrutura de integração contínua e entrega contínua (CI/CD) que permite que as equipes de TI e os parceiros de implementação acelerem a entrega de personalizações ou atualizações, sem comprometer o desempenho ou a segurança.
Você pode se familiarizar com o uso do Cloud Manager consultando os recursos abaixo:
-
Jornada de integração para entender os recursos de autoajuda sobre integração do Experience Manager as a Cloud Service.
-
Integração do Git com o Adobe Cloud Manager para saber mais sobre o uso de um único repositório Git para implantar código.
-
Configuração do Adobe Experience as a Cloud Service para saber mais sobre como gerenciar produtos e o acesso dos usuários no Admin Console.
Use as ferramentas fornecidas pelo Adobe para preparar seu conteúdo e código para a nuvem use-tools-to-make-code-and-content-cloud-ready
As etapas exatas da sua transição para o Cloud Service dependem dos sistemas que você adquiriu e das práticas de ciclo de vida de desenvolvimento de software seguidas.
A figura a seguir mostra as principais etapas envolvidas na fase que envolve a conversão de código e conteúdo para uso com o AEM as a Cloud Service:
Começaremos a detalhar as ferramentas que você deve usar para fazer isso nos capítulos abaixo.
Migração de conteúdo content-migration
Para migrar o conteúdo da instância de AEM atual para a instância de Cloud Service, use a Ferramenta de transferência de conteúdo do Adobe.
Com essa ferramenta, você pode especificar o subconjunto de conteúdo desejado que deseja transferir da instância de origem do AEM para a instância do AEM Cloud Service.
A migração de conteúdo é um processo de várias etapas que requer planejamento, rastreamento e colaboração entre equipes diferentes.
Para obter detalhes completos sobre como a ferramenta funciona e como o Adobe recomenda que você a use, consulte a documentação da Ferramenta de transferência de conteúdo.
Refatoração de código code-refactor
Configurar para desenvolvimento set-up-for-development
É hora de começar a refatorar os recursos existentes para serem compatíveis com o Cloud Service.
Primeiro, observe a documentação que detalha as ferramentas básicas e comece a refatorar seu código:
- Durante o planejamento, é uma boa ideia ter uma lista de áreas que devem ser refatoradas para serem compatíveis com o AEM as a Cloud Service. Você pode rever as Diretrizes de desenvolvimento para obter mais detalhes sobre como refatorar e otimizar o código para o Cloud Service.
- Leia sobre como Gerenciar configurações no AEM as a Cloud Service.
- Saiba como configurar um Ambiente de Desenvolvimento Local baixando o SDK do AEM as a Cloud Service
- Por fim, familiarize-se com a API Java do AEM as a Cloud Service.
Além disso, também é possível:
-
Assista a este vídeo para entender como instalar o SDK do Dispatcher localmente:
embed -
Assista a este vídeo para entender como configurar o SDK do Dispatcher:
embed
Uma mudança de mentalidade a-change-in-mindset
O desenvolvimento e a execução de código no AEM as a Cloud Service requer uma mudança de mentalidade. Vale lembrar que o código deve ser resiliente, especialmente porque uma instância pode ser interrompida a qualquer momento. O código em execução no Cloud Service deve reconhecer o fato de que ele está sempre em execução em um cluster. Isso significa que sempre há mais de uma instância em execução.
Certas alterações são necessárias para que os projetos AEM Maven sejam compatíveis com a nuvem. O AEM as a Cloud Service requer uma separação de conteúdo e código em pacotes distintos para implantação no AEM:
-
/appse/libssão consideradas áreas imutáveis do AEM, pois não podem ser alteradas após o início do AEM (ou seja, em tempo de execução). Isso inclui operações de criação, atualização ou exclusão. Qualquer tentativa de alterar uma área imutável no tempo de execução falhará. -
Todo o restante no repositório (por exemplo,
/content,/conf,/var,/home,/etc,/oak:index,/system,/tmp) são áreas mutáveis, o que significa que podem ser alteradas em tempo de execução.
Você pode saber mais consultando a documentação Estrutura de pacote recomendada.
Ferramentas de migração na nuvem cloud-migration-tools
O Adobe fornece várias ferramentas para ajudar a acelerar algumas de suas tarefas de refatoração de código. Compreender essas ferramentas e os problemas que elas resolvem reduzirá a complexidade da migração e o tempo.
- Migração de fluxo de trabalho de ativos, uma ferramenta usada para migrar automaticamente fluxos de trabalho de processamento de ativos
- O Dispatcher Converter, uma ferramenta que converte as configurações existentes do Dispatcher em um formato pronto para o AEM as a Cloud Service.
- Modernizador de repositório, uma ferramenta que usa um projeto AEM Multimode como entrada e o converte em um AEM as a Cloud Service
- Conversor de Índice, uma ferramenta que converte índices em um formulário compatível com o AEM as a Cloud Service
- Ferramentas de Modernização, um conjunto de utilitários que podem ser usados para converter recursos herdados do AEM para os recursos modernos e compatíveis do AEM as a Cloud Service.
Depois de configurar o ambiente de desenvolvimento local, familiarize-se com o SDK do AEM as a Cloud Service consultando a documentação.
Programar um congelamento do código schedule-a-code-freeze
Para gerenciar o desenvolvimento contínuo do código no AEM ativo, juntamente com as tarefas de refatoração de código como parte da jornada de transição, a Adobe recomenda que você programe um período de congelamento do código até concluir a reestruturação do projeto Maven para que ele seja compatível com o AEM as a Cloud Service.
Quando a reestruturação do projeto estiver concluída, você poderá retomar o desenvolvimento de novos códigos com base nessa nova estrutura. Isso reduz as falhas de pipeline do Cloud Manager durante os testes e a implantação do código.
Práticas recomendadas para testes e implantação do código best-practices
O pipeline do Cloud Manager oferece suporte à execução de testes que são executados no ambiente de preparo.
Siga as práticas recomendadas nos documentos abaixo relacionados ao teste de qualidade do código:
- Teste de Qualidade do Código, um documento que descreve o processo de gravação de scripts de teste e explica o conceito de cobertura recomendada de pelo menos 50%.
- Noções básicas das regras de qualidade do código personalizado, que tem como objetivo descrever as regras de qualidade do código personalizado executadas pela Cloud Manager e criadas com base nas práticas recomendadas da engenharia de AEM.
Preparação para ativação preparing-for-go-live
A preparação do sistema de origem para migração envolve tarefas no nível do administrador do sistema e do AEM. Você pode começar verificando se o repositório de conteúdo está em um estado bem mantido verificando o status da tarefa limpeza de revisão e a coleta de lixo de armazenamento de dados. Se você estiver executando a versão 6.3 do AEM (já que a ferramenta Transferência de conteúdo é compatível da versão 6.3 em diante), é recomendável executar a compactação offline, seguida da coleta de Lixo do Data Store.
A verificação de consistência de dados é recomendada em todas as versões do AEM para garantir que o repositório de conteúdo esteja em bom estado para iniciar as atividades de migração.
É necessário acesso em nível de administrador do sistema para instalar e configurar o AZCopy
Também é recomendável revisar qualquer Assets, Páginas, Projetos AEM, Usuários e Grupos não utilizados para economizar tempo na migração. Consulte a seção Integridade do Repositório de Conteúdo.
Integridade do repositório de conteúdo repository-health
Uma vez estabelecido o acesso a um clone de produção, prossiga para verificar a integridade do repositório. Como mencionado na seção anterior, o objetivo é limpar e compactar o repositório na origem antes de iniciar a migração. Essa etapa possivelmente economizará muito tempo, caso contrário, gastará na solução de problemas assim que a migração começar.
Coletando dados gathering-data
A coleta de dados pode ajudar você a planejar as atividades de migração e as tarefas associadas. Os tempos de extração e assimilação são especialmente úteis porque os pontos de dados podem ser associados a um tamanho específico do conjunto de migração. Dessa forma, esses pontos de dados podem ser extrapolados para criar um plano:
- Tempo total necessário para extração
- Total de tempo gasto para assimilação
- Tempo total necessário para a extração complementar
- Quantidade total de tempo gasto para a assimilação complementar
Esses pontos de dados também podem ajudar você a Estabelecer KPIs e outras tarefas relacionadas à migração.
Plano de migração migration-plan
Com base nos pontos de dados coletados (veja acima), é possível criar um plano de migração que possa ser integrado a um plano de projeto de macro. Esta etapa permitirá que todas as principais partes interessadas visualizem e planejem as atividades de migração.
A tabela a seguir ilustra um plano de migração típico:
Como você pode ver na tabela acima, é útil seguir um formato de nomenclatura específico para identificar as iterações de migração, por exemplo: PRDCLONE para o ambiente AEM de origem, AUTHOR/PUBLISH para o ambiente AEM as a Cloud Service, CSSTAGE-AUTHOR para a instância do AEM as a Cloud Service e assim por diante.
Alguns detalhes importantes que influenciam seu plano de migração:
O Número Total de Extrações necessárias
- As extrações de autor e Publish em ambientes específicos são consideradas como duas extrações paralelas, pois são independentes umas das outras.
- Número de extrações complementares com base no crescimento do repositório em períodos específicos.
Número total de assimilações necessárias
- É importante capturar esse item no plano, pois um conjunto extraído pode ser assimilado em vários ambientes de Cloud Service.
- Número de assimilações complementares.
- A migração de conteúdo do autor do Source para a instância do autor do Cloud Service e do Source Publish para o Cloud Service Publish é a prática recomendada para evitar a assimilação de todo o conteúdo do autor no Cloud Service Publish.
Rastreador de migração migration-tracker
Você pode usar o rastreador de migração para anotar os horários das execuções iniciais e complementares. Esses pontos de dados ajudarão você a formular requisitos realistas de congelamento de conteúdo antes do acréscimo final.
O rastreador também ajudará você a:
- Identificar quaisquer desvios do planejador que requeiram ajustes no plano ou nos cronogramas de ativação
- Fornecer um status realista que possa ser usado em todas as comunicações necessárias
- Planejar migrações complementares iniciais ou futuras
A tabela a seguir ilustra um rastreador de migração funcional:
Estratégia e cronograma de migração de conteúdo content-strategyand-timeline
A seção a seguir mostra as etapas importantes e as tarefas associadas que podem ser usadas para formular uma estratégia de migração de conteúdo e uma linha do tempo.
Ajuste fitment
-
Execute a limpeza de revisão, a coleta de lixo do armazenamento de dados e as verificações de consistência de dados. Consulte também Preparação para ativação
-
Colete estatísticas sobre o repositório de origem do AEM:
- Tamanho do armazenamento de segmentos
- Tamanho do armazenamento de índice
- Número de páginas
- Número de ativos
- Número de usuários e grupos
-
Saber se os seguintes recursos estão ativados na fonte do AEM (também obrigatório no AEM as a Cloud Service):
- Marcação inteligente
- Pesquisa de semelhança
- Pesquisar por conter texto em documentos word e pdf
-
Coletar o relatório do Analisador de Práticas Recomendadas
-
Importar para o Cloud Acceleration Manager
- Revise a recomendação de autoanálise para garantir que a AEM as a Cloud Service possa lidar com os requisitos de armazenamento.
-
Crie um tíquete de Suporte Adobe para quaisquer esclarecimentos antes de continuar com o plano de migração.
Prova de migração proof-of-migration
-
Solicite um clone de produção que:
- Está na mesma zona de rede
- Fornecerá conteúdo de produção como usuários e grupos
- Clona o autor e a publicação — um nó cada no caso de um cluster ou farm de publicação
-
Escolha um subconjunto do conteúdo que é migrado para que:
- É uma combinação de todos os tipos de conteúdo disponíveis
- Contém todos os usuários e grupos
-
Inclui 25% do conteúdo ou até 1 TB, o que for menor.
-
Execute pelo menos uma migração completa e complementar, do clone de produção para o ambiente de não produção do AEM as a Cloud Service
-
Resolva possíveis problemas como:
- Espaço em disco na origem do AEM
- Conectividade entre a fonte AEM e o AEM as a Cloud Service
- Quaisquer limitações relacionadas à assimilação.
-
Registre o tempo gasto para extração e assimilação:
- Saber quanto conteúdo é adicionado por semana
- Expanda os tempos medidos na prova de migração para criar um plano de migração.
O que vem a seguir what-is-next
Depois que você entender completamente como avaliar se a instalação do AEM está pronta para ser movida para a nuvem, à medida que aprendemos a usar as ferramentas necessárias para torná-la pronta, é hora de seguir para a fase de ativação.