Création d’une demande de tirage à partir d’une duplication

Vous pouvez créer une demande de tirage pour proposer des modifications apportées à une duplication d’un référentiel en amont.

Qui peut utiliser cette fonctionnalité ?

Anyone with write access to a repository can create a pull request from a user-owned fork.

Si votre demande de tirage (pull request) compare votre branche de rubrique à une branche dans le référentiel en amont définie comme branche de base, votre branche de rubrique est également appelée « branche de comparaison » de la demande de tirage (pull request).

Par exemple :

  • Votre branche de rubrique (également appelée « branche de fonctionnalité ») est la branche dans laquelle vous apportez vos modifications dans votre référentiel fourche (par exemple my-topic-branch).
  • Le branche de base est la branche dans le référentiel amont (central) dans lequel vous souhaitez fusionner vos modifications (par exemple main).
  • La demande de tirage compare les modifications proposées par la branche de rubrique (my-topic-branch) à la branche de base (main), ainsi my-topic-branch est connue sous le nom de « branche de comparaison ».

Pour plus d’informations sur les branches de demande de tirage, y compris des exemples, consultez « Création d’une demande de tirage ».

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.

  1. Accédez au dépôt d’origine où vous avez créé votre duplication.

  2. 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.

  3. Dans la page pour créer une demande de tirage, cliquez sur Comparer entre les duplications.

    Capture d’écran de la page permettant d’ouvrir une demande de tirage. Le lien « Comparer entre les duplications » est indiqué en orange foncé.

  4. Dans le menu déroulant « branche de base », sélectionnez la branche du dépôt en amont où vous voulez fusionner les changements.

    Capture d’écran de la page permettant d’ouvrir une nouvelle demande de tirage. Les menus déroulants permettant de choisir le dépôt et la branche de base sont indiqués en orange foncé.

  5. Dans le menu déroulant « duplication principale », sélectionnez votre duplication, puis utilisez le menu déroulant « comparer la branche » pour sélectionner la branche où vous avez fait vos changements.

    Capture d’écran de la page permettant d’ouvrir une nouvelle demande de tirage. Les menus déroulants permettant de choisir le dépôt principal et la branche de comparaison sont indiqués en orange foncé.

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

  7. Sur les duplications appartenant à l’utilisateur, si vous souhaitez autoriser toute personne disposant d’un accès push au dépôt en amont à apporter des modifications à votre demande de tirage, sélectionnez Autoriser les modifications des mainteneurs.

    Avertissement : Si votre duplication contient des workflows GitHub Actions, l’option est Autoriser les mainteneurs à apporter des modifications et à accéder aux secrets. L’autorisation de modifier sur la branche d’une duplication qui contient des workflows GitHub Actions autorise également le mainteneur à modifier les workflows du dépôt dupliqué, ce qui peut révéler des valeurs de secrets et accorder l’accès à d’autres branches.

  8. 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 ».

Pour aller plus loin