Git sous Windows
Contexte​
Généralités​
Git est le logiciel de gestion de versions décentralisé utilisé sous ForgeMIA. C'est un logiciel libre créé par Linus Torvalds, auteur du noyau Linux, et distribué selon les termes de la licence publique générale GNU version 2. De par sa conception, Git est prévu pour être utilisé sous Linux.
L'utilisation de Git sous Windows est possible mais pas aussi simplement et naturellement que sous Linux. L'utilisateur qui souhaite néanmoins utiliser Git sous Windows doit être conscient de cet état de fait, et doit maîtriser l'ensemble du processus Git (SSH, échange de clefs, commande basique…).
SSH, Git et éventuellement Bash ne sont pas nativement présent sous Windows, il est nécessaire d'avoir un compte Administrateur sur sa machine pour l'installation.
Git for Windows : Git Bash​
Nous recommandons d'utiliser Git for Windows, anciennement MSysGit.
Dans cette documentation, nous utilisons Git Bash. Cela va vous donner accès à Git ainsi qu’à une console émulant le comportement de Bash (interpréteur de commande sous Linux) ainsi vous aurez accès aux mêmes commandes que tout le monde (ls, cd, mkdir…).
Les autres outils Git GUI et Shell Integration proposés par Git for Windows sont utilisables mais non documentés ici.
Téléchargement & Installation​
Télécharger et installer la dernière version disponible : https://github.com/git-for-windows/git/releases/latest
Une fois le fichier récupéré, lancez-le et suivez les instructions. Vous pouvez indiquer Use Git from Git Bash only afin de bien séparer Git du reste du système. Pour le reste laisser toutes les configurations par défaut. Maintenant vous allez pouvoir ouvrir l’application Git Bash dans votre menu Démarrer.
Configuration​
Générer une paire de clés RSA​
Nous vous déconseillons fortement d'utiliser PuTTY pour générer les clefs SSH, car nous avons constaté des problèmes de compatibilité. Utiliser plutôt les commandes usuelles ssh-keygen disponibles dans Git Bash.
Dans la console Git Bash :
ssh-keygen -t rsa -C "adresse.mail@domaine.tld" -b 4096
Utiliser les choix prédéfinis, il n'est pas indispensable de définir une passphrase.
Les fichiers C:\Users\<user>\.ssh\id_rsa et C:\Users\<user>\.ssh\id_rsa.pub ont été créés.
Il faut maintenant ajouter la clef publique précédemment créé à ForgeMIA, copier la clef publique :
cat ~/.ssh/id_rsa.pub | clip
Et coller dans le champ Key de votre profil GitLab, compléter le reste.
Vérification de l’authentification​
ssh -T git@forgemia.inra.fr
La réponse est : Welcome to GitLab, Prénom Nom!
Vous pouvez utiliser normalement Git sur votre machine à travers la console Git Bash. L'ensemble des commande git clone, git pull… sont disponibles.
Git : instructions initiales​
Pour terminer, suivre les Command line instructions présentes sur la page d'accueil quand vous avez créé un projet.