Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Dépôts distants : fetch, pull, push

Dépôts distants : fetch, pull, push

Travailler à plusieursintermediaire

Un dépôt distant est un dépôt comme un autre, ailleurs. Git ne le contacte jamais de lui-même.

git remote -v
origin  https://github.com/equipe/boutique.git (fetch)
origin  https://github.com/equipe/boutique.git (push)

Trois commandes, trois niveaux de risque.

git fetch          # récupère, ne touche à rien          → sans risque
git pull           # fetch + fusion dans votre branche   → peut créer un conflit
git push           # envoie vos commits                  → visible par tous

origin/main n'est pas la branche du serveur : c'est sa copie locale, figée au dernier fetch. C'est pourquoi Git peut afficher « à jour » alors que trois commits sont arrivés il y a une heure.

git fetch
git log main..origin/main --oneline    # ce qui est arrivé, sans l'intégrer

Ce réflexe — fetch puis regarder — évite de lancer une fusion à l'aveugle juste avant de partir déjeuner.

Au premier envoi d'une branche :

git push -u origin feat/vider-panier

-u établit le suivi : les push et pull suivants n'ont plus besoin d'argument, et git status peut dire si vous êtes en avance ou en retard.

Les termes à connaître

Dépôt distant (remote)

Dépôt hébergé ailleurs, désigné par un nom court — origin par convention. Un dépôt local peut en avoir plusieurs, par exemple origin pour son fork et upstream pour le projet d'origine.

Branche de suivi distante

origin/main : la copie locale de l'état de main sur le serveur, au moment du dernier fetch. Elle ne bouge jamais toute seule, ce qui explique les messages « votre branche est en retard de 3 commits ».

git fetch

Récupère les commits du distant et met à jour les branches de suivi, sans toucher à votre travail. Opération sans aucun risque : elle ne modifie ni vos fichiers ni vos branches locales.

git pull

Un fetch suivi d'un merge (ou d'un rebase selon la configuration). C'est le merge implicite qui surprend : pull peut créer un commit ou déclencher un conflit.

Upstream

Branche distante qu'une branche locale suit. git push -u origin ma-branche l'établit : les push et pull suivants n'ont plus besoin d'argument.

Fork

Copie serveur d'un dépôt, sous votre compte. Permet de contribuer à un projet sur lequel on n'a pas le droit d'écrire : on pousse sur son fork, et on propose une pull request vers l'original.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.