Assimilar conteúdo no Cloud Service

Processo de assimilação no Cloud Acceleration Manager

Siga as etapas abaixo para assimilar seu conjunto de migração usando o Cloud Acceleration Manager:

OBSERVAÇÃO

Você se lembrou de registrar um tíquete de suporte para esta assimilação? Consulte Considerações importantes antes de usar a ferramenta Transferência de conteúdo por essa e outras considerações para ajudar a tornar a assimilação bem-sucedida.

  1. Acesse o Cloud Acceleration Manager. Clique no cartão do projeto e no cartão Transferência de conteúdo. Navegue até Tarefas de assimilação e clique em Nova assimilação

    imagem

  2. Revise a lista de verificação de assimilação e verifique se todas as etapas foram concluídas. Essas etapas são necessárias para garantir uma assimilação bem-sucedida. Vá para a página Próxima etapa somente se a lista de verificação estiver concluída.

    imagem

  3. Forneça as informações necessárias para criar uma assimilação.

    • Selecione o conjunto de migração que contém os dados extraídos como Origem.
      • Os conjuntos de migração expirarão após um período prolongado de inatividade, de modo que é esperado que a assimilação ocorra relativamente logo após a extração ter sido realizada. Revisão Expiração do conjunto de migração para obter detalhes.
    • Selecione o ambiente de destino. É nesse ambiente que o conteúdo do conjunto de migração é assimilado. Selecione a camada. (Autor/Publicação). Os ambientes de desenvolvimento rápido não são compatíveis.
    OBSERVAÇÃO

    As seguintes observações se aplicam à assimilação de conteúdo:
    Se a origem foi do Autor, é recomendável assimilá-la no nível do Autor no destino. Da mesma forma, se a origem foi Publicar, o destino também deve ser Publicar.
    Se a camada de destino for Author, a instância do autor é encerrada durante a duração da assimilação e fica indisponível para os usuários (por exemplo, autores ou qualquer pessoa que esteja executando a manutenção). O motivo é proteger o sistema e evitar quaisquer alterações que possam ser perdidas ou causar um conflito de assimilação. Confirme se sua equipe está ciente desse fato. Observe também que o ambiente parece hibernado durante a assimilação do autor.
    Você pode executar a etapa opcional de pré-cópia para acelerar significativamente a assimilação. Consulte Assimilar com AzCopy para obter mais detalhes.
    Se a assimilação com pré-cópia for usada (para S3 ou Azure Data Store), é recomendável executar a assimilação do autor primeiro sozinha. Isso acelera a Assimilação de publicação quando executada posteriormente.
    As assimilações não são compatíveis com um destino de RDE (Rapid Development Environment, ambiente de desenvolvimento rápido) e não aparecem como uma possível opção de destino, mesmo que o usuário tenha acesso a ele.

    IMPORTANTE

    Você pode iniciar uma assimilação no ambiente de destino somente se pertencer ao local Administradores do AEM grupo no serviço de autor do Cloud Service de destino. Se não conseguir iniciar uma assimilação, consulte Não foi possível iniciar a assimilação para obter mais detalhes.

    • Escolha o Wipe value
      • A variável Limpar define o ponto inicial do destino da assimilação. Se Limpar estiver ativado, o destino, incluindo todo o conteúdo, será redefinido para a versão do AEM especificada no Cloud Manager. Se não estiver ativado, o destino mantém o conteúdo atual como ponto de partida.
      • Observe que essa opção não NOT afetam como a assimilação do conteúdo será realizada. A assimilação sempre usa uma estratégia de substituição de conteúdo e não uma estratégia de mesclagem de conteúdo para que, em ambos Limpar e Não-apagamento nos casos, a assimilação de um conjunto de migração substituirá o conteúdo no mesmo caminho no destino. Por exemplo, se o conjunto de migração contiver /content/page1 e o destino já contém /content/page1/product1, a assimilação removerá toda a page1 caminho e suas subpáginas, incluindo product1e substitua-o pelo conteúdo no conjunto de migração. Isso significa que é necessário fazer um planejamento cuidadoso ao executar um Não-apagamento assimilação para um destino que contém qualquer conteúdo que deve ser mantido.
    IMPORTANTE

    Se a configuração Limpar estiver ativado para a assimilação, ele redefinirá todo o repositório existente, incluindo as permissões do usuário na instância do Cloud Service de destino. Essa redefinição também é verdadeira para um usuário administrador adicionado à variável administradores e esse usuário deverá ser adicionado ao grupo de administradores novamente para iniciar uma assimilação.

  4. Clique em Assimilar.

    imagem

  5. Em seguida, é possível monitorar a assimilação na exibição de lista dos Trabalhos de assimilação e usar o menu de ação da assimilação para exibir as durações e registrar o progresso da assimilação.

    imagem

  6. Clique em i) botão na linha para obter mais informações sobre o trabalho de assimilação. É possível ver a duração de cada etapa da assimilação quando ela está em execução ou concluída clicando em e clicando em Exibir durações. As informações da extração também são mostradas para perceber o que está sendo assimilado.

    imagem

Ingestão complementar

A ferramenta Transferência de conteúdo tem um recurso que permite a extração de conteúdo diferencial executando uma complementar do conjunto de migração. Isso permite que o conjunto de migração seja modificado para incluir somente o conteúdo que foi alterado desde a extração anterior, sem precisar extrair todo o conteúdo novamente.

OBSERVAÇÃO

Após a transferência inicial do conteúdo, é recomendável fazer atualizações complementares frequentes de conteúdo diferencial para reduzir o período de congelamento de conteúdo para a transferência final de conteúdo diferencial antes de entrar online no Cloud Service. Se você tiver usado a etapa de pré-cópia para a primeira assimilação, poderá ignorar a pré-cópia para assimilações complementares subsequentes (se o tamanho do conjunto de migração complementar for menor que 200 GB). O motivo é que isso pode adicionar tempo a todo o processo.

Para assimilar conteúdo diferencial depois que algumas assimilações forem concluídas, execute um Extração complementare, em seguida, use o método de assimilação com a variável Limpar opção desabilitado. Leia as Limpar acima para evitar a perda de conteúdo que já está no destino.

Comece criando uma tarefa de assimilação e verifique se Limpar está desativado durante a assimilação, conforme mostrado abaixo:

imagem

Resolução de problemas

O CAM não consegue recuperar o token de migração

A recuperação automática do token de migração pode falhar por diferentes motivos, incluindo você configuração de uma lista de permissões IP via Cloud Manager no ambiente Cloud Service de destino. Nesses cenários, você verá a seguinte caixa de diálogo ao tentar iniciar uma assimilação:

imagem

Recupere o token de migração manualmente clicando no link "Obter token" na caixa de diálogo. Outra guia é aberta exibindo o token. Em seguida, você pode copiar o token e colá-lo na Entrada do token de migração campo. Agora, você pode começar a assimilação.

OBSERVAÇÃO

O token está disponível para usuários que pertencem ao local Administradores do AEM grupo no serviço de autor do Cloud Service de destino.

Não foi possível iniciar a assimilação

Você pode iniciar uma assimilação no ambiente de destino somente se pertencer ao local Administradores do AEM grupo no serviço de autor do Cloud Service de destino. Se você não pertence ao grupo de administradores do AEM, você vê um erro como mostrado abaixo ao tentar iniciar uma assimilação. Você pode pedir ao administrador para adicioná-lo ao local Administradores do AEM ou solicite o token propriamente dito, que você pode colar na Entrada do token de migração campo.

imagem

Não é possível acessar o serviço de migração

Depois que uma assimilação é solicitada, uma mensagem como a seguinte pode ser apresentada ao usuário: "O serviço de migração no ambiente de destino está inacessível. Em caso afirmativo, tente novamente mais tarde ou entre em contato com o suporte do Adobe."

imagem

Esta mensagem indica que o Cloud Acceleration Manager não conseguiu acessar o serviço de migração do ambiente de destino para iniciar a assimilação. Essa situação pode ocorrer por vários motivos.

OBSERVAÇÃO

O campo "Token de migração" é exibido porque, em alguns casos, a recuperação desse token é o que realmente não é permitido. Ao permitir que seja fornecido manualmente, ele pode permitir que o usuário inicie a assimilação rapidamente, sem nenhuma ajuda adicional. Se o token for fornecido e a mensagem ainda for exibida, a recuperação do token não foi o problema.

  • O AEM as a Cloud Service mantém o estado do ambiente e, ocasionalmente, deve reiniciar o serviço de migração por vários motivos normais. Se esse serviço estiver sendo reiniciado, ele não poderá ser acessado, mas estará disponível no futuro.
  • É possível que outro processo esteja sendo executado na instância. Por exemplo, se o Release Orchestrator estiver aplicando uma atualização, o sistema pode estar ocupado e o serviço de migração pode ficar indisponível regularmente. Isso e a possibilidade de corromper o estágio ou a instância de produção é o motivo pelo qual é altamente recomendável pausar as atualizações durante uma assimilação.
  • Se um A Inclui na lista de permissões IP foi aplicada Por meio do Cloud Manager, ele impede que o Cloud Acceleration Manager chegue ao serviço de migração. Um endereço IP não pode ser adicionado para assimilações porque seu endereço é dinâmico. Atualmente, a única solução é desativar a lista de permissões IP enquanto a assimilação está em execução.
  • Pode haver outros motivos que precisem de investigação. Se a assimilação continuar a falhar, entre em contato com o Atendimento ao cliente da Adobe.

