Création d’une demande de tirage

Créez une demande de tirage pour proposer et collaborer sur des modifications apportées à un référentiel. Ces modifications sont proposées dans une branche, ce qui garantit que la branche par défaut contient uniquement le travail terminé et approuvé.

Qui peut utiliser cette fonctionnalité ?

Anyone with read access to a repository can create a pull request. Les membres d’une entreprise avec utilisateurs managés peuvent uniquement proposer des modifications dans les référentiels qui font partie de leur entreprise.

Platform navigation

Dans cet article

Si vous voulez créer une branche pour votre demande de tirage et que vous n’avez pas d’autorisations d’accès en écriture au dépôt, vous pouvez commencer par dupliquer (fork) le dépôt. Pour plus d’informations, consultez « Création d’une demande de tirage à partir d’une duplication » et « À propos des duplications (fork) ».

Vous pouvez spécifier la branche dans laquelle vous voulez fusionner vos changements quand vous créez votre demande de tirage. Vous pouvez ouvrir des demandes de tirage uniquement entre deux branches différentes.

Remarque : Pour ouvrir une demande de tirage dans un dépôt public, vous devez avoir un accès en écriture sur la branche principale ou la branche source ou, pour les dépôts appartenant à l’organisation, vous devez être membre de l’organisation propriétaire du dépôt afin d’ouvrir une demande de tirage.

Vous pouvez lier une demande de tirage à un problème pour montrer qu’un correctif est en cours et fermer automatiquement le problème lorsque quelqu’un fusionne la demande de tirage. Pour plus d’informations, consultez « Relier une demande de tirage à un problème ».

Changement de la plage de branches et du dépôt de destination

Par défaut, les demandes de tirage se basent sur la branche par défaut du dépôt parent. Pour plus d’informations, consultez « À propos des branches ».

Si le dépôt parent par défaut n’est pas correct, vous pouvez changer à la fois le dépôt parent et la branche à l’aide des listes déroulantes. Vous pouvez aussi permuter vos branches principale et de base à l’aide des listes déroulantes pour établir des différences entre les points de référence. Les références doivent ici correspondre à des noms de branche inclus dans votre dépôt GitHub.

Capture d’écran d’une demande de tirage. La liste déroulante permettant de modifier la branche de comparaison est développée.

En ce qui concerne les branches, n’oubliez pas que la branche de base correspond à l’emplacement auquel les changements doivent être appliqués (où) et que la branche principale contient ce que vous aimeriez appliquer (quoi).

Quand vous modifiez le dépôt de base, vous modifiez également les notifications de la demande de tirage. Toute personne en mesure de pousser (push) vers le dépôt de base reçoit une notification par e-mail et voit la nouvelle demande de tirage dans son tableau de bord lors de sa prochaine connexion.

Quand vous modifiez l’une des informations dans la plage de branches, les zones d’aperçu Commit et Fichiers modifiés sont mises à jour pour présenter votre nouvelle plage.

Conseils :

  • À l’aide de la vue comparative, vous pouvez configurer des comparaisons sur la période de votre choix. Pour plus d’informations, consultez « Comparaison des validations ».
  • Les chargés de maintenance du projet peuvent ajouter un modèle de demande de tirage pour un dépôt. Les modèles incluent des invites d’insertion d’informations dans le corps d’une demande de tirage. Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ».

Création de la demande de tirage

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

  2. Dans le menu « Branches », choisissez la branche qui contient vos commits.

    Capture d’écran du menu déroulant des branches dans la page principale d’un dépôt.

  3. Au-dessus de la liste des fichiers, dans la bannière jaune, cliquez sur Comparer et créer une demande de tirage afin de créer une demande de tirage pour la branche associée.

    Capture d’écran de la bannière au-dessus de la liste des fichiers.

  4. Utilisez le menu déroulant de la branche de base pour sélectionner la branche dans laquelle fusionner vos changements, puis utilisez le menu déroulant comparer : pour choisir la branche de rubrique dans laquelle vous avez apporté vos changements.

  5. Entrez un titre et une description pour votre demande de tirage.

  6. Pour créer une demande de tirage (pull request) prête à être examinée, cliquez sur Créer une demande de tirage. Pour créer un brouillon de demande de tirage, utilisez la liste déroulante et sélectionnez Créer un brouillon de demande de tirage, puis cliquez sur Brouillon de demande de tirage. Si vous êtes membre d’une organisation, vous devrez peut-être demander l’accès au brouillon des demandes de tirage à partir d’un propriétaire d’organisation. Consultez « À propos des demandes de tirage (pull requests) ».

Conseil : Après avoir créé une demande de tirage, vous pouvez demander à une personne spécifique de regarder les changements que vous proposez. Pour plus d’informations, consultez « Demande d’une évaluation de demande de tirage ».

