Administrer un projet avec gitLab

Created with Sketch.

Administrer un projet avec gitLab

Prérequis :

 

Créer un dépôt

Rendez-vous sur votre compte gitLab et ouvrez simplement un nouveau projet en cliquant sur « Nouveau projet »  ou depuis le menu, Projets > Create new project

Vous pouvez à ce moment-là soit importer votre projet depuis un autre dépôt, soit créer un projet vide pour y ajouter vos fichiers en local.

Pour ce tutoriel je vais intégrer un projet local à ce nouveau dépôt, je vais donc choisir « Create blank project ».
Renseignez le nom de votre projet, choisissez de le rendre public ou privé puis cliquez sur « Create project ».
 
Le dépôt étant créé, nous allons pouvoir inviter des membres à travailler sur le projet et créer leur branche respective.
 
Toute création ou modification se fait depuis la page d’administration du projet. Pour cet exemple j’ai créé un projet « Projet tuto ».
Vous pouvez maintenant importer votre projet sur ce dépôt en cliquant sur « Upload File ».
Pour ce tutoriel je vais importer un simple index.html contenant les balises de base html ainsi qu’un paragraphe contenant la mention « hello world ».

Inviter des membres

Les invitations et les rôles se gères depuis la page « Project members » accessible depuis le menu de gauche : Project information > Membres

C’est depuis cette page que vous pourrez envoyer des invitations aux membres du projet et leur donner les droits qui correspondent à leurs rôles.

Créer des branches

La gestion des branches se fait depuis la page « branches ». Cette page est accessible depuis le menu de gauche:
Dépôt > Branches
 
Il suffit de cliquer sur « Nouvelle branche » et de lui donner un nom.
 
Pour ce tutoriel je vais créer 1 branche que je vais appeler « branche_1 »  qui sera une copie de « main » et contiendra donc « index.html ».
 
On peut également créer une branche depuis une autre branche.

Clonage d’un dépôt

Une fois votre compte configuré, vous pouvez commencer à cloner des dépôts GitLab sur votre
machine.

La manière la plus simple de le faire est de passer par la page du dépôt sur GitLab.
 
Dans le cas du projet de ce tutoriel je vais choisir la branche 1 puis cliquer sur « clone ».
 
Choisissez ensuite si vous voulez importer dans votre IDE via lien https ou via lien ssh.
 
Le projet peut donc maintenant être importé directement depuis Visual Studio Code 
Vous avez désormais le dépôt cloné sur votre environnement local. Cela signifie que, si vous avez les autorisations nécessaires sur GitLab pour interagir dessus, vous pourrez y apporter des
modifications (auquel cas vous devrez faire un fork si vous souhaitez faire des modifications).

Fusions et conflits

Dans le cas où je travaille depuis la branche_1 et que modifie un fichier qui est déjà présent dans « main », cela va engendrer un conflit lors de la fusion.
 
Exemple: je modifie le paragraphe de index.html et remplace « Hello World » par « Bonjour ».
 
Je vais maintenant demander la fusion via la page « branches », donc Dépôt > branches
 
 
Cliquez sur « Demande de fusion » dans la ligne « branche_1 ».
 
 
Donnez un titre et une description à cette fusion puis dans « Merge options » décidez si la branche doit être supprimée ou non après la fusion puis validez avec le bouton « Create demande de fusion ».
 
Cette demande étant faite, vous constaterez dans le menu de gauche de votre compte GitLab, qu’un petit « 1 » est apparu devant la rubrique « Demandes de fusion ».
 
Cliquez sur cette rubrique puis cliquez sur la demande de fusion. Dans mon cas c’est « Draft: Branche 1 ».
 
 
Dans cet exemple la fusion ne peut pas se faire directement à cause du conflit (un fichier présent dans les 2 branches « main » et « branche_1 » a été modifié).
 
Il faut donc résoudre le conflit, pour cela cliquez sur « Résoudre les conflits ».
 
 
Cette page présente les conflits et permet de les résoudre. Deux affichages sont possibles, par souci de lisibilité dans ce tutoriel j’ai opté pour « côte à côte », option disponible en haut à droite .
 
La nouvelle version est en vert et l’ancienne en bleu, il suffit de cliquer sur le bouton vert ou le bouton bleu pour valider la modification ou non et procéder à la fusion.
 
Je vais donc cliquer sur « Use ours » en vert pour valider la modification de « main » par « branche_1 » puis valider en cliquant sur « Commit to source branch ».
 
Enfin pour finaliser la fusion, cliquez sur « Mark as ready » puis « Merge ».
 

Historique

En cliquant sur le bouton « Historique » sur la page principale du projet.
 
Vous pourrez voir sur cette page la liste des commits du dépôt distants synchronisés avec le dépôt local.
 
 
Après sélection d’un commit dans la liste, vous pourrez voir dans le volet de droite la liste des fichiers modifiés dans le commit.
 
Il est ainsi possible de revenir à chaque étape du développement.
 
Exemple:
Création de l’index de l’index du projet tuto
 
 
Puis la création du paragraphe:
 
 
Et enfin la modification du paragraphe lors de la fusion :
 

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *