Gérer ses dépôts Git

Le service Git de Tuleap permet d'héberger et de gérer des dépôts Git directement dans vos projets. Chaque dépôt est accessible via une interface web complète et bénéficie d'une intégration native avec les Trackers : les commits, branches et Pull Requests peuvent être reliés aux Artifacts pour une traçabilité complète.

Cette traçabilité complète permet à chaque membre de l'équipe de comprendre le contexte d'une modification de code, de naviguer facilement d'une tâche à un commit, et de garantir que chaque changement est justifié et validé.

Prérequis : se familiariser avec Git

Apprendre les concepts de Git

Avant de manipuler les outils, comprendre le fonctionnement de Git est essentiel.

Le livre "Pro Git", rédigé par Scott Chacon et Ben Straub et accessible en ligne gratuitement, est la ressource la plus complète pour apprendre le fonctionnement de Git, de la base aux concepts les plus avancés comme les branches et les fusions.

Choisir un client Git

Un client Git est le logiciel que vous installerez sur votre ordinateur pour communiquer avec le dépôt hébergé sur Tuleap.

• Clients graphiques (GUI) : il existe de nombreuses options pour Windows, macOS et Linux. Des outils comme Sourcetree, GitKraken, ou GitHub Desktop offrent une interface visuelle pour simplifier les opérations Git.

• Ligne de commande (client git) : la méthode la plus directe et universelle. Le client s'installe via le gestionnaire de paquets de votre distribution ou en le téléchargeant depuis le site officiel de Git.

• Également, la plupart des environnements de développement (IDE) modernes intègrent un support pour Git, soit nativement, soit via des extensions. Pensez à vérifier les options d’installation sur votre IDE favori.

Créer un dépôt

La première étape pour utiliser le service est de créer un dépôt qui hébergera votre code.

La création de dépôts est accessible aux administrateurs du projet et aux administrateurs du service Git.

1. Accédez au service Git dans votre projet Tuleap.

2. Cliquez sur le bouton pour créer un nouveau dépôt.

3. Saisissez le nom souhaité pour le dépôt, puis cliquez sur "Ajouter un dépôt".

Une fois créé, le dépôt apparaît dans la liste des dépôts du projet. Vous pouvez créer autant de dépôts que nécessaire ; ils sont tous gérés directement par la plateforme Tuleap.

La liste des dépôts

La page d'accueil du service Git affiche l'ensemble des dépôts du projet. Vous pouvez trier cette liste par chemin (namespace) ou par date de dernière modification.

La liste distingue deux catégories :

• Dépôts du projet ("References") : les dépôts officiels du projet.

• Forks des utilisateurs : les copies personnelles créées par les développeurs.

Une description textuelle peut être ajoutée à chaque dépôt depuis ses paramètres. Elle est affichée dans la liste des dépôts et sur la page du dépôt.

Les dépôts peuvent être regroupés dans des dossiers (namespaces) pour une meilleure organisation. Par exemple : backend/api, frontend/webapp, libs/common. Cette organisation est définie lors de la création du dépôt en spécifiant un chemin.

Explorer un dépôt

En sélectionnant un dépôt dans la liste, vous pouvez accéder à sa page principale et consulter toutes les informations qui y sont liées.

Sur cette page, vous trouverez :

• Le nom du dépôt : affiché en haut de la page.

• Les fichiers : le contenu du dépôt à la racine de la branche sélectionnée. Chaque fichier peut être consulté ou téléchargé.

• Le compteur de Pull Requests : indique le nombre de Pull Requests en attente de revue.

Plusieurs actions sont également disponibles :

• Onglets de navigation : trois onglets principaux — "Fichiers" pour voir le contenu du dépôt, "Commits" pour l'historique des modifications, et "Pull Requests" pour gérer les revues de code.

• Bouton "Créer une pull request" : permet d'initier une nouvelle revue de code.

• Bouton "Cloner" : affiche les URLs SSH et HTTPS pour cloner le dépôt.

• Bouton "Fork" : permet de créer une copie personnelle du dépôt.

• Paramètres : accès à la zone de configuration du dépôt (permissions, notifications, etc.).

Naviguer dans l'historique des commits

Par défaut, la page affiche l'historique des commits de la branche principale (généralement main ou master). Vous pouvez sélectionner une autre branche pour afficher son historique spécifique. Vous pouvez également sélectionner un tag spécifique.

En cliquant sur l'onglet "Commits", vous accédez à une vue détaillée de l'historique complet de la branche sélectionnée. Pour obtenir toutes les informations relatives à une modification, cliquez sur un commit dans la liste. Vous pourrez alors visualiser :

• L'auteur et le committer.

• Les identifiants uniques (commit, tree, parent).

• Le message de commit détaillé.

• Les éventuelles références vers des Artifacts Tuleap.

• La liste des fichiers modifiés.

Les modifications de code peuvent être consultées sous forme de liste ou sous forme de "diff", globalement ou fichier par fichier.

Également, pour chaque fichier de commit, la vue "blame" permet de voir qui a modifié chaque ligne et dans quel commit.

Cloner un dépôt

Pour commencer à travailler sur le code, vous devez créer une copie locale du dépôt hébergé sur Tuleap. Deux protocoles sont disponibles :

• Via SSH : cette méthode nécessite d'avoir préalablement configuré une clé SSH publique dans votre profil utilisateur Tuleap. Une fois votre clé ajoutée, vous pouvez cloner sans saisir vos identifiants à chaque opération.

• Via HTTPS : cette méthode requiert un Personal Access Key (avec le scope Git repository) que vous devez générer depuis votre profil utilisateur. Lors du clone, utilisez votre nom d'utilisateur Tuleap et le token comme mot de passe.

Pour récupérer l'URL de clone :

1. Accédez à la page du dépôt.

2. Cliquez sur le bouton "Cloner".

3. Copiez l'URL SSH ou HTTPS affichée.

Information

Pour plus de détails sur la configuration des clés SSH et des Access Keys, consultez la section Configurer mon profil de la documentation Tuleap.

Forker un dépôt

Les forks personnels permettent de supporter un modèle de développement décentralisé. Dans ce modèle :

• Les dépôts de référence ("References") sont maintenus par les intégrateurs et représentent les dépôts officiels du projet.

• Les développeurs travaillent dans leurs dépôts personnels (forks) et publient régulièrement leur travail pour le partager avec les autres développeurs.

Créer un fork personnel

1. Depuis la page du service Git, sélectionnez un ou plusieurs dépôts à forker.

2. Cliquez sur le bouton "Fork".

Les forks créés apparaissent dans la section "Forks des utilisateurs” du service Git, distincte des dépôts de référence.

Fork inter-projets

Si vous êtes administrateur d'un autre projet où le service Git est activé, vous pouvez forker un dépôt directement dans ce projet. Dans ce cas, le fork deviendra un dépôt de référence dans le projet de destination.

Supprimer un dépôt

Un dépôt peut être supprimé par un administrateur du projet. Lors de la suppression, Tuleap crée automatiquement une sauvegarde au format {PROJECT}_{REPOSITORY}_{TIMESTAMP}.tar.bz2 dans le répertoire de backup du plugin Git.

Les dépôts supprimés peuvent être restaurés par un administrateur de la plateforme depuis l'interface d'administration.

Information

Pour plus de détails sur la restauration d'une sauvegarde, consultez la section Importing an existing Git Repository de la documentation technique.

FAQ