Agent IA pour analyser les échecs CI/CD dans n8n

Automatisation de l'analyse des pipelines CI/CD échoués avec un agent IA

Les agents IA accélèrent considérablement l'analyse des causes racines pour les jobs échoués dans les pipelines CI/CD. Un système basé sur n8n réagit aux événements de build échoués, collecte les logs, la configuration du pipeline et génère un rapport avec les causes probables et les étapes de correction. L'analyse prend environ 30 secondes, consommant quelques milliers de tokens.

Préparation de l'architecture

Définissez les paramètres clés avant l'implémentation :

• Événements de lancement : Jobs échoués dans GitLab CI/CD.
• Sources de données : Dépôts, logs complets, métriques des ressources de l'agent, disponibilité des endpoints.
• Analyse : Classification par type de job (build, tests, deploy).
• Format du rapport : Texte concis pour le chat avec faits, causes et actions.

Pour les builds, vérifiez les dépendances, le code et les ressources. Pour les tests, recherchez les erreurs dans le code et les suites de tests. Pour les déploiements, vérifiez les manifests et le statut de la plateforme. Les échecs courants incluent les problèmes de pipeline, les utilitaires de l'agent et les erreurs d'initialisation.

Flux de traitement des événements

Un webhook depuis GitLab déclenche n8n. Un filtre ne laisse passer que les événements échoués. La collecte de données inclut les 50 dernières lignes de logs, .gitlab-ci.yml, et les détails du pipeline/job.

Les données sont formatées dans un tableau JSON :

[
  {"job_log": "50 dernières lignes du job échoué"},
  {"data": "Contenu .gitlab-ci.yml"},
  {"pipeline": {}},
  {"failed_job": {}}
]

L'agent IA analyse en utilisant un prompt système et des outils MCP. Il n'y a pas de mémoire—chaque événement est indépendant.

Outils de l'agent

• Gitlab-mcp : Détails du job, changements de code.
• Grafana-mcp : Métriques de l'agent, logs de déploiement.
• Http-request : Vérification des endpoints.

Les serveurs MCP fonctionnent en mode distant, transport via HTTP streaming. Pour les configurations non distantes, utilisez mcpgateway.

Implémentation dans n8n

Configurez le webhook avec X-Gitlab-Token. Dans GitLab : Définissez les événements de Pipeline sur l'URL du webhook. Un nœud 'If' filtre les états de succès. Les requêtes vers l'API GitLab utilisent un token en lecture seule. Un nœud Merge combine les données.

L'agent reçoit un prompt avec le format d'entrée, les outils, les instructions d'investigation et le format de sortie. Les modèles recommandés sont les dernières versions prenant en charge MCP.

Dernière étape : Envoyer le rapport dans un canal ou un thread Slack.

Exemples de diagnostic

Résolution des dépendances Gradle :

L'agent distingue cela des problèmes de compilation : artefact non publié, identifiants manquants dans le contexte Docker. Étapes : vérifier le dépôt, les identifiants, les mirrors.

Erreur de plan Terraform :

Argument non pris en charge dans HCL. Causes : ressource incorrecte, version du provider DigitalOcean, schéma obsolète. Étapes : mettre à jour le provider, vérifier la documentation, valider.

Points clés

• Une analyse de 30 secondes élimine le travail routinier.
• Utilisez un accès en lecture seule pour la sécurité.
• Des modèles récents assurent des performances MCP précises.
• Testez sur des workflows réels.
• Mettez à l'échelle pour les groupes de dépôts.

— Editorial Team