mathObject.o
-
Nicolas Fley authoredNicolas Fley authored
TP: introduction à Git
Bienvenu à toi, lecteur ! Ce TP a pour objectif de t'aider à prendre en main Git en mettant les mains dans le cambouis. Mais surtout pas de panique si tu n'as jamais utilisé Git ! Ce TP reprend tout de plus le début, mais a été pensé pour faire suite à une présentation théorique.
Prérequis
Pour pouvoir faire ce TD, il te faudra le logiciel Git installé sur ton ordinateur :
- Si tu es sous Linux ou Mac, git est normalement déjà installé.
- Si tu es sous Windows, je te conseille d'installer GitBash.
Ce TP va aussi utiliser l'éditeur de code VSCode. Je te conseille de l'utiliser aussi pour plus de clarté mais tu peux utiliser un autre éditeur de code.
Maintenant que les prérequis sont installés, il est temps de se lancer !
Partie 0 : Configuration de Git et du Gitlab de ViaRézo
Avant de pouvoir utiliser Git, il y a quelques configuration à faire.
Ajout d'un nom et email dans Git
Pour que les modifications que tu feras sur le repository soient identifiables, il faut fournir un nom et une adresse email. Pour faire cette configuration, ouvre GitBash (ou un terminal pour Mac/Linux) et entre les commandes suivantes en remplaçant nom et adresse email :
git config --global user.name "<votre nom>"
git config --global user.email "<votre adresse email>"
Git sait maintenant qui tu es et le nom choisi sera associé aux modifications que tu feras.
Paramètre de connexion au serveur Gitlab
Lorsque l'on utilise Git, le code est stocké sur un serveur distant, le GitLab.
Dans le cas où le projet Gitlab n'est pas public, il faudra s'authentifier pour pouvoir synchroniser les fichiers entre le serveur Gitlab et ton ordinateur. Gitlab propose deux manières de s'authentifier :
- L'indentification par nom d'utilisateur/mot de passe. Par défaut, Gitlab demandera un identifiant (2022nompr) et un mot de passe lorsque ce sera nécessaire, l'accès au répo par cette méthode a été bloquée sur ce GitLab (c'est pas une grande perte). De fait, on passe par la seconde méthode.
- Il existe alors une deuxième méthode pour s'authentifier : le protocole ssh. Les étapes pour s'identifier sont détaillées en-dessous.
Paramétrer l'authentification par clé ssh
- Crée une clé ssh en suivant par exemple ce tutoriel.
- Ajoute ta clé dans ton profil Gitlab en te rendant dans
Edit profile
(disponibles après avoir cliqué sur le logo en haut à droite) puisSSH Keys
. - Tu pourras maintenant t'authentifier via SSH.
Tout est maintenant configuré, on peut entrer dans le vif du sujet !
Partie 1 : Fork et Repository
La première étape est de créer un repo Git (c'est-à-dire un endroit pour mettre le code). Au lieu de créer un repo vide, nous allons plutôt découvir une nouvelle opération : le fork.
Fork du projet formation
Qu'est-ce que forker un projet ?
Lorsqu'un projet disponible en open source sur un Gitlab nous intéresse, on peut en créer une copie et travailler dessus. Ça évite de recommencer un projet de zéro. Il est important de noter que le fork est plus qu'une copie d'un projet puisque le projet source et le projet forkés sont toujours liés. Mais nous n'utiliserons pas ce lien dans ce TP.