|
|
Tutoriel pour utilisation de Gitlab
|
|
|
Tutoriel pour utilisation de GitLab
|
|
|
===================================
|
|
|
|
|
|
Ce tutoriel a pour objectif de permettre l'utilisation de GitLab via un navigateur web. Il présente les principales fonctionnalités avec la navigation dans le projet, le téléchargement du projet, l'ajout d'un nouveau fichier, l'édition d'un fichier déjà présent... À noter que GitLab.com a un support du français relativement limité.
|
... | ... | @@ -6,21 +6,38 @@ Ce tutoriel a pour objectif de permettre l'utilisation de GitLab via un navigate |
|
|
GitLab
|
|
|
------
|
|
|
|
|
|
GitLab est un projet [open core](https://fr.wikipedia.org/wiki/Open_core). Cela signifie que le coeur du projet est [open source](https://fr.wikipedia.org/wiki/Open_source) (le code source du projet est ouvert) mais certaines fonctionnalités spécifiques "en plus" sont payantes.
|
|
|
GitLab est un projet [open core](https://fr.wikipedia.org/wiki/Open_core). Cela signifie que le cœur du projet est [open source](https://fr.wikipedia.org/wiki/Open_source) (le code source du projet est ouvert) mais certaines fonctionnalités spécifiques "en plus" sont payantes.
|
|
|
|
|
|
GitLab est une [forge](https://fr.wikipedia.org/wiki/Forge_(informatique)). C'est-à-dire que GitLab a pour objectif de permettre à plusieurs personnes de participer au développement d'un même projet. GitLab.com est le service web correspondant.
|
|
|
|
|
|
[git](https://fr.wikipedia.org/wiki/Git) est un logiciel de gestion de version. Dans un projet, il va permettre de conserver les évolutions du projet au travers des versions de chacun de ces fichiers. GitLab.com héberge des projets utilisant git.
|
|
|
[git](https://fr.wikipedia.org/wiki/Git) est un logiciel de gestion de version. Dans un projet, il va permettre de conserver les évolutions du projet au travers des versions de chacun de ces fichiers.
|
|
|
|
|
|
Écran d'accueil
|
|
|
GitLab.com héberge des projets utilisant git.
|
|
|
|
|
|
git en deux mots
|
|
|
---------------
|
|
|
|
|
|
Comme dit précédemment [git](https://fr.wikipedia.org/wiki/Git) va permettre du versioning d'un projet. L'idée est de conserver l'ensemble des versions d'un projet. git offre la notion de "commit" qui peut être traduite en version: à une succession de changement effectuer sur le projet (suppression de fichiers, ajout de fichiers, modification de fichiers, création de dossiers...) depuis le dernier "commit" est associé un message explicatif. Par exemple suite à l'ajout d'un programme sas on peut associer un message de commit du type:
|
|
|
|
|
|
```Ajout du programme macro_age.sas permettant d'obtenir la tranche d'âge des malades "date de naissance" de la table DCIR Simplifié```
|
|
|
|
|
|
A chaque "commit" est associé son auteur.
|
|
|
|
|
|
git permet ainsi un travail collaboratif sur un même projet, il facilite le partage d'un projet mais est aussi utile sur les projets d'une seule personne.
|
|
|
|
|
|
La notion de versioning permet de revenir rapidement à différentes versions d'un projet. Par exemple une "branch" au sens git permet de s'éloigner du projet principal pour développer par exemple une nouvelle fonctionnalité ou répondre à une demande. Une fois finie il est possible de revenir au projet principal simplement sans avoir à faire de multiple copier/coller ou avoir plusieurs dossiers contenant le même projet ou programme sous différentes version. Les différentes versions cohabitent dans un seul dossier et l'on peut facilement passer de l'une à l'autre sans perte d'information.
|
|
|
|
|
|
Ces nombreux avantages font que git est très utilisé dans la communauté des développeurs informatique de tout niveau.
|
|
|
|
|
|
Écran d'accueil de GitLab
|
|
|
------------------------
|
|
|
|
|
|
![1_Accueil](/uploads/cdb37f0636138cb034d99deadf6d0827/1_Accueil.PNG)
|
|
|
|
|
|
L'écran d'accueil est divisé en plusieurs partie:
|
|
|
L'écran d'accueil est divisé en plusieurs parties:
|
|
|
- la partie du haut et lié à GitLab.com avec la navigation à travers l'ensemble de vos projets (**1**), vos différents groupes (**2**) ou la gestion de votre profil (**3**)
|
|
|
- la partie de gauche est centrée sur le projet courant avec par exemple le wiki (**6**)
|
|
|
- le coeur de la page se concentre sur l'exploration des fichiers, le README et diverses fonctionnalités comme le téléchargement (**5**) ou le code permettant de télécharger le projet en ligne de commande (**4**)
|
|
|
- le cœur de la page se concentre sur l'exploration des fichiers, le README et diverses fonctionnalités comme le téléchargement (**5**) ou le code permettant de télécharger le projet en ligne de commande (**4**)
|
|
|
- La barre de recherche (**7**) permet d'effectuer une recherche dans le projet à la fois sur les noms de fichiers mais aussi dans le contenus de ceux-ci
|
|
|
|
|
|
![3_Acceuil_Fin](/uploads/3ecad1327f7ad55746d9219939f0b402/3_Acceuil_Fin.PNG)
|
... | ... | @@ -32,7 +49,7 @@ En faisant défiler vers le bas on voit plus précisément: |
|
|
|
|
|
![10_settings](/uploads/41f36a2fa1404d6f38e8035c5e2d258d/10_settings.PNG)
|
|
|
|
|
|
Les paramètres courants de votre utilisateur sont consultable en cliquant sur le bouton en haut à droite puis sur "Settings"
|
|
|
Les paramètres courants de votre utilisateur sont consultables en cliquant sur le bouton en haut à droite puis sur "Settings"
|
|
|
|
|
|
Téléchargement du projet
|
|
|
-----------------------
|
... | ... | @@ -56,7 +73,7 @@ Une fois dans le bon dossier on peut ajouter un fichier en cliquant sur le "+" |
|
|
![5_Ajout_d_un_fichier](/uploads/d0147b03d3db4ca2d3bb03296d098420/5_Ajout_d_un_fichier.PNG)
|
|
|
|
|
|
Il y a trois choix possibles:
|
|
|
- "New file" qui permet la création d'un fichier *via* GitLab.com. L'édition de se fichier se fera ensuite en utilisant l'éditeur de texte dans un navigateur. Cette utilisation est plutôt conseillée dans le cas d'un README
|
|
|
- "New file" qui permet la création d'un fichier *via* GitLab.com. L'édition de ce fichier se fera ensuite en utilisant l'éditeur de texte dans un navigateur. Cette utilisation est plutôt conseillée dans le cas d'un README
|
|
|
- "Upload file" qui permet l'ajout d'un fichier depuis son ordinateur
|
|
|
- "New directory" qui permet la création d'un nouveau dossier
|
|
|
|
... | ... | |