AEM Cloud Manager: falha no pipeline de pilha completa em “Implantar em Desenvolvimento” devido a DocView XML malformado no pacote de conteúdo
Este artigo aborda falhas consistentes no pipeline de pilha completa da Adobe Experience Manager Cloud durante o estágio “Implantar em desenvolvimento” causado pelo XML mal formado do DocView em um pacote de conteúdo.
Descrição description
Ambiente
Adobe Experience Manager (AEM) as a Cloud Service (todas as versões)
Problema/Sintomas
O Pipeline de pilha completa da nuvem falha de forma consistente durante o estágio Implantar em desenvolvimento. Várias execuções de pipeline exibem o mesmo comportamento, com o processo de implantação falhando ou ficando preso por longos períodos (por exemplo, mais de 1,5 hora) sem avançar. Nenhuma informação de erro acionável está visível nos logs de implantação.
- O problema pode ser reproduzido acionando o pipeline de pilha completa para o ambiente afetado.
- Nenhuma mensagem de erro específica é mostrada nos logs; o pipeline parece travar ou falhar silenciosamente na etapa de implantação.
Resolução resolution
-
Identificar o pacote de conteúdo problemático
- Revise os pacotes de conteúdo incluídos no pipeline, com foco nos pacotes adicionados ou modificados recentemente.
- Verifique se há pacotes gerados por ferramentas automatizadas que possam apresentar XML malformado.
-
Validar arquivos XML do DocView
- Extraia o pacote de conteúdo e localize todos os
.content.xmlarquivos. - Use uma ferramenta de validação de XML, como
xmllint, para verificar se cada arquivo.content.xmlestá bem formado.
code language-none find . -name '*.content.xml' -exec xmllint --noout {} \;- Corrija quaisquer erros de sintaxe XML relatados pelo validador.
- Extraia o pacote de conteúdo e localize todos os
-
Atualizar o processo de criação para evitar problemas futuros
- Verifique se o módulo
ui.contentfoi criado usando o Plug-in Maven do Pacote FileVault. - Execute
mvn clean verifypara validar a estrutura do pacote e a exatidão de XML antes de confirmar ou implantar. - Referência: Estrutura do Pacote de Conteúdo do AEM Project
- Verifique se o módulo
-
Adicionar validação XML ao pipeline de CI
- Integre uma etapa de validação XML no processo de IC para verificar automaticamente se todos os arquivos
.content.xmlestão bem formados antes da implantação.
- Integre uma etapa de validação XML no processo de IC para verificar automaticamente se todos os arquivos
-
Executar o pipeline novamente
- Depois de corrigir qualquer XML malformado e atualizar o processo de criação, acione novamente o pipeline para verificar se a implantação foi bem-sucedida.
Causa
As falhas de pipeline foram causadas por um arquivo XML DocView malformado em um pacote de conteúdo mutável. Esse problema só foi exibido quando o pacote problemático foi processado durante a etapa de implantação, não devido a alterações no analisador do Adobe ou nas ferramentas de plug-in.