Falha nas implantações de AEM Cloud Manager DEV devido a erros de XML e ClientLib
Este artigo explica as causas e as etapas de resolução para falhas de implantação e maior tempo de implantação em ambientes DEV do Adobe Experience Manager (AEM) Cloud Manager causados por erros de sintaxe XML e problemas de compilação da biblioteca do cliente.
Descrição description
Ambiente
- Adobe Experience Manager (AEM) Cloud Manager (todas as versões)
Problema/Sintomas
-
As implantações de DESENVOLVIMENTO levam muito mais tempo do que o normal (mais de duas horas) e acabam falhando durante o estágio de implantação.
-
O pipeline de implantação passa pelos estágios de validação, criação, teste de unidade, verificação de código e criação de imagem, mas falha no estágio Implantar em desenvolvimento.
-
Os logs de implantação mostram erros relacionados à falta de tags finais XML em pacotes de conteúdo, como:
O tipo de elemento “content” deve ser terminado pela marca de fim correspondente "
</content>".O tipo de elemento “header” deve ser terminado pela marca de fim correspondente "
</header>". -
As importações do pacote de distribuição falham devido a erros de análise XML.
-
Biblioteca do cliente (ClientLib) Ocorrem MENOS erros de compilação, como variáveis indefinidas (por exemplo, @white) e mixins ausentes.
-
Erros de compilação de Java ocorrem para classes de modelo personalizadas não resolvidas.
-
Esses erros estavam presentes anteriormente, mas não causaram falhas de implantação. Agora, elas resultam em falhas de pipeline.
Causa
Falhas de implantação ocorrem devido a erros de sintaxe XML (tags finais ausentes), variáveis de biblioteca de cliente não resolvidas ou mixins e classes de modelo Java personalizadas ausentes. Alterações recentes no pipeline ou no ambiente podem fazer com que esses problemas causem falhas nas implantações, mesmo que elas não estivessem bloqueadas anteriormente.
Resolução resolution
Siga estas etapas para resolver o problema:
- Acesse os logs de execução do pipeline do Cloud Manager para a implantação com falha.
- Identifique todos os erros de análise XML e erros de compilação da biblioteca do cliente.
- Localize os arquivos XML mencionados, por exemplo, em
/conf/.../settings/wcm/templates/. - Verifique se todos os elementos XML, como
<content>e<header>, incluem marcas de fechamento correspondentes, como</content>e</header>. - Valide a estrutura XML com um validador de XML antes de confirmar as alterações.
- Revise os arquivos LESS e CSS para variáveis indefinidas, como
@whitee@mid-blue, e mixins ausentes, como.label-small-style()e.media(). - Defina as variáveis e os mixins ausentes ou atualize as importações para incluir as definições necessárias.
- Recrie as bibliotecas de clientes localmente para confirmar a compilação bem-sucedida.
- Verifique se todas as classes de modelo Sling personalizadas referenciadas por componentes estão presentes e são importadas corretamente na base de código.
- Resolva dependências ausentes ou referências de pacote incorretas.
- Confirme as alterações no repositório depois de concluir as correções necessárias.
- Acione uma nova implantação no Cloud Manager e monitore o pipeline para confirmar se ele é concluído com sucesso.