- Accueil
- Documentation
- Barrières qualité
Barrières qualité
Comment AI CodeOps décide si un changement peut être livré : résultats des tests, revue des constats par IA, approbations et vérification de la barrière de livraison que votre CI peut appeler.
Chaque session IA se termine par un changement : un diff par rapport au dépôt de votre projet. Avant que ce changement puisse devenir une pull request, AI CodeOps le vérifie. Les contrôles sont les mêmes, que vous ouvriez la pull request depuis la console ou que vous interrogiez la barrière depuis votre CI.
Ce que la barrière vérifie
Un changement est prêt à être livré (release-ready) lorsque toutes ces conditions sont réunies :
- Les tests réussissent. Après avoir écrit le changement, la session exécute la commande de test de votre projet dans son bac à sable et enregistre le résultat. Des tests en échec bloquent le changement.
- Il y a un résultat de test. Une session qui a modifié du code dans un projet a besoin d'un résultat de test avec des décomptes. Si aucun test ne s'est exécuté pour elle, ou si la commande de test s'est exécutée sans indiquer de décomptes, le changement est bloqué : « The test command ran but reported no test counts, so nothing shows a test passed. Check the project's test command ». Une absence de preuve n'est pas une réussite. Si le projet n'a pas de suite de tests, activez Don't run tests for this project dans ses réglages, sous Plan → Projects (Projets). La barrière ne demande alors aucun résultat de test à ce projet. Une session qui n'a modifié aucun code n'en a pas besoin non plus.
- La revue des constats par IA est terminée. Une étape de relecture lit le diff et enregistre des constats (security, quality, performance, reliability, test coverage et d'autres catégories). Si cette revue n'a pas pu se terminer, les constats sont inconnus et le changement est retenu. La page de la session indique pourquoi : le relecteur n'a pas répondu à temps, sa réponse n'a pas pu être lue comme des constats, ou le budget s'est épuisé avant la revue. Relancez la session (après avoir relevé le budget, dans le dernier cas).
- Aucun constat bloquant n'est ouvert. Les constats de gravité high ou critical bloquent tant qu'ils ne sont pas triés.
- Les tests valent pour la version sur laquelle ils ont été exécutés. Si quelqu'un modifie le changement après l'exécution de ses tests, l'ancien résultat ne le valide ni ne le bloque : la barrière indique que cette version n'est pas testée et l'approbation s'ouvre de nouveau, de sorte qu'une personne décide avant la livraison. Relancez la session pour tester la nouvelle version.
Les approbations sont un contrôle distinct sur le même parcours. Consultez Approbations et politiques.
Où vous la voyez
Ouvrez la page d'exécution d'une session. Le panneau Quality gates affiche Release-ready ou Not release-ready, les totaux des tests, chaque résultat de test et les raisons pour lesquelles le changement n'est pas encore prêt. Le panneau Findings liste chaque constat avec sa gravité, son fichier et sa ligne.
Les résultats de tests et les constats ouverts de tout l'espace de travail se trouvent sous Build & Test → Quality.
Trier les constats
Chaque constat a un statut. Modifiez-le depuis la liste déroulante, dans la liste Findings de l'exécution :
| Statut | Bloque le changement ? |
|---|---|
| open, acknowledged, in progress | Oui, si high ou critical |
| fixed, won't fix, false positive, duplicate | Non |
Vous pouvez aussi choisir Fix sur un constat pour lancer une exécution IA qui le corrige. Modifier le statut d'un constat nécessite un rôle doté de la permission de tri. Les rôles Owner, Admin, Developer, Member et Security Admin l'ont ; le rôle Viewer ne l'a pas.
Ce que la barrière bloque
Lorsque vous choisissez d'ouvrir une pull request, AI CodeOps vérifie dans cet ordre :
- La politique de l'espace de travail. Une règle deny arrête la pull request ; une règle ask nécessite une revue approuvée.
- L'approbation. Une approbation rejected ou pending l'arrête.
- La barrière qualité. Un changement qui n'est pas prêt à être livré reçoit les premiers motifs, par exemple « This change isn't release-ready: HIGH security: … ».
La même barrière qualité s'exécute de nouveau avant que la console ne fusionne une pull request qu'elle a ouverte. La pull request s'ouvre sur une branche nommée codeops/run-<id>.
La barrière de livraison pour la CI
Review & Gate → Release gate évalue l'URL d'une pull request ou le SHA d'un commit sur l'ensemble des sessions qui y ont touché, et affiche Allowed ou Denied avec les motifs. Votre CI peut poser la même question par POST /api/release/check avec une clé API de l'espace de travail. La vérification en CI ajoute des options que la barrière par exécution n'utilise pas : des workflows requis, un pourcentage de couverture minimal, des licences interdites (vérifiées par rapport au SBOM du projet) et un déploiement préalable requis, par exemple en staging. Un seuil de couverture a besoin d'un chiffre de couverture : si vous en définissez un et qu'aucune exécution de tests sur le changement n'a indiqué de couverture, la vérification refuse.
La vérification en CI applique aussi la règle du résultat de test ci-dessus, et liste les sessions sans résultat de test dans testEvidenceMissing. Envoyer "blockOnTestFailure": false la désactive pour cet appel.
Les champs et la réponse sont décrits sur la page de l'API. Barrière de livraison dans la CI propose des jobs à copier pour GitHub Actions, GitLab CI et Bitbucket Pipelines, et montre comment faire du job une vérification requise.
Si la vérification de la barrière elle-même ne peut pas s'exécuter, par exemple pendant une brève panne, la pull request n'est pas ouverte : « The release check couldn't run just now. » Réessayez dans un instant.
Étapes suivantes
Questions fréquentes
Puis-je ouvrir une pull request alors que des constats sont encore ouverts ?
Pas tant qu'un constat high ou critical est ouvert, que des tests échouent ou que la revue par IA ne s'est pas terminée. Triez le constat ou relancez la session, puis ouvrez la pull request.
Et si mon projet n'a pas de tests ?
Activez « Don't run tests for this project » dans les réglages du projet. Sans cela, une session qui a modifié du code a besoin d'un résultat de test avec des décomptes. Si aucun test ne s'est exécuté, ou si la commande de test n'a indiqué aucun décompte, le changement est bloqué, car une absence de preuve n'est pas une réussite.