Organiser et suivre son travail dans GitLab

1. Comprendre la notion de projet

Les projets sont les composants de base de GitLab. De manière générale, ils représentent un élément (logiciel ou non) sur lequel vous travaillez. Dans un contexte de développement logiciel, ils constituent un espace où les équipes peuvent collaborer sur du code source, suivre des tickets et automatiser les étapes du SDLC.

Comme nous l’avons vu plus haut, un projet se présente sous la forme d’un dépôt Git qui permet de stocker vos fichiers, qu’il s’agisse de code source ou de documentation. En fait, il s’agit d’un composant beaucoup plus complexe qu’un simple dépôt : les projets sont le point de départ pour naviguer à travers les différentes fonctionnalités de la plateforme et, à ce titre, ils sont l’endroit où vous passerez la majeure partie de votre temps en tant qu’utilisateur de GitLab.

Maintenant, vous vous demandez peut-être à quoi les projets peuvent être consacrés et comment ils sont structurés. En voici quelques exemples tirés du dépôt (projet) officiel de GitLab :

Dans cette capture qui n’est aucunement exhaustive, nous avons :

1. Comprendre la notion de ticket

Un ticket dans GitLab est une unité de suivi utilisée pour gérer des tâches, signaler des bugs, suggérer des améliorations ou faire diverses demandes de services. Les tickets permettent aux membres de l’équipe de collaborer, de commenter, de joindre des fichiers et de suivre l’avancement du travail.

Si un projet GitLab peut être défini comme un conteneur pour un produit ou une initiative unique, un ticket est ce qui contient l’énoncé d’une tâche spécifique. D’autres solutions préfèrent le terme « story » ou « user story » pour décrire des composants similaires aux tickets GitLab. Cette expression est empruntée à la méthodologie Scrum qui est davantage axée sur le développement. Elles désignent une description concise d’une fonctionnalité ou d’une exigence...

1. Créer une nouvelle branche à fusionner

Pour voir comment fonctionnent les requêtes de fusion, nous devons d’abord avoir au moins une deuxième branche. Dans l’exemple qui suit, nous allons créer une branche directement dans GitLab, mais vous pouvez aussi le faire localement avec git branch <nom_branche> et la « pousser » par la suite avec git push.

Il est possible de créer une branche sur la page principale du dépôt d’un projet, mais nous allons le faire à partir du menu Code dans le panneau latéral Projet. Nous allons reprendre l’exemple du dépôt Pages-HTML-brut que nous avions créé à partir d’un modèle.

Maintenant que nous avons une nouvelle branche, nous allons faire une modification pour pouvoir ensuite créer une merge request.

1. Les GitLab Pages

Les GitLab Pages sont une fonctionnalité qui permet de publier des sites web statiques directement à partir d’un projet. En effet, il est possible d’héberger des sites de documentation, des portfolios ou des blogs avec différents générateurs de sites statiques comme Jekyll, Hugo ou Docusaurus.

Lorsque nous avons créé notre dépôt Pages-HTML-brut nous avons vu plusieurs modèles qui permettent d’automatiser la création de GitLab Pages.

Nous n’insisterons pas sur ce point, mais il s’agit d’une fonctionnalité intéressante de GitLab que vous pouvez tester en appuyant sur l’onglet GitLab Pages. Vous obtiendrez une page web avec les traductions que nous avions apportées au fichier index.html :

2. Le Wiki

Vous aurez sans doute remarqué que vous avez aussi la possibilité de créer un Wiki pour un projet. En effet, l’option est disponible, soit dans le menu Programmation dans la barre latérale ou dans la section droite du projet en appuyant sur le bouton dédié à l’ajout d’une page wiki.

Cette fonctionnalité permet de créer, gérer et collaborer sur une documentation directement intégrée à un projet. Les pages sont en Markdown et vous pouvez utiliser...