Barrière qualité (quality gate)
Mis à jour le
Une barrière qualité est une vérification réussite-échec qu'un changement doit franchir avant d'aller plus loin. Ce qu'elle vérifie, son intérêt pour le code de l'IA, et son usage dans AI CodeOps.
Une barrière qualité est un point de contrôle automatisé, réussite ou échec, qu'un changement de code doit franchir avant de passer à l'étape suivante, comme devenir une pull request, être fusionné ou être déployé. La barrière transforme plusieurs signaux (tests, résultats de revue, approbations) en une seule décision.
Définition
Une barrière a un ensemble de conditions et un verdict. Les conditions typiques sont « les tests réussissent », « aucun problème critique n'est ouvert » et « un relecteur a approuvé ». Si une condition échoue, le changement s'arrête et la barrière dit pourquoi. Les barrières se placent généralement à une transition : avant la fusion, avant la release, avant la production.
Les bonnes barrières sont explicites sur ce qu'elles ignorent. Une revue qui ne s'est jamais exécutée n'est pas une revue au vert, et un résultat manquant ne devrait pas compter comme une réussite.
Pourquoi c'est important
Les agents IA peuvent écrire des changements plus vite que les gens ne peuvent les lire. Une barrière maintient la même exigence pour chaque changement, quels que soient la personne ou l'outil qui l'a écrit, et elle enregistre pourquoi un changement a été retenu. Sans elle, la seule chose entre le code généré et votre branche principale est l'attention de quelqu'un un jour de rush.
Dans AI CodeOps
Chaque session IA se termine par un diff. Avant qu'il puisse devenir une pull request, AI CodeOps vérifie, dans l'ordre :
- La politique de l'espace de travail : un deny l'arrête, un ask exige une revue approuvée.
- L'approbation : une approbation en attente ou rejetée l'arrête.
- La barrière qualité elle-même : les tests n'ont pas échoué sur la version actuelle, la revue des constats par l'IA s'est terminée, et aucun constat high ou critical n'est encore open, acknowledged ou in progress.
Le panneau Quality gates de la page d'exécution affiche Release-ready ou Not release-ready, avec les motifs. La même barrière s'exécute de nouveau avant que la console fusionne une pull request ouverte par une session.
Votre CI peut poser la même question pour n'importe quelle pull request ou n'importe quel commit :
curl -s -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pullRequestURL":"https://github.com/acme/api/pull/42","blockingSeverity":"medium"}'
Une réponse de refus, abrégée :
{
"allowed": false,
"summary": "HIGH security: Coupon code is passed to the pricing query without validation",
"reasons": ["HIGH security: Coupon code is passed to the pricing query without validation"],
"testFailures": [],
"coverageShortfall": null
}
Le point de terminaison répond HTTP 200 dans tous les cas : une étape de CI doit donc lire allowed. Si aucune session n'a touché le changement, il est refusé : la barrière n'a rien à juger. La vérification CI peut aussi imposer un seuil de couverture, une politique de licences, des workflows requis et un déploiement préalable. La liste complète des champs se trouve dans la référence de l'API.
Termes associés
- Barrière de déploiement : la même idée appliquée à la livraison dans un environnement.
- Humain dans la boucle (human-in-the-loop) : l'approbation qui accompagne les vérifications automatisées.
- Test statique de sécurité des applications (SAST) : un type de signal qu'une barrière peut exploiter.
Questions fréquentes
Une barrière qualité est-elle la même chose qu'une vérification de CI ?
Une vérification de CI est un signal. Une barrière qualité est la décision fondée sur plusieurs signaux, comme les tests, les constats de revue et les approbations, qui dit si le changement peut aller plus loin.
Que se passe-t-il dans AI CodeOps si la barrière elle-même produit une erreur ?
Le changement est refusé. La barrière reste fermée en cas d'erreur : une erreur pendant la vérification ne laisse jamais passer un changement.
Mon pipeline de CI peut-il demander un verdict à la barrière d'AI CodeOps ?
Oui. POST /api/release/check avec une clé API de l'espace de travail et une URL de pull request ou un SHA de commit renvoie allowed à true ou false, avec les motifs.