Solução de problemas de falhas de pipeline de front-end no AEM as a Cloud Service

Verifique se package-lock.json existe no módulo ui.frontend e se está confirmado no repositório.

Regenerar package-lock.json e node_modules usando um ambiente Linux (use o Subsistema do Windows para Linux ou Docker). Para reproduzir e resolver problemas de dependência específicos da plataforma para pipelines somente FE, use os seguintes comandos em um terminal WSL:  

cd /path/to/your/project
rm -rf package-lock.json node_modules
npm install
git add package-lock.json
git commit -m "Regenerate package-lock.json on Linux"

 
Ou execute em um contêiner Linux:
 

docker run --rm -v $(pwd):/app -w /app node:16-alpine \
  sh -c "rm -rf node_modules package-lock.json && npm install"

Atualize dependências desatualizadas, incluindo Jest, Storybook e Webpack.

Use npm audit com sinalizadores de nível de auditoria crítico e de produção para identificar problemas de dependência restantes. Por exemplo: npm audit --production --audit-level=critical

Confirme o arquivo package-lock.json regenerado do ambiente Linux para o repositório.

Enviar alterações para a ramificação usada pelo pipeline somente FE.

Execute novamente o pipeline somente FE no Cloud Manager.

Solucionar qualquer erro de ESLint/estilo de código relatado durante o processo de criação; todos os erros de lint devem ser resolvidos para que a implantação seja bem-sucedida.

Se necessário somente para fins de validação, remova temporariamente a lista do script de compilação em package.json. No entanto, isso não é recomendado para uso de produção.

Verifique se a etapa de criação foi concluída com êxito sem dependências ou erros de lista.

Se a implantação for bem-sucedida, mas os estilos e scripts do site não forem carregados, verifique as configurações do Dispatcher e a configuração do CDN. Certifique-se de que o vhost habilitado inclua o ServerAlias correto para o domínio estático. Para ver as etapas, consulte A implantação do pipeline de front-end interrompe o site.

Se o pipeline falhar com BUILD_NPM_AUDIT_ERROR, remova todos os nós SiteConfig ou HtmlPageItemsConfig conflitantes. Para obter as etapas, consulte Como resolver BUILD_NPM_AUDIT_ERROR no pipeline de front-end do AEM as a Cloud Service.