Collaborer avec des dépôts distants

La collaboration implique souvent davantage que votre propre dépôt. Vous pouvez parfois contribuer à un projet open source ou travailler avec différents environnements de déploiement.

Git vous permet de gérer plusieurs dépôts distants pour un même projet local. Cette leçon vous montrera comment les configurer et les utiliser efficacement.

Un dépôt distant est essentiellement une version de votre projet hébergée sur Internet ou sur un réseau. Lorsque vous clonez un dépôt, Git configure automatiquement un dépôt distant nommé origin, qui pointe vers le dépôt d'origine.

Mais origin n'est qu'un nom par défaut ! Vous pouvez avoir plusieurs dépôts distants, chacun pointant vers un emplacement ou servant à un usage différent.

Pour voir quels dépôts distants sont actuellement configurés pour votre dépôt local, vous pouvez utiliser la commande git remote -v. Le -v signifie « détaillé » et affiche les URL associées à chaque dépôt distant.

Pour connecter votre dépôt local à un autre dépôt distant, utilisez git remote add. Vous lui attribuerez un nom court et mémorisable (comme upstream ou staging) et fournirez son URL.

Imaginez que vous avez créé un fork d'un projet open source. Votre fork est généralement nommé origin. Pour maintenir votre fork à jour avec les modifications du projet d'origine, vous pouvez ajouter le projet d'origine comme dépôt distant upstream.

Voici comment l'ajouter :

Une fois que vous avez plusieurs dépôts distants, vous pouvez télécharger les modifications depuis l'un d'eux sans les fusionner avec votre branche actuelle. Cela vous permet de voir ce qui a changé sur ce dépôt distant.

Utilisez git fetch <remote_name> pour cela.

Alors que git fetch télécharge uniquement les modifications, git pull les télécharge et les fusionne immédiatement avec votre branche actuelle. Vous pouvez préciser le dépôt distant et la branche depuis lesquels tirer les modifications.

C'est courant lorsque vous synchronisez votre fork (origin) avec le projet d'origine (upstream).

Par défaut, git push envoie vos modifications vers le dépôt distant origin. Cependant, vous pouvez diriger votre poussée vers n'importe quel dépôt distant configuré.

C'est utile pour déployer votre projet sur un serveur précis, ou pour pousser une branche de fonctionnalité vers un autre fork ou un environnement temporaire de test.

Vous pouvez gérer votre liste de dépôts distants :

• Renommer un dépôt distant : si son nom n'est plus pertinent, utilisez git remote rename <old_name> <new_name>.
• Supprimer un dépôt distant : si vous n'avez plus besoin de cette connexion, utilisez git remote remove <name>.

Vous avez créé un fork d'un projet et ajouté le dépôt d'origine comme dépôt distant upstream. Vous souhaitez mettre à jour votre branche locale main avec les dernières modifications de la branche main du projet d'origine.

Excellent travail ! Vous avez appris à gérer plusieurs dépôts distants :

• Utilisez git remote -v pour lister les dépôts distants configurés.
• Ajoutez de nouveaux dépôts distants avec git remote add <name> <url>.
• Récupérez les modifications de dépôts distants précis avec git fetch <remote>.
• Intégrez les modifications avec git pull <remote> <branch>.
• Poussez vers différents dépôts distants avec git push <remote> <branch>.

La maîtrise de plusieurs dépôts distants est essentielle pour collaborer à un niveau avancé, notamment dans les projets open source. Ensuite, vous découvrirez la collaboration GitHub avec les demandes de fusion !