Une fois votre demande de tirage révisée, vous pouvez la fusionner dans le dépôt.

Pour plus d’informations sur GitHub CLI, consultez « À propos de GitHub CLI ».

Pour créer une demande de tirage, utilisez la sous-commande gh pr create.

gh pr create

Pour affecter une demande de tirage à une personne, utilisez les indicateurs --assignee ou -a. Vous pouvez utiliser @me pour vous affecter la demande de tirage.

gh pr create --assignee "@octocat"

Pour spécifier la branche dans laquelle vous voulez que la demande de tirage soit fusionnée, utilisez les indicateurs --base ou -B. Pour spécifier la branche qui contient les commits de votre demande de tirage, utilisez les indicateurs --head ou -H.

gh pr create --base my-base-branch --head my-changed-branch

Pour inclure un titre et un corps dans la nouvelle demande de tirage, utilisez les indicateurs --title et --body.

gh pr create --title "The bug is fixed" --body "Everything works again"

Pour marquer une demande de tirage en tant que brouillon, utilisez l’indicateur --draft.

gh pr create --draft

Pour ajouter des étiquettes ou des jalons à la nouvelle demande de tirage, utilisez les indicateurs --label et --milestone.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

Pour ajouter la nouvelle demande de tirage à un projet spécifique, utilisez l’indicateur --project.

gh pr create --project octocat-project

Pour désigner une personne ou une équipe en tant que réviseurs, utilisez l’indicateur --reviewer.

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

Pour créer la demande de tirage dans votre navigateur web par défaut, utilisez l’indicateur --web.

gh pr create --web

  1. Cliquez sur Aperçu de la demande de tirage. GitHub Desktop ouvre une boîte de dialogue de prévisualisation montrant les différences des modifications entre votre branche actuelle et la branche de base.

    Capture d’écran de la vue « Aucune modification locale ». Un bouton intitulé « Prévisualiser une demande de tirage » est mis en évidence avec un encadré orange.

    Capture d’écran de la vue « Aucune modification locale ». Un bouton intitulé « Prévisualiser une demande de tirage » est mis en évidence avec un encadré orange.

    Sinon, pour accéder directement à GitHub pour créer votre demande de tirage, sélectionnez l’icône de liste déroulante et cliquez sur Créer une demande de tirage.

  2. Vérifiez que la branche dans le menu déroulant base : correspond à la branche dans laquelle vous souhaitez fusionner vos changements.

    Capture d’écran de la boîte de dialogue « Ouvrir une demande de tirage ». Un bouton avec une icône de liste déroulante, intitulé « base: development », est encadré en orange.

    GitHub Desktop vous indique si la branche actuelle peut être fusionnée automatiquement dans la branche de base.

    Capture d’écran de la boîte de dialogue « Ouvrir une demande de tirage ». Une étiquette d’état indiquant « Impossible de fusionner automatiquement » est mis en évidence avec un encadré orange.

  3. Cliquez sur Créer une demande de tirage. GitHub Desktop ouvre votre navigateur par défaut pour vous permettre d’accéder à GitHub.

  4. Entrez un titre et une description pour votre demande de tirage.

  5. Pour créer une demande de tirage (pull request) prête à être examinée, cliquez sur Créer une demande de tirage. Pour créer un brouillon de demande de tirage, utilisez la liste déroulante et sélectionnez Créer un brouillon de demande de tirage, puis cliquez sur Brouillon de demande de tirage. Si vous êtes membre d’une organisation, vous devrez peut-être demander l’accès au brouillon des demandes de tirage à partir d’un propriétaire d’organisation. Consultez « À propos des demandes de tirage (pull requests) ».

  1. Une fois que vous avez commité les changements apportés à votre copie locale du dépôt, cliquez sur l’icône Créer une demande de tirage.
    Capture d’écran du haut de la barre latérale « Contrôle de code source ». L’icône de demande de tirage (pull request) est mise en surbrillance avec un encadré orange foncé.
  2. Vérifiez que la branche locale, le dépôt à partir duquel vous effectuez la fusion, ainsi que la branche distante et le dépôt distant vers lesquels vous effectuez la fusion sont corrects. Donnez ensuite un titre et une description à la demande de tirage.
    Capture d’écran de la barre latérale « GitHub Demande de tirage (pull request) » avec un formulaire permettant de créer une demande de tirage, y compris les champs « Titre » et « Description ».
  3. Cliquez sur Créer.

Pour plus d’informations sur la création de demandes de tirage dans GitHub Codespaces, consultez « Utilisation de GitHub Codespaces pour les demandes de tirage ».

Pour aller plus loin