Si vous disposez d’une vérification et d’un statut portant le même nom, et sélectionnez ce nom comme vérification de statut requise, la vérification et le statut sont obligatoires. Pour plus d’informations, consultez « Vérifications ».
Une que vous activé les vérifications de statut requises, il se peut que votre branche doive être mise à jour avec la branche de base avant la fusion. Cela garantit que votre branche a été testée avec le code le plus récent de la branche de base. Si votre branche est obsolète, vous devez la fusionner avec la branche de base. Pour plus d’informations, consultez « À propos des branches protégées ».
Remarque : vous pouvez également mettre à jour votre branche avec la branche de base à l’aide d’un rebasage Git. Pour plus d’informations, consultez « À propos de git rebase ».
Vous ne pourrez pas envoyer (push) des modifications locales à une branche protégée tant que toutes les vérifications de statut requises n’auront pas abouti. Au lieu de cela, vous recevrez un message d’erreur similaire à celui-ci :
remote: error: GH006: Protected branch update failed for refs/heads/main.
remote: error: Required status check "ci-build" is failingRemarque : les demandes de tirage à jour qui passent les vérifications de statut requises peuvent être fusionnées localement et envoyées (push) à la branche protégée. Cela peut être effectué sans vérification de statut sur la validation de fusion elle-même.
Conflits entre la validation principale et la validation de fusion test
Parfois, les résultats des vérifications de statut pour la validation de fusion test et la validation principale sont contradictoires. Si la validation de fusion test a un statut, elle doit aboutir. Autrement, le statut de la validation principale doit passer la vérification avant que vous puissiez fusionner la branche. Pour plus d’informations sur les commits de fusion test, consultez « Tirages ».
Gestion ignorée mais vérifications requises
Remarque : si un workflow est ignoré en raison d’un filtrage de chemin d’accès, d’un filtrage de branche ou d’un message de validation, les vérifications associées à ce workflow restent à l’état « En attente ». La fusion d’une demande de tirage nécessitant la réussite de ces vérifications sera bloquée.
Si un travail dans un workflow est ignoré en raison d’un paramètre conditionnel, il signale son statut comme « Réussite ». Pour plus d’informations, consultez Ignorer les exécutions de flux de travail et Utilisation de conditions pour contrôler l’exécution des travaux.
Exemple
L’exemple suivant montre un workflow nécessitant un statut d’accomplissement « Réussi » pour le travail build, mais le workflow est ignoré si la demande de tirage ne change aucun fichier dans le répertoire scripts.
name: ci
on:
pull_request:
paths:
- 'scripts/**'
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [12.x, 14.x, 16.x]
steps:
- uses: actions/checkout@v3
- name: Use Node.js ${{ matrix.node-version }}
uses: actions/setup-node@v3
with:
node-version: ${{ matrix.node-version }}
cache: 'npm'
- run: npm ci
- run: npm run build --if-present
- run: npm test
En raison du filtrage de chemin d’accès, une demande de tirage qui modifie uniquement un fichier à la racine du dépôt ne déclenche pas ce workflow et sa fusion est bloquée. Sur la demande de tirage (pull request), le message « Waiting for status to be reported » (En attente d’affichage de l’état) apparaît.
Vous pouvez corriger cela en créant un workflow générique du même nom, qui retournera la valeur true dans tout cas similaire au workflow ci-dessous :
name: ci
on:
pull_request:
paths-ignore:
- 'scripts/**'
jobs:
build:
runs-on: ubuntu-latest
steps:
- run: 'echo "No build required"'
Désormais, les vérifications aboutiront chaque fois qu’une personne enverra une demande de tirage qui ne modifie pas les fichiers répertoriés sous paths le premier workflow.
Remarques :
- Assurez-vous que la clé
nameet le nom de travail requis dans les deux fichiers de workflow sont identiques. Pour plus d’informations, consultez « Workflow syntax for GitHub Actions ». - L’exemple ci-dessus utilise GitHub Actions mais cette solution de contournement s’applique également à d’autres fournisseurs de CI/CD qui s’intègrent avec GitHub.
Vérifications d’état nécessaires à partir de sources inattendues
Il est également possible qu’une branche protégée exige une vérification de statut d’une GitHub App spécifique. Si vous voyez un message similaire au suivant, vous devez vérifier que la vérification répertoriée dans la zone de fusion a été définie par l’application attendue.
Required status check "build" was not set by the expected GitHub App.