Tutoriel GitLab. DEQUEKER Jérôme, FAJOUX Thomas et GODICHON Thomas. 22 mai 2013

Transcription

1 Tutoriel GitLab DEQUEKER Jérôme, FAJOUX Thomas et GODICHON Thomas 22 mai

2 Table des matières 1 Introduction 3 2 Création du compte 3 3 Utilisation via le navigateur Le DashBoard Le Projet Le home Files Commits Utilisation via l'explorateur de chiers Installation de l'interface graphique, sous Windows Utilisation du terminal

3 1 Introduction Ce petit tutoriel n'est qu'une ébauche, et est fait pour être amélioré. Il n'a aucune prétention d'exhaustivité, mais juste de mentionner les choses les plus importantes pour mener à bien ce projet. 2 Création du compte Pour créer un compte, il sut de se connecter sur fr/. Vous appartenez désormais à la communauté GitLab de l'um2. Il vous est donc possible de créer un Projet (New Project), ou en rejoindre un, sur invitation. La liste des membres d'un projet est visible via l'onglet Team. Il y a 4 types de membres, avec des droits d'accès diérents : Master Developer Reporter Guest 3 Utilisation via le navigateur 3.1 Le DashBoard En cliquant sur le petit logo de GitLab, vous arrivez sur le DashBoard. Il permet d'avoir une vue globale de votre compte, avec les dernières actualités liées à vos projets. Figure 1: Le logo de GitLab 3.2 Le Projet Il y a diérents onglets Le home En cliquant sur un projet (ici DequekerJerome/RIR2013), diérents onglets s'orent à vous : Show, qui vous donnes les actualités de ce projet Team, qui vous donne des informations sur les membres de ce projet 3

4 Les autres ne sont pas intéressants ici Files Vous avez une vue sur l'ensemble des documents stockés sur le serveur, en gardant la hiérarchie des dossiers et sous dossiers. Le tableau a plusieurs colonnes : Le nom du chier ou du dossier, avec son extension. La date de dernière mise à jour. Pour un dossier, il s'agit de la mise à jour la plus récente du chier contenu dans ce répertoire. Et le descriptif du dernier commit. Avec le nom de l'utilisateur ayant fait le dernier commit, et un petit descriptif. En cliquant sur un chier texte, on a un aperçu graphique de la dernière modication, avec une coloration (vert et rouge). En haut à droite, il y a un onglet qui permet de l'éditer, directement dans le navigateur Commits Commits contient les derniers commits, regroupés par jour. 4 Utilisation via l'explorateur de chiers 4.1 Installation de l'interface graphique, sous Windows Pour commencer, je vous conseille de suivre le tutoriel suivant : eu.org/syracuse/g/git-windows/. En eet celui-ci étant complet du point de vue de l'installation de Git sous Windows, il serait inutile de le recopier ici. Ensuite nous allons voir les fonctionnalités de TortoiseGit qui vous seront utiles dans l'immédiat. Une fois dans le répertoire cloné : Clic droit GitSync : La gure 2 à la page 6 nous montre comment utiliser les commandes basiques de Git : Pull, Push et Commit. Avant de faire d'autres commandes, il est conseillé de faire un Pull, pour mettre à jour votre dossier. Pour mettre à jour un chier, une fois le chier modié, clic droit puis GitCommit ->. Une fenêtre s'ouvre, vous devez entrer un commentaire pour expliquer les modications, faites ok, une fois le chargement passé vous pouvez faire Push qui vous permet de faire réellement la mise à jour. Attention : si vous rencontrez une erreur lors d'un Push, ceci peut être due au fait que vous n'avez pas mis à jour votre dossier. Il faut donc d'abord faire un Pull. 4.2 Utilisation du terminal La commande "git pull" permet de mettre à jour son répertoire local. Elle est à utiliser régulièrement. 4

5 La commande "git add..." permet d'ajouter un chier à la liste de transfert. Personnellement, je fais "git add." pour mettre tous les chiers modiés. La commande "git commit..." permet de créer un commit, c'est à dire une procédure de mise à jour. Il vous sera demandé de mettre un commentaire. Personnellement, je fais "commit -a", pour mettre à jour tous les chiers modiés. Sous Linux, une fois le commentaire écrit faites X pour quitter et valider avec o. Sous Windows, si vous utilisez le Git bash, après avoir tapé " git commit -a" vous devrez rentrer un commentaire sur les modications apportées. Pour cela faites " i " an de passer en mode édition ( le carré blanc devrait devenir un tiret). Une fois le commentaire achevé, faites échap an d'être sûr de ne plus être en mode édition de commentaires, puis faites ZZ an de sortir de la fonction commit. Enn, la commande "git push" permet d'appliquer les commit, et de faire réellement la mise à jour. 5

6 Figure 2: Interface GitSync 6