As Atualizações Automáticas através do Release Orchestrator ainda estão habilitadas

O Release Orchestrator mantém os ambientes atualizados automaticamente ao aplicar atualizações automaticamente. Se a atualização for acionada quando uma assimilação for executada, poderá causar resultados imprevisíveis, incluindo a corrupção do ambiente. Um bom motivo para registrar um tíquete de suporte ao cliente antes de iniciar uma assimilação (consulte a "Observação" acima), para que a desativação temporária do Release Orchestrator possa ser programada.

Se o Release Orchestrator ainda estiver em execução quando uma assimilação estiver sendo iniciada, a interface do usuário apresentará essa mensagem. Você pode optar por continuar mesmo assim, aceitando o risco, marcando o campo e pressionando o botão novamente.

OBSERVAÇÃO

O Release Orchestrator agora está sendo implantado em ambientes de desenvolvimento, portanto, as atualizações pausadas nesses ambientes também devem ser feitas.

imagem

Falha na assimilação complementar devido à violação de restrição de exclusividade

Uma causa comum de Assimilação complementar a falha é um conflito nas ids do nó. Para identificar esse erro, baixe o log de assimilação usando a interface do Cloud Acceleration Manager e procure uma entrada como a seguinte:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: propriedade violada de restrição de exclusividade [jcr:uuid] com valor a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content

Cada nó no AEM deve ter um uuid exclusivo. Esse erro indica que um nó que está sendo assimilado tem a mesma uuid que existe em outro lugar em um caminho diferente na instância de destino.
Essa situação pode ocorrer se um nó for movido na origem entre uma extração e uma extração subsequente Extração complementar.
Também pode acontecer se um nó no destino for movido entre uma assimilação e uma assimilação complementar subsequente.

Este conflito deve ser resolvido manualmente. Alguém familiarizado com o conteúdo deve decidir qual dos dois nós deve ser excluído, tendo em mente outro conteúdo que faça referência a ele. A solução pode exigir que a extração complementar seja feita novamente sem o nó ofensivo.

Falha na assimilação complementar devido à não exclusão do nó referenciado

Outra causa comum de uma Assimilação complementar falha é um conflito de versão para um determinado nó na instância de destino. Para identificar esse erro, baixe o log de assimilação usando a interface do Cloud Acceleration Manager e procure uma entrada como a seguinte:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity0001: não é possível excluir o nó referenciado: 8a2289f4-b904-4bd0-8410-15e41e0976a8

Isso pode acontecer se um nó no destino for modificado entre uma assimilação e uma subsequente Não-apagamento assimilação, de modo que uma nova versão tenha sido criada. Se o conjunto de migração foi extraído com a opção "incluir versões" ativada, pode ocorrer um conflito, pois o destino agora tem uma versão mais recente que está sendo referenciada pelo histórico de versões e outro conteúdo. O processo de assimilação não poderá excluir o nó de versão incorreto porque ele está sendo referenciado.

A solução pode exigir que a extração complementar seja feita novamente sem o nó ofensivo. Ou criar um pequeno conjunto de migração do nó incorreto, mas com a opção "incluir versões" desativada.

As práticas recomendadas indicam que, se uma Não-apagamento a assimilação deve ser executada usando um conjunto de migração que inclua versões (ou seja, extraído com "incluir versões"=true). é fundamental que o conteúdo no destino seja modificado o mínimo possível, até que a jornada de migração seja concluída. Caso contrário, esses conflitos poderão ocorrer.

O que vem a seguir

Quando a assimilação for bem-sucedida, a indexação do AEM será iniciada automaticamente. Consulte Indexação após a migração do conteúdo para obter mais informações.

Depois de concluir a assimilação de conteúdo no Cloud Service, você pode visualizar os registros de cada etapa (extração e assimilação) e procurar erros. Consulte Visualização de logs para um conjunto de migração para saber mais.

Nesta página