Documentação

Falha na build do pipeline devido ao cache obsoleto e à versão de plug-in front-end-maven no AEMaaCS

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Falha na compilação de pipeline no Adobe Experience Manager as a Cloud Service (AEMaaCS) durante a execução do módulo UI.frontend. A falha deriva de referências de cache obsoletas e de uma versão desatualizada de rontend-maven-plugin. Embora as compilações locais tenham êxito, ocorrem falhas de pipeline devido a referências a arquivos revertidos e erros de uma versão desatualizada de frontend-maven-plugin. Atualizar o plug-in e executar uma build limpa resolve o problema.

Descrição description

Ambiente

  • Produto: Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Cenário: Execução do pipeline do Cloud Manager para o módulo UI.frontend
  • Versões: Java 11, Nó v16.20.2, frontend-maven-plugin 1.12.0

Problema/Sintomas

  • A compilação de pipeline falha consistentemente no módulo UI.frontend durante a execução do Cloud Manager.
  • A mensagem de erro relata falha ao executar a produção de execução npm via frontend-maven-plugin.
  • Os logs de compilação exibem versões de plug-in Maven não resolvidas e dependências de artefato ausentes.
  • Erros de compilação referenciam arquivos SCSS excluídos ou revertidos, como pdplayoutcontainer.scss e pdpbutton.scss.
  • O cache obsoleto retém referências a arquivos desatualizados que não existem mais no repositório, causando inconsistências de criação.

Resolução resolution

Siga estas etapas para resolver o problema:

  1. Abra o arquivo pom.xml para o módulo UI.frontend e atualize a versão frontend-maven-plugin de 1.12.0 para 1.15.0 ou superior.

  2. No Cloud Manager, defina a variável de pipeline CM_DISABLE_BUILD_REUSE como true para desabilitar a reutilização de artefatos de compilação anteriores.

  3. Adicione etapas de limpeza à configuração do pipeline antes que a compilação principal seja iniciada:

    • Exclua o diretório ui.frontend/dist.
    • Exclua o diretório ui.frontend/target.
    • Exclua o diretório ui.frontend/node_modules/.cache.

  4. Verifique se todos os plug-ins Maven em pom.xml têm números de versão explícitos.

  5. Confirme se todas as dependências referenciadas estão disponíveis e acessíveis no repositório Maven.

  6. Acione uma nova execução de pipeline e verifique se a conclusão foi bem-sucedida sem erros ou referências a arquivos excluídos.

Observação: se os erros de compilação persistirem, verifique as importações de SCSS e as definições de variáveis em busca de integridade e precisão antes de acionar uma nova compilação.

Leitura relacionada

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f