Au chapitre précédent, on a vu les pull requests et les forks. Mais il manquait un point très important : comment récupérer les nouvelles modifications du projet original dans ton fork ?
Le problème
Ton fork est une copie du projet, faite à un instant donné. Pendant que tu travailles, d’autres développeurs font merger leurs pull requests dans le projet original. Ton fork, lui, ne se met pas à jour tout seul.
La solution : le remote upstream
Ton projet local connaît deux dépôts distants :
| Remote | Pointe vers | Sert à |
|---|---|---|
origin | Ton fork | Pousser tes modifications |
upstream | Le projet original | Récupérer les nouveautés |
upstream, on pousse vers origin, et la pull request fait le dernier pas.Pour voir les remotes configurés, ouvre le fichier .git/config du projet, ou lance :
git remote -v
# origin https://github.com/ton-compte/le-projet.git (fetch)
# origin https://github.com/ton-compte/le-projet.git (push)
# upstream https://github.com/proprietaire/le-projet.git (fetch)
# upstream https://github.com/proprietaire/le-projet.git (push)
Certains outils, comme GitHub Desktop, ajoutent upstream automatiquement. S’il n’y est pas, ajoute-le à la main, avec l’URL du projet original :
git remote add upstream https://github.com/proprietaire/le-projet.git
Récupérer les modifications
git pull upstream master
Remplace master par la branche que tu veux récupérer.
Le cycle complet
# Récupérer les nouveautés du projet original
git pull upstream master
# Envoyer tes modifications sur ton fork
git push origin feature/1
# Puis ouvrir une pull request vers le projet original
Retiens la règle : on tire depuis upstream, on pousse vers origin. Les pushes vont toujours sur ton fork, et c’est la pull request qui fait passer les modifications dans le projet original.
Exercice · Ajoute le remote manquant
git remote -v n’affiche que origin. Le projet original est https://github.com/symfony/demo.git, et sa branche principale est main. Ajoute upstream, puis récupère ses dernières modifications.
Voir la solution
git remote add upstream https://github.com/symfony/demo.git
git remote -v
git pull upstream main
La suite
À force de créer des branches, la liste s’allonge vite. Au prochain chapitre, on fait le ménage dans les branches.
Ceci est le chapitre 9 du cours Git en pratique. Suis la série pour apprendre à utiliser Git au quotidien et en équipe.