Échec de l’analyse du code Cloud Manager et remplacement des problèmes de comportement

Les analyses de code Adobe Experience Manager as a Cloud Service (AEMaaCS) Cloud Manager échouent lorsque les mesures de qualité de code critique ou importante ne répondent pas aux exigences de déploiement. Ce problème se produit, car Cloud Manager applique des points de contrôle qualité du code qui bloquent les déploiements pour les problèmes critiques et autorisent de manière conditionnelle les remplacements pour les problèmes importants en fonction de la configuration du pipeline. Le problème affecte la progression du déploiement, l’exécution du pipeline et la promotion du code vers les environnements cibles. Pour résoudre le problème, corrigez les violations, validez les remplacements et réexécutez les pipelines.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problème/Symptômes

  • Le pipeline échoue avec FAIL_CRITICAL_METRICS lors de l’étape Qualité du code .
  • Le pipeline se met en pause sur les problèmes importants et affiche un avertissement Remplacé lorsqu’un remplacement précédent existe.
  • L’interface utilisateur de Cloud Manager n’affiche aucun problème critique tandis que le rapport CSV contient des résultats critiques ou majeurs.
  • L’option Remplacer n’est pas disponible dans l’interface utilisateur du pipeline.

Cause première

Le problème se produit, car Cloud Manager applique un modèle de qualité du code à trois niveaux composé de mesures Critique, Important et Infos. Les problèmes critiques bloquent toujours le déploiement et ne prennent pas en charge les remplacements. Les problèmes importants interrompent le déploiement et les remplacements de la prise en charge uniquement lorsque le type et la configuration du pipeline les autorisent. Les différences entre les résultats de l’interface utilisateur et du fichier CSV se produisent car le fichier CSV contient les résultats d’analyse bruts tandis que l’interface utilisateur affiche les résultats dérivés des mesures. Les options de remplacement ne sont pas disponibles lorsque les échecs sont critiques ou lorsque le type de pipeline ne prend pas en charge les remplacements.

Résolution resolution

Pour identifier la catégorie d’échec et résoudre le problème d’analyse du code, procédez comme suit.

  1. Déterminez si l’échec du pipeline contient des problèmes critiques ou importants en consultant l’étape Qualité du code dans l’échec de l’exécution du pipeline.
  2. Validez les incohérences entre l’interface utilisateur de Cloud Manager et le rapport CSV en téléchargeant les résultats CSV et en examinant les ID de règle, les gravités et les références de fichier.
  3. Résolvez les problèmes critiques en corrigeant les violations de code identifiées dans le rapport CSV, car les problèmes critiques ne prennent pas en charge les remplacements.
  4. Déterminez si le pipeline prend en charge les remplacements en consultant la section Problèmes importants et en vérifiant que le type de pipeline actuel autorise la fonctionnalité de remplacement.
  5. Vérifiez que le rôle affecté inclut les autorisations de Responsable de déploiement, Responsable de projet ou Propriétaire de l’entreprise lorsque l’approbation de remplacement est requise.
  6. Supprimez les faux positifs valides en appliquant l’annotation @SuppressWarnings appropriée pour la règle affectée et en réexécutant le pipeline.
  7. Validez le paramètre Comportement de mesure important en examinant le comportement du pipeline configuré et en vérifiant qu’il correspond aux besoins de l’entreprise.
  8. Vérifiez que l’étape de création se termine correctement avant de résoudre les problèmes de comportement de remplacement, car les échecs de création empêchent la disponibilité du remplacement de la qualité du code.
  9. Validez la résolution en confirmant que le pipeline passe l’étape Qualité du code ou passe par un chemin de remplacement approuvé, que les problèmes critiques reviennent à zéro et que les résultats du fichier CSV et de l’interface utilisateur s’alignent sur les valeurs attendues.

Quand réaffecter

  • Les problèmes critiques persistent après l’application de tous les correctifs de code identifiés.
  • L’option de remplacement reste indisponible après la validation du type de pipeline et du rôle affecté.
  • Le rapport CSV contient des identifiants de règle ou des classifications de gravité qui ne correspondent pas au comportement attendu.
  • Les résultats de l’interface utilisateur et du fichier CSV continuent d’afficher des informations de gravité incohérentes après validation.

Lecture connexe

recommendation-more-help
experience-cloud-kcs-help-kbarticles