{"meta":{"title":"Définition des seuils de qualité du code pour les pull requests","intro":"Évitez d’intégrer des modifications de faible qualité dans votre base de code en utilisant des seuils Code Quality pour bloquer les demandes de tirage qui ne respectent pas vos critères.","product":"Sécurité et qualité du code","breadcrumbs":[{"href":"/fr/code-security","title":"Sécurité et qualité du code"},{"href":"/fr/code-security/how-tos","title":"Guides pratiques"},{"href":"/fr/code-security/how-tos/maintain-quality-code","title":"Maintenir le code de qualité"},{"href":"/fr/code-security/how-tos/maintain-quality-code/set-pr-thresholds","title":"Définir des seuils de qualité"}],"documentType":"article"},"body":"# Définition des seuils de qualité du code pour les pull requests\n\nÉvitez d’intégrer des modifications de faible qualité dans votre base de code en utilisant des seuils Code Quality pour bloquer les demandes de tirage qui ne respectent pas vos critères.\n\nVous pouvez bloquer les pull requests qui ne respectent pas vos normes de qualité du code en ajoutant des seuils Code Quality à un jeu de règles. Si une demande de fusion n’atteint pas un seuil, elle ne peut pas être fusionnée.\n\nVous pouvez définir des seuils pour :\n\n* **CodeQL résultats**, en fonction du niveau de gravité minimal des résultats devant être résolus.\n* **Couverture du code**, par le pourcentage minimal de lignes qui doivent être couvertes par des tests.\n\nVous pouvez appliquer ces seuils au niveau du **référentiel** ou au niveau **de l’organisation** pour appliquer la même norme sur de nombreux référentiels à la fois. Choisissez le niveau de l’organisation lorsque vous souhaitez une barre de qualité cohérente entre les équipes et le niveau de référentiel lorsqu’un projet unique a besoin de sa propre norme.\nCode Quality\nRésultats de l’IA ne peut pas être défini comme un seuil.\n\n## Prerequisites\n\n* Code Quality est activé. Consultez [Activation de GitHub Code Quality](/fr/code-security/how-tos/maintain-quality-code/enable-code-quality?utm_campaign=code-quality-ga-july-2026\\&utm_medium=docs\\&utm_source=docs-set-quality-thresholds-enable-cq)\n* Code dans une langue prise en charge. Consultez [les langues prises en charge](/fr/code-security/concepts/code-quality/code-quality#supported-languages).\n\n> \\[!NOTE]\n> Le seuil aura un impact uniquement si le référentiel possède du code dans une ou plusieurs langues prises en charge, consultez [Activation de GitHub Code Quality](/fr/code-security/how-tos/maintain-quality-code/enable-code-quality).\n\n## Confirmer que Code Quality s’exécute correctement sur les pull requests\n\nAvant d’ajouter ou de mettre à jour un jeu de règles afin d’inclure un seuil pour Code Quality, vérifiez que le workflow Code Quality est en cours d’exécution et renvoie les résultats aux pull requests. Sinon, le jeu de règles peut bloquer la fusion de **toutes les** pull requests.\n\n1. Ouvrez une demande de tirage récente et faites défiler jusqu’au résumé « Vérifications » en bas de la demande de tirage.\n2. Vérifiez que la vérification «CodeQL - Qualité du code » s’est exécutée correctement et a signalé son état.\n\nPour plus d’informations, consultez « [Analyse basée sur CodeQL pour la qualité du code](/fr/code-security/reference/code-quality/codeql-detection) ».\n\n## Ajout ou mise à jour d’un ensemble de règles à inclure Code Quality\n\nLes étapes suivantes créent ou mettent à jour un ensemble de règles au niveau du référentiel. Pour appliquer le même seuil sur plusieurs référentiels à la fois, créez un ensemble de règles d’organisation avec la même règle **exiger des résultats de qualité du code** à la place. Consultez [Création d'ensembles de règles pour les dépôts de votre organisation](/fr/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization).\n\n1. Accédez à l’onglet « Paramètres » de votre référentiel.\n2. Dans la barre latérale gauche, sous « Code et automatisation », développez **Règles**, puis cliquez sur **Ensembles de règles**.\n3. Si vous ne disposez pas déjà d’un ensemble de règles pour protéger votre branche par défaut, développez **Nouveau jeu de règles** , puis cliquez sur **Nouveau ensemble de règles de branche**. Vous pouvez également ouvrir votre ensemble de règles existant pour la branche par défaut et passer à l’étape 5.\n4. Si vous créez un ensemble de règles :\n * Définissez un nom pour l’ensemble de règles.\n * Définissez le « statut d’application » sur « Évaluer » pendant que vous calibrez le seuil au cours d’une phase pilote. Si vous souhaitez appliquer immédiatement le seuil, sélectionnez « Actif ».\n * Sous « Branches cibles », ajoutez une cible de « Inclure une branche par défaut ».\n5. Sous « Règles de branche », activez « Exiger des résultats de qualité du code ».\n6. Définissez « Severity » pour indiquer le niveau de gravité minimal des résultats de qualité du code qui doivent être résolus avant qu’une pull request puisse être fusionnée dans la branche par défaut. Par exemple:\n * Définissez « Erreurs » pour bloquer les pull requests contenant des erreurs de qualité du code non résolues avant leur fusion.\n * Définissez « Warnings and higher » pour bloquer la fusion des pull requests contenant des **avertissements** ou des **erreurs** non résolus.\n * Définissez « Notes and higher » pour bloquer la fusion des pull requests contenant des **remarques**, des **avertissements** ou des **erreurs** non résolus.\n * Définissez « All » pour bloquer la fusion des pull requests contenant **n’importe quels** résultats de qualité du code non résolus.\n7. Une fois que vous avez terminé de définir ou de modifier l’ensemble de règles, cliquez sur **Créer** ou **Enregistrer des modifications**.\n\nSi vous avez sélectionné « Évaluer », passez en revue les informations du jeu de règles afin de voir quelles pull requests auraient été bloquées. Lorsque les résultats correspondent à la barre de qualité souhaitée, remplacez l’état d’application par « Actif ».\n\n## Définition d’un seuil de couverture du code\n\nVous pouvez également bloquer les pull requests dont le taux de couverture du code est inférieur à un seuil défini. Cela utilise une règle **de couverture de code Restrict** distincte, et non la règle **Exiger des résultats de qualité du code** utilisée ci-dessus, et votre référentiel doit d’abord charger les données de couverture du code. Pour obtenir la procédure complète, consultez [Définir des seuils de couverture du code pour les pull requests](/fr/code-security/how-tos/maintain-quality-code/restrict-code-coverage)."}