Installer Git

Temps de lecture8 min

En bref

Résumé de l’article

Git est un logiciel à installer sur votre machine, indépendamment de GitLab qui n’est qu’un serveur. Cet article donne la procédure d’installation pour les trois systèmes, puis la configuration minimale obligatoire : votre nom et votre adresse électronique, que Git inscrira dans chacune de vos versions, ainsi que deux réglages qui garantissent que Git se comporte de la même façon sur toutes les machines de la classe. Installation et configuration se font en séance, au début de l’activité pratique, qui vous renvoie ici au bon moment. L’article vous servira ensuite de référence, pour installer Git sur une autre machine par exemple.

Visual Studio Code, installé en séance 2, reconnaît automatiquement les dépôts Git. Vous n’avez donc rien de plus à installer de ce côté.

Points clés à retenir

  • Git s’installe sur votre machine, GitLab est un serveur distant. Les deux sont indépendants : Git fonctionne parfaitement sans aucun serveur.
  • Quatre réglages sont obligatoires avant le premier commit (une seule fois) : user.name, user.email, init.defaultBranch et pull.rebase.
  • Vérifiez toujours l’installation dans un nouveau terminal : les variables d’environnement ne sont relues qu’à son ouverture.
  • Installer et configurer Git ne crée aucun dépôt. N’exécutez jamais git init « pour tester » : un dépôt créé dans votre dossier personnel ou à la racine du disque place tout votre ordinateur sous Git.

Contenu de l’article

Installer le logiciel

​

La façon la plus simple d’installer Git sur Windows 10/11 est de télécharger l’installeur « Git for Windows » 64 bits depuis git-scm.com/downloads/win, puis de le lancer.

Vous pouvez aussi passer par le gestionnaire de paquets WinGet :

winget install Git.Git

L’installeur pose de nombreuses questions ; les valeurs par défaut conviennent. Il installe au passage « Git Bash », un terminal de type Bash bien pratique sous Windows.

Sur Ubuntu et les distributions dérivées de Debian :

sudo apt update
sudo apt install git

Sur Fedora et les distributions dérivées de Red Hat :

sudo dnf update
sudo dnf install git git-all

Git est parfois déjà présent, installé avec les outils de développement en ligne de commande. Vérifiez-le avant de télécharger quoi que ce soit avec git --version.

Sinon, utilisez l’installeur de la page dédiée du site officiel, ou Homebrew :

brew install git

Vérifier l’installation

Ouvrez un nouveau terminal et demandez la version installée :

​
git --version
git --version
git --version
git --version

La commande doit afficher un numéro de version, 2.28 ou plus récent. Une version plus ancienne (système jamais mis à jour, par exemple) ne comprend pas tous les réglages ci-dessous : mettez Git à jour.

Important

Vérifier l’installation, c’est uniquement git --version. Ne tapez pas git init, et ne cliquez pas sur Initialize Repository dans VS Code : vous créeriez un dépôt Git dans le dossier où se trouve votre terminal, qui est souvent votre dossier personnel. Tous vos fichiers seraient alors suivis par Git, et le nettoyage est pénible. Les dépôts se créent dans un dossier de projet, et seulement là.

Configurer Git

Votre identité

Git inscrit dans chaque version qui l’a créée. Ces deux réglages sont donc obligatoires avant votre premier commit, et se font une fois pour toutes sur la machine (option --global) :

​
git config --global user.name "Ada Lovelace"
git config --global user.email ada.lovelace@imt-atlantique.net
git config --global user.name "Ada Lovelace"
git config --global user.email ada.lovelace@imt-atlantique.net
git config --global user.name "Ada Lovelace"
git config --global user.email ada.lovelace@imt-atlantique.net
git config --global user.name "Ada Lovelace"
git config --global user.email ada.lovelace@imt-atlantique.net
Important

Utilisez l’adresse électronique de l’école, celle avec laquelle vous vous connecterez à GitLab. Si les deux diffèrent, vos versions apparaîtront sur GitLab comme provenant d’un inconnu, et vous ne serez pas crédité(e) de votre travail.

Le comportement de Git

Deux autres réglages, eux aussi obligatoires pour l’UE, évitent que Git se comporte différemment d’une machine à l’autre :

  • init.defaultBranch main – historiquement, Git nommait master la branche créée par défaut. L’usage est aujourd’hui main, et c’est ce qu’attend GitLab. Sans ce réglage, selon la version de Git installée, votre projet démarrera sur master et la commande git push -u origin main du TP échouera.
  • pull.rebase false – indique à git pull de fusionner le travail distant avec le vôtre, plutôt que de réécrire votre historique. Sans ce réglage, les versions récentes de Git refusent le pull dès que vous et votre binôme avez tous les deux travaillé, avec le message Need to specify how to reconcile divergent branches.
​
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global init.defaultBranch main
git config --global pull.rebase false

Relire la configuration

Pour relire la configuration effective, et savoir de quel fichier chaque valeur provient :

​
git config --list --show-origin
git config --list --show-origin
git config --list --show-origin
git config --list --show-origin

Vous devez y trouver quatre lignes user.name=..., user.email=..., init.defaultbranch=main et pull.rebase=false, toutes issues du même fichier .gitconfig situé dans votre dossier personnel.

Pour aller plus loin

La documentation officielle

Le livre Pro Git, disponible gratuitement et en français, est la référence. Son chapitre « Paramétrage à la première utilisation » détaille tous les réglages évoqués ici.