Gestion de projets

La DGDIN met à la disposition des étudiants ainsi qu’aux personnels pédagogiques, un environmment de gestion de projets et de développement.

Qu'est-ce que GIT?

Git est un logiciel de gestion de versions décentralisé. C'est un logiciel libre créé par Linus Torvalds, auteur du noyau Linux, et distribué selon les termes de la licence publique générale GNU version 2. En 2016, il s'agit du logiciel de gestion de versions le plus populaire qui est utilisé par plus de douze millions de personnes. (source : wikipedia).

Qu'est-ce que Redmine?

L'ensemble des opérations conçernant la création et l'administation de vos projets est réalisé par l'intermédiaire de ce site : forge-etud.u-pem.fr.

Accès à l'application

Vous pouvez vous connecter sur la plate-forme redmine avec votre login et votre mot de passe étudiant. Lors de votre première connexion, redmine va construire votre profil et vous pourrez ainsi participer à tous les projets pour lesquels les administrateurs de projet vous ont donné les droits. Si vous vous n'êtes jamais connecté sur Redmine, votre compte n'est pas construit et vous ne pouvez pas être rattaché aux projet.

Création d'un projet

Une fois connecté sur l'interface de redmine, vous disposez de 4 boutons : Accueil, Ma page, Projets et Aide. Cliquez sur Projets. Vous aurez alors un nouveau bouton Nouveau projet sur votre écran. Donnez un nom à votre projet qui permet de l'identifier (par exemple avec les noms de famille du binôme ...).

Si vous souhaitez associer un dépôt GIT à votre projet, pensez à cocher la case "dépôt de sources"

Ajout d'un membre (binôme) à un projet

Attention : on ne peut pas ajouter à un projet un membre qui ne s'est jamais connecté à la plate-forme. Seul le propriétaire du projet (celui qui l'a créé) peut ajouter des membres. Rendez-vous sur Projets et cliquez sur votre projet. Dans l'onglet Configuration, choisissez le sous-onglet Membres, puis cliquez sur Nouveau membre".

IMPORTANT : Vos enseignants vous demandent souvent d'avoir les droits d'administration pour vos projets réalisés dans un cadre pédagogique. Pensez bien à les rajoutez dans les membres de votre projets.

Comment fonctionne Redmine à l'Université ?

En plus de l'accès via l'interface de redmine (onglet Dépôt), vous pouvez accéder à vos sources via la ligne de commande ou un client graphique (type eclipse).

Accès en ligne de commande

Depuis les postes informatiques de l'Université, où le programme est déjà installé, il suffit d'utiliser la commande git (en se plaçant préalablement dans le répertoire qui héberge votre projet). Si vous utiliser une machine personnelle, il faudra installer git dessus. La commande suivante installe git sur les systèmes d'exploitation de type "Debian-like" :

    sudo apt-get install git

Pensez à dire à git qui vous êtes (ces informations seront incluses dans les commits de code) via un fichier de configuration nommé .gitconfig dans votre répertoire HOME.

    login@machine:~$ cat .gitconfig
    [user]
            email = login@etud.u-pem.fr
            name = Firstname Lastname (machine)

Maintenant que votre machine est prête à utiliser git, qu'un projet avec dépôt git à été créé sur l'interface redmine, vous êtes prêt pour initialiser votre nouveau dépôt. Pour cela, vous pouvez facilement cloner le dépôt git vide via la commande :

    git clone https://git-etud.u-pem.fr/XXXXX

Remplacer XXXXX par le nom (identifiant) de votre dépôt qui est souvent le nom de votre projet. Cet identifiant de dépôt vous est rappelé par redmine dans votre projet sur les onglets Configuration puis dépôts. Vous voyez alors l'identifiant de votre dépôt git mais pensez à enlever les quatre caractéres ".git" inutile à la fin de cet identifiant. Si personne n'a encore jamais travaillé sur votre projet, git vous informera que vous clonez un dépôt vide. Vous êtes maintenant prêt à travailler.

Accès via eclipse

Pour partager les sources de vos projets sous Eclipse, il suffit de sélectionner votre projet dans la vue navigateur puis cliquer droit et sélectionner Team -> Share Project.

Travailler avec git

Git sans branche, utilisé simplement Une fois votre dépôt cloné sur votre machine de travail, vous enrichisser vos sources en modifiant par exemple un fichier nommé foo.c et en rajoutant un nouveau fichier main.c. Le logiciel git va vite s'en rendre compte, pour cela, visualisez avec la commande suivante :

    $> git status

    Sur la branche master
    Votre branche est à jour avec 'origin/master'.
    Fichiers non suivis: (utilisez "git add ..." pour inclure dans ce qui sera validé)

    foo.c main.c

    aucune modification ajoutée à la validation mais des fichiers non suivis sont présents (utilisez "git add" pour les suivre)

Si vous avez fini de travailler et vous souhaiter partager la nouvelle version de foo.c ainsi que le nouveau fichier main.c, il faut alors lancer :

    $> git add foo.c
    $> git add main.c

Puis préparer un nouveau commit en ajoutant un message adapté pour informer les autres participants de votre projet. Cela se fait via la commande :

    git commit -m "message adapté"

Pensez à bien remplacer message adapté par un message contextuel correspondant à votre dernier apport sur le projet. Maintenant, vous devez propager ce commit sur le git de l'université (le seul visible depuis le web) pour que les autres colaborateurs de votre projet puissent en bénéficier. Pour cela, il faut faire :

    git push

Ce commit sera maintenant visible depuis l'onglet dépôt dans redmine, le message de commit sera lisible ainsi que son auteur et la date. Pour bénéficier de ce nouvel apport, vos collègues ayant déjà cloné le dépôt il y a quelques temps, devront récupérer les nouveaux commits et les appliquer à leurs sources. Pour cela, il faut lancer :

    git fetch -u

Les quelques commandes ci-dessus suffisent pour travailler avec git simplement avec une seule branche : master. Pour travailler plus sérieusement avec git, voici quelques référence en français :

    git - petit guide

Les parties 1 et 2 du livre en ligne GIT-SCM.