Questions Fréquentes - FAQ¶
- Questions Fréquentes - FAQ
- Généralités
- Gestion de version
- Comment utilise-t-on Subversion ?
- Puis-je importer un dump subversion dans la forge ?
- Comment utiliser Git avec la forge ?
- Comment court-circuiter la vérification du certificat avec Git ?
- Comment configurer un dépôt Git sous Eclipse?
- Comment lier une révision à une demande
- Peut-on utiliser un autre outil de gestion de version ?
- Administration d'un projet
- Wiki
Généralités¶
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é, gérée par le centre de ressources informatiques du PRES. L'outil utilisé est un logiciel libre : Redmine.
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/.
Les données sont elles sauvegardées ?¶
Oui. L'ensemble des données (codes sources, wiki, fichiers, documents...) est sauvegardé sur bande régulièrement.
Comment contacter les administrateurs ?¶
Soit en ouvrant une demande de type support (il faut être connecté), soit directement par courriel (cf. utilisateur admin). Vous pouvez les contacter pour toute question technique.
Où se trouve la documentation officielle de Redmine ?¶
Documentation de Redmine : http://www.redmine.org/guide
Gestion de version¶
Comment utilise-t-on Subversion ?¶
Le site officiel de Subversion est : Apache Subversion.
Vous pouvez utiliser soit :- le client Subversion en ligne de commande (cf. QuickStart, ou le svnbook),
- soit des outils graphiques (comme TortoiseSVN sous Windows),
- soit les outils intégrés aux environnements de développement; pour l'environnement Eclipse, il existe deux plugins : Subclipse et Subversive.
Puis-je importer un dump subversion dans la forge ?¶
Oui. Toutefois, l'import n'est pas automatisé. Il faut donc contacter un administrateur pour effectuer l'import sur le serveur.
Comment utiliser Git avec la forge ?¶
Dans les paramètres de votre projet (Settings), il faut- choisir le module repository dans l'onglet 'modules'
- choisir Git comme SCM dans l'onglet 'repository'
Le dépôt git sera ensuite créé dans l'heure automatiquement (via la commande git init --bare).
Pour cloner un projet (myproject par exemple), il faut utiliser la commande :
git clone https://login@forge.clermont-universite.fr/git/toto
Pour ajouter le dépôt distant de la forge à un dépôt Git local existant :
git remote add forge https://login@forge.clermont-universite.fr/git/myproject
Comment court-circuiter la vérification du certificat avec Git ?¶
L'erreur correspondante est la suivante : "error: server certificate verification failed."
Il y a 2 moyens :- soit en définissant la variable d'environnement GIT_SSL_NO_VERIFY=true
- soit globalement avec la commande git suivante :
git config --global http.sslverify "false"
Comment configurer un dépôt Git sous Eclipse?¶
Pour utiliser Git dans Eclipse, il est nécessaire de spécifier le mot de passe utilisateur dans l'URL du dépôt git distant :
https://login:password@forge.clermont-universite.fr/git/myproject
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 la demande. 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.
Peut-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, Bazaar, Mercurial).
Administration d'un projet¶
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. A la création d'un nouveau projet, un dépôt Subversion sera créé automatiquement au bout d'une heure.
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.
Un manager peut-il supprimer un projet ?¶
Seul un administrateur peut supprimer un projet : contacter les administrateurs.
Quelles sont les permissions associées aux différents rôles (Manager, Developer, Reporter) ?¶
Voici la synthèse des permissions : roles-20130611.png
Wiki¶
Comment créer une nouvelle page wiki ?¶
Pour créer une nouvelle page dans le wiki d'un projet, il suffit de créer dans une page du wiki (la première par exemple) une référence vers la nouvelle page : [[newpage]]. Une fois la modification enregistrée, il faut ensuite cliquer sur le lien créé pour éditer la nouvelle page (qui s'appellera dans l'exemple newpage). Un lien vers une page wiki inexistante apparaitra en rouge.
Quel est la syntaxe du wiki ?¶
Redmine utilise la syntaxe Textile pour ses pages de wiki. Référence de la syntaxe Textile : http://redcloth.org/hobix.com/textile/
Comment ajouter un fil d'Ariane aux pages du wiki ?¶
Pour créer une relation parent/enfant entre les pages du wiki, il faut définir une page "parente" à une page "enfant". Pour cela, il faut créer les deux pages et utiliser la fonctionnalité "Renommer" sur la page "enfant". Cela permet :
- d'afficher sur les pages "enfants" un fil d'Ariane avec les pages "parentes" dans l'arborescence ainsi définie,
- de présenter l'index par titre des pages du wiki sous cette forme arborescente.
