Comment créer une pull request sur Github : 15 étapes (avec photos)

Table des matières:

Comment créer une pull request sur Github : 15 étapes (avec photos)
Comment créer une pull request sur Github : 15 étapes (avec photos)

Vidéo: Comment créer une pull request sur Github : 15 étapes (avec photos)

Vidéo: Comment créer une pull request sur Github : 15 étapes (avec photos)
Vidéo: Installer des application sur Ipad nécessitant IOS 10 minimum ! 2024, Mars
Anonim

Avant de faire une pull request sur Github, vous devrez créer votre propre branche à partir de la branche master et vous assurer qu'elle est à jour. Après cela, vous êtes libre d'apporter et de valider des modifications sans affecter la branche principale. Une fois le commit effectué, vous pouvez créer la Pull Request sur GitHub, puis fusionner vos modifications dans la branche principale. Vous pouvez utiliser à la fois la ligne de commande Git et l'interface Web Github pour effectuer une grande partie de ce processus.

Pas

Partie 1 sur 3: Création d'une nouvelle branche

Créer une demande de tirage sur Github Étape 1
Créer une demande de tirage sur Github Étape 1

Étape 1. Ouvrez Git

Si vous n'avez pas encore de programme Git, accédez à https://git-scm.com/downloads et choisissez un programme d'installation pour la plate-forme que vous utilisez.

Si vous configurez git pour la première fois, vous devez également cloner ou importer/créer un référentiel avant d'y contribuer

Créer une demande de tirage sur Github Étape 2
Créer une demande de tirage sur Github Étape 2

Étape 2. Accédez à votre répertoire de projets

Entrez « cd » dans la ligne de commande et appuyez sur ↵ Entrée, où se trouve la chaîne de répertoires qui mène à l'endroit où vous avez cloné ou créé votre dossier de projet.

Vous pouvez faire glisser et déposer le dossier dans la fenêtre de commande Git pour remplir automatiquement le chemin du répertoire

Créer une demande de tirage sur Github Étape 3
Créer une demande de tirage sur Github Étape 3

Étape 3. Assurez-vous que votre référentiel est à jour

Entrez "git pull origin master" dans la ligne de commande et appuyez sur Entrée. Un message apparaîtra pour vous informer que le référentiel est à jour.

Master est la branche par défaut d'un projet

Créer une demande de tirage sur Github Étape 4
Créer une demande de tirage sur Github Étape 4

Étape 4. Accédez à la page du référentiel github

Ouvrez votre navigateur Web et entrez l'URL github unique de votre référentiel.

Créer une demande de tirage sur Github Étape 5
Créer une demande de tirage sur Github Étape 5

Étape 5. Cliquez sur la liste déroulante « branche: maître » »

Ceci est situé dans le coin supérieur gauche de la page et ouvrira une liste d'autres branches et une zone de texte.

Créer une demande de tirage sur Github Étape 6
Créer une demande de tirage sur Github Étape 6

Étape 6. Entrez un nom de branche et cliquez sur "Créer une branche" lorsqu'il apparaît

Cela créera une nouvelle branche à partir de la branche principale en utilisant le nom que vous avez entré dans la zone de texte.

  • Vous pouvez également créer une branche à partir de la ligne de commande. Entrez « git checkout branch -b » et appuyez sur ↵ Entrée, où est ce que vous voulez que votre branche soit appelée.
  • Vous pouvez maintenant utiliser "git commit" et "git push" pour apporter en toute sécurité des modifications à votre branche sans affecter le projet principal. Faire une demande d'extraction permettra aux autres d'examiner et de discuter de vos modifications avant de les fusionner à nouveau dans la branche principale.
Créer une demande de tirage sur Github Étape 7
Créer une demande de tirage sur Github Étape 7

Étape 7. Validez les modifications dans votre nouvelle branche

