Définir des seuils de couverture du code pour les pull requests

Empêchez la fusion des pull requests lorsque la couverture du code chargé passe sous les seuils requis par votre équipe.

Qui peut utiliser cette fonctionnalité ?

Propriétaires de référentiels, propriétaires d’organisations et utilisateurs avec le rôle d’administrateur

Dans cet article

À suivre

Phase 4: Assess the pilot and decide

Remarque

Cette fonctionnalité est en cours de développement préversion publique et est susceptible de changer.

Fonctionnement de la règle de couverture du code

La règle Restreindre la couverture du code évalue les données de couverture de ligne chargées par rapport aux seuils configurés. Il n’attend pas que les chargements de couverture se terminent.

Pour empêcher qu’une pull request ne soit fusionnée avant que tous les résultats de couverture attendus soient disponibles, définissez comme vérification d’état requise chaque vérification d’état associée à un téléversement de couverture attendu. Cela inclut la couverture téléversée depuis des tâches ou des flux de travail distincts.

Pour plus d’informations sur la couverture de ligne, consultez Référence sur la couverture du code.

Prerequisites

Création d’une règle de seuil de couverture

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la barre latérale gauche, sous « Code, planification et automatisation » « Code et automatisation », cliquez sur Ensembles de règles, puis sur Ensembles de règles.

  4. Créez un ensemble de règles de branche ou cliquez sur un ensemble de règles existant pour le modifier.

  5. Sous « Règles de branche », sélectionnez Restreindre la couverture du code.

  6. Développez des paramètres supplémentaires pour configurer des seuils. La valeur 0 signifie que le seuil est désactivé.

    • Pourcentage minimal de couverture de ligne : entrez une valeur pour bloquer les demandes de tirage où la couverture de ligne agrégée est inférieure à ce pourcentage.
    • Nombre maximal de suppressions de couverture de ligne : entrez une valeur pour bloquer les demandes de tirage où la couverture de ligne diminue de plus de ce nombre de points de pourcentage par rapport à la branche par défaut.

  7. Cliquez sur Créer ou Enregistrer les modifications.