Comment vérifier si un dépôt Git distant possède une branche spécifique

Introduction

Dans ce laboratoire (lab), vous apprendrez à vérifier si une branche spécifique existe dans un dépôt distant Git. Nous explorerons différentes méthodes pour y parvenir, en commençant par la commande git branch -r pour lister les branches distantes.

Ensuite, vous découvrirez la polyvalence de la commande git ls-remote, qui vous permet de lister les références, y compris les branches, directement à partir d'une URL distante sans avoir besoin de la configurer localement. Enfin, vous apprendrez à vérifier l'existence d'une branche spécifique sur un dépôt distant configuré.

Skills Graph

Exécuter git branch -r pour lister les branches

Dans cette étape, nous allons apprendre à voir les branches qui existent dans un dépôt Git distant. Bien que nous n'ayons pas encore connecté à un dépôt distant, comprendre cette commande est crucial pour travailler avec d'autres personnes ou avec des plateformes en ligne telles que GitHub ou GitLab.

La commande pour lister les branches distantes est git branch -r.

Essayons de l'exécuter maintenant. Comme nous n'avons pas encore configuré de dépôts distants, vous ne verrez aucun résultat, mais c'est une bonne pratique de voir comment fonctionne la commande :

git branch -r

Vous ne devriez voir aucun résultat, comme prévu.

Pourquoi cette commande est-elle utile ? Lorsque vous travaillez sur un projet avec d'autres personnes, elles peuvent créer de nouvelles branches dans un dépôt distant partagé. La commande git branch -r vous permet de voir quelles branches existent sur ce dépôt distant, afin que vous sachiez quel travail est en cours et quelles branches vous pourriez vouloir télécharger sur votre machine locale.

Imaginez cela comme vérifier l'inventaire d'une bibliothèque partagée. Vous voulez voir quels livres (branches) sont disponibles avant de décider lequel emprunter (checkout).

Dans les étapes suivantes, nous explorerons d'autres méthodes pour vérifier les branches distantes, qui peuvent être utiles dans différents scénarios.

Utiliser git ls-remote pour vérifier les branches

En plus de git branch -r, une autre commande puissante pour vérifier les branches distantes est git ls-remote. Cette commande est plus générale et peut lister les références (comme les branches et les tags) d'un dépôt distant sans les télécharger (fetch) au préalable.

La syntaxe de base est git ls-remote <remote_url>.

Comme nous n'avons pas configuré de dépôt distant dans notre dépôt actuel, utilisons un dépôt Git public pour illustrer. Nous allons utiliser le dépôt Git officiel hébergé sur kernel.org.

Exécutez la commande suivante dans votre terminal :

git ls-remote https://git.kernel.org/pub/scm/git/git.git

Vous verrez beaucoup de résultats ! Ces résultats listent diverses références dans le dépôt distant, y compris les branches et les tags. Recherchez les lignes contenant refs/heads/. Elles représentent les branches sur le dépôt distant.

<some_hash>     refs/heads/master
<some_hash>     refs/heads/next
<some_hash>     refs/heads/pu
<some_hash>     refs/heads/topic/add-options-to-git-config
...

La commande git ls-remote est utile lorsque vous souhaitez rapidement voir ce qui est disponible sur un dépôt distant sans l'ajouter à votre dépôt local ni télécharger toutes les données. C'est comme jeter un coup d'œil au catalogue d'une bibliothèque distante sans réellement visiter la bibliothèque.

Alors que git branch -r vous montre les branches distantes dont votre dépôt local est au courant (généralement après un git fetch), git ls-remote interroge directement le dépôt distant. Cela rend git ls-remote utile pour vérifier un dépôt distant que vous n'avez pas encore ajouté à votre configuration locale.

Vérifier avec un dépôt distant spécifique

Dans l'étape précédente, nous avons utilisé git ls-remote avec une URL complète. Vous pouvez également utiliser git ls-remote avec le nom d'un dépôt distant déjà configuré dans votre dépôt local.

Tout d'abord, ajoutons un dépôt distant à notre dépôt actuel. Nous allons ajouter le même dépôt Git de kernel.org en tant que dépôt distant nommé kernel_git.

Exécutez la commande suivante :

git remote add kernel_git https://git.kernel.org/pub/scm/git/git.git

Cette commande ajoute un dépôt distant nommé kernel_git pointant vers l'URL spécifiée. Elle ne produira aucun résultat si elle réussit.

Maintenant, utilisons git ls-remote avec le nom du dépôt distant :

git ls-remote kernel_git

Vous devriez voir le même résultat que lorsque vous avez utilisé l'URL complète dans l'étape précédente.

<some_hash>     refs/heads/master
<some_hash>     refs/heads/next
<some_hash>     refs/heads/pu
<some_hash>     refs/heads/topic/add-options-to-git-config
...

Utiliser git ls-remote avec le nom d'un dépôt distant est pratique lorsque vous avez déjà ajouté le dépôt distant à votre configuration. Cela vous évite de taper l'URL complète à chaque fois.

Vous pouvez également spécifier le type de références que vous souhaitez voir. Par exemple, pour ne voir que les branches, vous pouvez ajouter refs/heads :

git ls-remote kernel_git refs/heads

Cela filtrera le résultat pour n'afficher que les branches.

<some_hash>     refs/heads/master
<some_hash>     refs/heads/next
<some_hash>     refs/heads/pu
<some_hash>     refs/heads/topic/add-options-to-git-config
...

Cela démontre la flexibilité de git ls-remote pour inspecter les dépôts distants.

Résumé

Dans ce laboratoire (lab), nous avons appris à vérifier les branches d'un dépôt Git distant en utilisant deux méthodes principales. Tout d'abord, nous avons exploré la commande git branch -r, qui liste les branches de suivi distantes dont votre dépôt local est au courant. Bien que cette commande n'affiche initialement aucun résultat sans un dépôt distant configuré, comprendre son utilité est essentiel pour voir les branches sur les dépôts partagés. Ensuite, nous sommes passés à la commande plus polyvalente git ls-remote. Cette commande nous permet d'interroger directement un dépôt distant (même sans configuration locale du dépôt distant) pour obtenir ses références, y compris les branches, en fournissant l'URL du dépôt distant. Nous avons démontré cela en listant les références d'un dépôt Git public, en observant comment les lignes contenant refs/heads/ indiquent les branches. Ces méthodes offrent différentes façons de vérifier l'existence de branches spécifiques sur un dépôt distant, ce qui est essentiel pour les flux de travail collaboratifs et l'interaction avec les plateformes Git en ligne.