Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

À propos des vérifications d’état

Les vérifications d’état vous indiquent si vos commits remplissent les conditions définies pour le dépôt auquel vous contribuez.

Les vérifications d’état sont basées sur des processus externes, tels que des builds d’intégration continue, qui s’exécutent pour chaque envoi (push) que vous effectuez vers un référentiel. Vous pouvez voir l’état en attente, en cours de passage ou en échec des vérifications d’état en regard des validations individuelles dans votre demande de tirage.

Liste des validations et des états

Toute personne disposant d’autorisations d’écriture dans un référentiel peut définir l’état pour toute vérification d’état dans le référentiel.

Vous pouvez afficher l’état global de la dernière validation sur une branche sur la page des branches de votre référentiel ou dans la liste des demandes de tirage.

Si des vérifications d’état sont requises pour un référentiel, vous devez effectuer celles-ci avant de pouvoir fusionner votre branche dans la branche protégée. Pour plus d’informations, consultez « À propos des branches protégées ».

Types de vérifications d’état sur GitHub

Il existe deux types de vérifications d’état sur GitHub :

  • Vérifications
  • États

Les vérifications sont différentes des états car elles fournissent des annotations de ligne, une messagerie plus détaillée et sont uniquement disponibles pour une utilisation avec GitHub Apps.

Les propriétaires et les utilisateurs de l’organisation disposant d’un accès d’envoi (push) à un référentiel peuvent créer des vérifications et des états avec l’API de GitHub. Pour plus d’informations, consultez « Vérifications » et « États ».

Vérifications

Lorsque des vérifications sont configurées dans un référentiel, les demandes de tirage ont un onglet Vérifications dans lequel vous pouvez afficher la sortie détaillée de build à partir des vérifications d’état et réexécuter les vérifications ayant échoué.

Vérifications d’état dans une demande de tirage

Remarque : l’onglet Vérifications est rempli uniquement pour les demandes de tirage si vous configurez des vérifications et non des états, pour le référentiel.

Lorsqu’une ligne spécifique d’une validation entraîne l’échec d’une vérification, vous verrez des détails sur la défaillance, l’avertissement ou l’avis en regard du code approprié sous l’onglet Fichiers de la demande de tirage.

Détails d’une vérification d’état

Vous pouvez naviguer entre les résumés des vérifications pour différentes validations dans une demande de tirage, à l’aide du menu déroulant de validation sous l’onglet Conversation.

Vérifier les résumés des différentes validations dans un menu déroulant

Ignorer et demander des vérifications pour les validations individuelles

Lorsqu’un référentiel est défini pour demander automatiquement des vérifications pour les envois push, vous pouvez choisir d’ignorer les vérifications pour une validation individuelle que vous envoyez. Lorsqu’un référentiel n’est pas défini pour demander automatiquement des vérifications pour les envois push, vous pouvez choisir d’ignorer les vérifications pour une validation individuelle que vous envoyez. Pour plus d'informations sur ces paramètres, consultez « Vérifier les suites ».

Vous pouvez également ignorer les exécutions de workflow déclenchées par les événements push et pull_request en incluant une commande dans votre message de commit. Pour plus d’informations, consultez « Exécutions de workflow ignorées ».

Sinon, pour ignorer ou demander toutes les vérifications pour votre commit, ajoutez l’une des lignes de code de fin suivantes à la fin de votre message de commit :

  • Pour ignorer des vérifications pour une validation, entrez votre message de validation ainsi qu’une description courte et explicite de vos modifications. Après la description de votre validation, avant de fermer la quotation, ajoutez deux lignes vides suivies de skip-checks: true :
    $ git commit -m "Update README
    >
    >
    skip-checks: true"
  • Pour demander des vérifications pour une validation, entrez votre message de validation ainsi qu’une description courte et explicite de vos modifications. Après la description de votre validation, avant de fermer la quotation, ajoutez deux lignes vides suivies de request-checks: true :
    $ git commit -m "Refactor usability tests
    >
    >
    request-checks: true"

Conservation des vérifications d’état

Vérifie que les données datant de plus de 400 jours sont archivées. Dans le cadre du processus d’archivage GitHub crée un état de commit cumulatif représentant l’état de toutes les vérifications de ce commit. Par conséquent, la zone de fusion dans toute demande de tirage avec des vérifications archivées qui sont nécessaires sera dans un état bloqué, et vous devrez réexécuter les vérifications avant de pouvoir fusionner la demande de tirage.