Forge Clermont Université

h1. Questions Fréquentes - FAQ

{{>toc}}

h2. Généralités

h3. Qu'est-ce qu'une forge ?

Une forge est un outil de développement collaboratif de logiciels informatiques. Une forge permet d'intégrer au sein d'un projet une gestion du code source, la gestion des bugs, la documentation et la distribution des _releases_.

Forge Clermont Université est la forge du "PRES Clermont-Université":http://www.clermont-universite.fr, gérée par le centre de ressources informatiques du PRES. L'outil utilisé est un logiciel libre : "Redmine":http://www.redmine.org.

h3. Qui peut se connecter à Forge Clermont Université ?

La forge est ouverte à tous. Les membres des universités doivent utiliser le service d'authentification de leur établissement. Leur compte sera activé automatiquement à la première connexion. Les autres utilisateurs doivent demander la création d'un compte invité.

L'URL de Forge Clermont Université est : http://forge.clermont-universite.fr/.

h3. Les données sont elles sauvegardées ?

Oui. L'ensemble des données (codes sources, wiki, fichiers, documents...) est sauvegardée sur bande régulièrement.

h3. Comment contacter un administrateur ?

Soit en ouvrant un ticket de type "support":http://forge.clermont-universite.fr/projects/redmine-clruniv/issues/new?tracker_id=3 (il faut être connecté), soit directement par courriel (cf. utilisateur "admin":http://forge.clermont-universite.fr/account/show/1). Vous pouvez les contacter pour toute question technique.

h3. Où se trouve la documentation officielle de Redmine ?

Documentation de Redmine : http://www.redmine.org/guide

h2. Gestion de version

h3. Comment utilise-t-on Subversion ?

Le site officiel de Subversion est : "Apache Subversion":http://subversion.apache.org/.

Vous pouvez utiliser soit :

* le client Subversion en ligne de commande (cf. "QuickStart":http://svnbook.red-bean.com/en/1.1/ch01s07.html, ou le "svnbook":http://svnbook.red-bean.com/nightly/fr/svn-book.pdf), 

* soit des outils graphiques (comme "TortoiseSVN":http://tortoisesvn.tigris.org/ sous Windows), 

* soit les outils intégrés aux environnements de développement; pour l'environnement "Eclipse":http://www.eclipse.org/, il existe deux plugins : "Subclipse":http://subclipse.tigris.org/ et "Subversive":http://www.eclipse.org/subversive/.

h3. Puis-je importer un dump subversion dans la forge ?

Oui. Toutefois, l'import n'est pas automatisé. Il faut donc contacter un "administrateur":http://forge.clermont-universite.fr/account/show/1 pour effectuer l'import sur le serveur.

h3. Comment lier une révision à une demande

Il suffit que le numéro de la demande précédé du caractère # (par exemple #1) apparaisse dans le commentaire du commit. La forge établira alors le lien entre la révision et le commit. Notamment, la révision va apparaître comme 'révision associée' au niveau de la demande.

A l'inverse, vous pouvez faire référence à une révision (depuis une demande, un commentaire ou une page wiki) en spécifiant le numéro de la révision précédé d'un 'r': r1, r19. 

h3. Peux-t-on utiliser un autre outil de gestion de version ?

Forge Clermont Université ne propose aujourd'hui que Subversion pour gérer les codes sources. Un dépôt Subversion est créé automatiquement pour chaque projet. Toutefois, Comme Redmine supporte différents SCM (_Source Code Management_), vous pouvez contacter l'administrateur pour utiliser un autre SCM ("Git":http://git-scm.com/, "Bazaar":http://bazaar-vcs.org/, "Mercurial":http://www.selenic.com/mercurial/).

h2. Administration d'un projet

h3. Comment créer un nouveau projet

Il y a deux conditions pour pouvoir créer un nouveau projet : 

# être authentifié sur la Forge par le _Single Sign On_ de son établissement

# être identifié comme personnel dans l'annuaire du personnel

Si ces deux conditions sont remplies, un item "Nouveau projet" apparait sur la page "projets":http://forge.clermont-universite.fr/projects. A la création d'un nouveau projet, un dépôt Subversion sera crée automatiquement au bout d'une heure.

h3. Quelle est la différence entre un projet public et un projet privé ?

Un projet privé n'est visible que par les membres du projet, alors qu'un projet public est visible par tous, même par un utilisateur non identifié. Toutefois un visiteur anonyme ne peut participer à un projet public, il doit avoir un compte pour pouvoir soumettre des rapports de bugs ou participer aux forums de discussions. 

h3. Un manager peut-il supprimer un projet ?

Seul un administrateur peut supprimer un projet : [[Documentation#Comment-contacter-un-administrateur-|contacter un administrateur]]).