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 :

RemotePointe versSert à
originTon forkPousser tes modifications
upstreamLe projet originalRécupérer les nouveautés
Projet originalupstreamTon forkoriginTa machinelocalForkPull requestgit clonegit push origingit pull upstream
On tire depuis 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.