install windows
Ce tutoriel vous accompagne dans l'installation et la configuration de git sur Windows. Au terme de ce tutoriel, vous serez en mesure d'utiliser git au sain du Git Bash sur votre machine ainsi que de synchroniser votre travail sur github.
Assurez-vous d'avoir déjà suivi le tutoriel quant à la création et à la configuration de votre compte github. Assurez vous entre autre d'avoir correctement configuré vos adresses emails, autant votre adresse personnelle que celle liée à votre compte ephec.
Prévoyez au minimum une trentaine de minutes pour suivre ce tutoriel.
L'installation de git sur Windows ressemble à l'installation de n'importe quel autre logiciel. Vous pouvez vous rendre sur le site officiel de git et télécharger un wizard qui vous accompagnera tout au long de l'installation de git sur votre machine, 19 étapes au total.
Prenez gare car git est avant toute chose un programme conçu pour tourner sur les systèmes POSIX (Linux, MacOS). L'installateur vous accompagnera dans l'installation de MSYS2: une couche de compatibilité entre les programmes conçus pour POSIX et Windows. Vous serez aussi invité à installer le Git bash, un terminal prévu pour lancer des programmes en utilisant cette couche de compatibilité.
Le programmation d'installation de Git sur Windows comporte 15 écrans où vous serez invité à faire des choix. Nous pouvons regretter que ce programme d'installation n'est pas plus simple mais c'est malheureusement le prix à payer pour faire fonctionner correctement un logiciel prévu pour Linux sur Windows.
Allez sur le site officiel de git: https://git-scm.com, sur la page prévue aux téléchargements pour windows et téléchargez la plus récente version 64-bit.
La 1e étape est simplement l'affichage de la licence de Git. Il s'agit de la licence GNU GPL v2, la même sous laquelle Linux est distribué. En bref, vous avez le droit de l'utiliser aussi à des fins privés ou commerciales. Vous avez le droit d'accéder au code source et à le modifier mais si vous décidez de distribuer ces modifications, vous devrez le faire sous licence GNU GPL v2, c'est à dire vous devrez rendre vos contributions open-source à votre tour.
La 2e étape vous demande le dossier où vous voulez installer git. git ne demande pas beaucoup d'espace disque et est rapide à charger. Vous pouvez l'installer n'importe où où vous avez au moins 300MO d'espace disque disponible.
La 3e étape vous demande quels sont les composants additionnels que vous voulez installer en plus de git.
-
Additional icons on the desktop
Cochez la case si vous voulez que des raccourcis soient ajoutés à votre bureau pour Git Bash et Git GUI.
Nous n'avons pas de recommandation
-
Windows Explorer integration, Git Bash Here, Git GUI Here
Cochez respectivement les deux cases Git Bash Here et Git GUI Here si vous voulez que des raccourcis soient ajoutés à votre menu clic droit lorsque vous êtes dans un dossier. L'avantage étant de pouvoir directement ouvrir un terminal git dans votre espace de travail au lieu de devoir taper plusieurs commandes
cdpour vous déplacer dans ce dossier.Nous recommandons de cocher cette option
-
Git LFS (Large File Support)
Git est prévu pour fonctionner au mieux avec des petits fichiers textes, certains projets utilisent beaucoup d'autres formats de fichiers comme des document words, des images, les PSD, ... Si vous pensez utiliser Git pour des projets qui utiliseront beaucoup ces fichiers, il peut être judicieux de cocher cette option.
Nous recommandons de ne pas cocher cette option comme le support pour LFS n'est pas activé par défaut sur Linux/MacOS
-
Associate .git* configuration files with the default text editor
Git vient avec plusieurs fichiers de configuration comme par exemple le fichier
.gitignore. En cochant cette option, ces fichiers seront ouvert avec votre éditeur de texte directement.Nous recommandons de cocher cette option
-
Associate .sh files to be run with Bash
Git vient avec plusieurs scripts qui peuvent être utilisés de manière indépendantes à git. Vous pouvez aussi avoir écrit des scripts shell qui ne peuvent d'ordinaire fonctionner qu'au sain du Windows Subsystem Linux. Puisque Git installe une couche de compatibilité pour Windows, vous pourrez aussi lancer ces scripts avec le Git Bash. Vous pouvez cocher cette option si désirer que ce soit le cas.
Nous n'avons pas de recommandation
-
Check daily for Git for Windows updates
Cochez cette option si vous voulez que votre ordinateur démarre plus lentement parce qu'il ira vérifier à chaque fois si il n'y a pas une mise à jour.
Nous n'avons pas de recommandation
-
(NEW!) Add a Git Bash Profile to Windows Terminal
Cochez cette case si vous voulez ça:
-
Scalar (Git add-on to manage large-scale repositories)
Cochez cette case si vous savez ce qu'est scalar et que vous comptez l'utiliser. Nous ne savons pas ce que c'est.
La 4e étape vous demande si vous voulez ajouter des raccourcis dans le menu démarrer et sous quel nom. Vous pouvez simplement passer à l'étape suivante sans rien changer.
La 5e étape vous demande de choisir votre éditeur de texte préféré. À chaque fois que vous devrez écrire un message de commit (en moyenne 10x par jour) cet éditeur de texte s'ouvrira et vous pourrez écrire votre message dedans.
Quelques éditeurs (nano, vim) viennent pré-installés avec Git. Pour les autres éditeurs, git utilisera celui qui est installé sur votre système.
La 6e étape vous demande si vous préférez utiliser le nom de branche pas défaut de git (qui est, en 2022, master) ou bien si vous souhaiter utiliser un autre nom de branche par défaut.
Nous vous conseillons de cocher la seconde option et d'y entrer le nom main tout en minuscule. Il s'agit du nom de branche par défaut pour les nouveaux projets créés sur github (qui elle n'est pas configurable).
La 7e étape vous demande si vous voulez :
- Rendre git utilisable uniquement dans le Git Bash 2. Rendre git utilisable à la fois dans le Git Bash ainsi que dans les autres terminaux de windows (cmd, powershell) ainsi que vos éditeurs de texte comme vscode mais sans casser les commandes de windows existantes. 3. Installer git ainsi que tout le shell Linux directement dans cmd et ainsi flinguer votre installation windows.
Nous vous recommandons d'utiliser l'une des deux premières options, en fonction de si vous voulez (2e option) ou non (1e option) profiter d'une intégration à git dans votre éditeur de texte.
La 8e étape vous demande si vous voulez installer un client SSH en même temps que git ou bien si vous voulez utiliser un client SSH déjà présent sur votre machine.
Lorsque vous ferez des opérations comme pull et push, vous pourrez soit utiliser HTTPS ou bien SSH. En utilisant SSH vous pourrez utiliser votre pair de clé publique/privé pour vous authentifier sur github. Depuis Windows 10, Microsoft inclus un client SSH au sain de Windows.
Si vous n'êtes pas sur d'avoir un client SSH installé, cochez la première case. Dans le cas contraire, et si vous voulez réutiliser la configuration de ce client pour git, vous pouvez cocher la seconde.
N'importe lequel des deux fonctionnera.
La 9e étape est similaire à la précédente. Dans ce cas-ci pour les connexions HTTPS. Pour qu'une connexion HTTPS puisse s'établir, il faut pouvoir vérifier le certificats reçu par le site. Dans ce cas-ci, il faut que git puisse vérifier le certificats de github.com.
Une liste de certificat "de confiance" doit être utilisé par git pour vérifier l'authenticité des sites. On vous demande ici si vous voulez installer une liste en plus ou si vous voulez utiliser les certificats contenus dans Windows.
N'importe lequel des deux fonctionnera.
La 10e étape est importante. Elle permet de réglé un problème de compatibilité entre Windows et Linux.
Sur Windows lorsque vous sauvegardez un fichier texte, Windows utilisera 2 caractères pour marquer le retour à la ligne: \r\n.
Sur Linux/MacOS lorsque vous sauvegardez un fichier texte, Linux/MacOS n'utilisera qu'un seul caractère pour marquer le retour à la ligne: \n.
Git propose une configuration pour automatiquement traduire \r\n vers \n lorsque vous sauvegardez votre travail et inversement traduire \n vers \r\n lorsque vous ouvrez les fichiers.
Nous vous recommandons vivement d'utiliser cette configuration (appelé core.autocrlf) car elle vous permet de travailler avec tout le monde, qu'importe votre système d'exploitation.
La 11e étape vous demande si vous voulez installer un terminal plus moderne que le cmd de Windows.
Les auteurs utilisent le nouveau terminal de Windows 10 et n'ont donc pas de recommandation à faire quant au choix présenté ici.
N'importe lequel des deux fonctionnera.
La 12e étape vous demande quelle stratégie de fusion de branche vous voulez utiliser par défaut avec la commande git pull. Nous apprendrons plus tard dans le cours quels sont les différences entre fast-forward, merge et rebase. Par soucis de cohérence avec ceux qui ont installé sur leur machine Linux ou MacOS, nous vous conseillons de laisser la méthode par défaut, c'est à dire fast-forward or merge
La 13e étape vous demande si vous voulez que git retienne vos informations de compte (login + mot de passe/passphrase) afin de ne pas systématiquement vous demander de ré-entrer votre mot de passe ou votre passphrase lorsque vous aller pull et push.
Si vous voulez que git se rappelle de votre compte, vous devez cocher la première case et installer le "Git Credential Manager". C'est le programme qui est responsable de revenir vos credentials. Grâce à ce programme vous pourrez aussi vous connecter à votre compte s'il est configuré pour utiliser la 2FA.
Nous vous recommandons d'installer le "Git Credential Manager" à moins que vous soyez sur que vous n'allez vous connecter à Github via Git que via pair de clé SSH.
Les 14e et 15e étapes sont des options supplémentaires. Sur les quatre options au total, nous vous recommandons de n'activer que la toute première, c'est-à-dire "Enable file system caching".
Nous laissons désactivé la seconde option qui concerne les liens symboliques. Ce type de lien n'est pas bien supporté sur Windows et nous recommandons de ne pas les utiliser. Nous recommandons aussi à ceux qui utilisent Linux/MacOS de ne pas les utiliser non plus par soucis de compatibilité avec Windows.
![experimental-options] (resources/install-windows/setup-15-experimental-options.png)
Une fois tous vos choix faits, vous pouvez lancer l'installation. Gardez en tête que la plupart des options ne sont pas tellement importantes et que vous devriez pouvoir utiliser git qu'importe la majorité de vos choix.
Au bout du programme d'installation, il reste encore quelques éléments à configurer comme par exemple votre nom et email pour la synchronisation avec Github.
Dorénavant, lorsque nous vous demanderons d'ouvrir un terminal, nous vous demandons en fait d'ouvrir Git Bash ou un quelconque terminal où il vous est possible d'utiliser git.
Ouvrez un terminal et suivez les mêmes instructions que dans le tutoriel sur la configuration de git dans Linux et MacOS. Gardez en tête qu'il ne vous est plus nécessaire de configure l'éditeur core.editor puisque cette étape a déjà été faite lors de l'installation.