Falhas de verificação de código do Cloud Manager e problemas de comportamento de substituição
As verificações de código do Adobe Experience Manager as a Cloud Service (AEMaaCS) Cloud Manager falham quando as métricas de qualidade de código Críticas ou Importantes não atendem aos requisitos de implantação. Esse problema ocorre porque o Cloud Manager impõe portas de qualidade de código que bloqueiam implantações para problemas críticos e permitem substituições condicionalmente para problemas importantes com base na configuração do pipeline. O problema afeta o progresso da implantação, a execução do pipeline e a promoção do código para ambientes de destino. Para resolver o problema, corrija as violações, valide as substituições e execute os pipelines novamente.
Descrição description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Sintomas
- O pipeline falha com
FAIL_CRITICAL_METRICSdurante a etapa de Qualidade do código. - O pipeline pausa em problemas importantes e exibe um aviso Substituído quando existe uma substituição anterior.
- A interface do usuário do Cloud Manager mostra zero problemas críticos, enquanto o relatório CSV contém descobertas críticas ou importantes.
- A opção Substituir não está disponível na interface do usuário do pipeline.
Causa raiz
O problema ocorre porque o Cloud Manager impõe um modelo de qualidade de código de três camadas que consiste em métricas Críticas, Importantes e Informações. Problemas críticos sempre bloqueiam a implantação e não oferecem suporte a substituições. Problemas importantes pausam a implantação e o suporte a substituições somente quando o tipo e a configuração do pipeline permitem isso. As diferenças entre os resultados de interface do usuário e CSV ocorrem porque o CSV contém descobertas de verificação brutas, enquanto a interface do exibe resultados derivados de métricas. As opções de substituição ficam indisponíveis quando as falhas são Críticas ou quando o tipo de pipeline não oferece suporte a substituições.
Resolução resolution
Siga estas etapas para identificar a categoria de falha e resolver o problema de verificação de código com êxito.
- Identifique se a falha do pipeline contém problemas críticos ou importantes, revisando a etapa Qualidade do código na execução do pipeline que falhou.
- Valide as discrepâncias entre a interface do usuário do Cloud Manager e o relatório de CSV baixando os resultados do CSV e revisando as IDs de regra, severidade e referências de arquivo.
- Resolva problemas críticos corrigindo as violações de código identificadas no relatório CSV porque os problemas críticos não oferecem suporte a substituições.
- Determine se o pipeline oferece suporte a substituições, revisando a seção Problemas importantes e verificando se o tipo de pipeline atual permite a funcionalidade de substituição.
- Confirme se a função atribuída inclui permissões de Gerente de implantação, Gerente de projeto ou Proprietário da empresa quando é necessária a aprovação de substituição.
- Suprima falsos positivos válidos aplicando a anotação
@SuppressWarningsapropriada para a regra afetada e executando o pipeline novamente. - Valide a configuração Comportamento de métrica importante revisando o comportamento do pipeline configurado e verificando se ele corresponde aos requisitos de negócios.
- Verifique se a etapa de compilação foi concluída com êxito antes de solucionar problemas de comportamento de substituição, pois as falhas de compilação impedem a disponibilidade de substituição de qualidade do código.
- Valide a resolução confirmando que o pipeline passa na etapa de Qualidade do código ou prossegue por um caminho de substituição aprovado, que os problemas críticos retornam a zero e que os resultados do CSV e da interface do usuário se alinham com os valores esperados.
Quando escalonar
- Problemas críticos persistem após a aplicação de todas as correções de código identificadas.
- A opção de substituição permanece indisponível após validar o tipo de pipeline e a função atribuída.
- O relatório de CSV contém IDs de regra ou classificações de severidade que não correspondem ao comportamento esperado.
- Os resultados da interface do usuário e do CSV continuam mostrando informações de gravidade inconsistentes após a validação.