Cliquez sur l'icône Crayon pour modifier un fichier sur le référentiel. Une fois les modifications effectuées, saisissez un message de validation et cliquez sur « Valider » dans la fenêtre située sous la zone d'édition.

  • Vous pouvez également effectuer des commits à partir de la ligne de commande. Ceci est utile lorsque vous apportez des modifications aux fichiers localement plutôt que sur le site Web de git. Entrez « git commit -m » dans la ligne de commande et appuyez sur Entrée après avoir modifié un fichier. devrait être une brève description des modifications que vous avez apportées.
  • Le texte du message de validation peut être n'importe quoi, mais quelque chose ici est requis.

Partie 2 sur 3: Faire une demande de tirage

Créer une demande de tirage sur Github Étape 8
Créer une demande de tirage sur Github Étape 8

Étape 1. Cliquez sur l'onglet « Pull Requests »

Ceci est situé le long de la barre de menu supérieure sur votre page de référentiel.

Une Pull Request est une fonctionnalité Git utilisée pour présenter les modifications apportées sur les branches indépendantes pour examen par les collaborateurs avant d'être fusionné dans le projet principal

Créer une demande de tirage sur Github Étape 9
Créer une demande de tirage sur Github Étape 9

Étape 2. Sélectionnez la branche que vous avez créée dans la liste

Cela affichera les modifications que vous avez apportées par rapport au contenu d'origine sur la branche principale.

Créer une demande de tirage sur Github Étape 10
Créer une demande de tirage sur Github Étape 10

Étape 3. Cliquez sur « Créer une demande de tirage »

Une fois que vous êtes satisfait de l'état de vos modifications, c'est le bouton vert en haut à gauche, à côté de la liste déroulante de la branche.

Créer une demande de tirage sur Github Étape 11
Créer une demande de tirage sur Github Étape 11

Étape 4. Saisissez un nom/description pour votre pull request

Utilisez ces champs pour identifier et décrire brièvement le changement que vous apportez aux autres collaborateurs.

Créer une demande de tirage sur Github Étape 12
Créer une demande de tirage sur Github Étape 12

Étape 5. Cliquez sur « Créer une demande de tirage »

Cela créera la demande d'extraction avec le nom et la description saisis.

Partie 3 sur 3: Fusion d'une demande de tirage

Créer une demande de tirage sur Github Étape 13
Créer une demande de tirage sur Github Étape 13

Étape 1. Cliquez sur « Fusionner la demande d'extraction »

Ce bouton apparaît en bas à droite une fois la demande de tirage créée avec succès.

Vous pouvez également utiliser « git merge » dans la ligne de commande pour effectuer la même action

Créer une demande de tirage sur Github Étape 14
Créer une demande de tirage sur Github Étape 14

Étape 2. Cliquez sur « Confirmer la fusion »

Une notification apparaîtra pour vous informer que la demande d'extraction a été fusionnée avec succès dans la branche principale. Étant donné que votre branche n'est plus nécessaire, vous serez invité à la supprimer.

Si vous rencontrez des conflits de fusion, vous en serez averti et vous ne pourrez pas procéder à la fusion. Vous devrez revenir en arrière et extraire à nouveau de la branche principale pour mettre votre propre branche à jour avec toutes les modifications, puis créer une nouvelle demande d'extraction

Créer une demande de tirage sur Github Étape 15
Créer une demande de tirage sur Github Étape 15

Étape 3. Cliquez sur « Supprimer la branche »

Cela apparaîtra dans la notification à côté de l'icône de branche violette. La suppression des branches fusionnées et obsolètes est un bon moyen de garder un projet organisé et facile à gérer.

Des astuces

  • Des conflits de fusion peuvent se produire si des modifications ont été transmises au master depuis que vous avez effectué vos modifications sur votre branche distincte. Vous devrez extraire ces modifications de master vers votre propre branche et créer une nouvelle demande d'extraction afin de réussir la fusion.
  • Avec la pratique, de nombreux collaborateurs logiciels trouvent que la ligne de commande Git est plus efficace que l'utilisation d'une interface graphique.

Conseillé: