Documentation » History » Version 66

Antoine MAHUL, 05/25/2012 10:50 AM

1 20 Antoine MAHUL
h1. Questions Fréquentes - FAQ
2 1 Antoine MAHUL
3 22 Antoine MAHUL
{{>toc}}
4 22 Antoine MAHUL
5 20 Antoine MAHUL
h2. Généralités
6 1 Antoine MAHUL
7 34 Antoine MAHUL
h3. Qu'est-ce qu'une forge ?
8 1 Antoine MAHUL
9 23 Antoine MAHUL
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_.
10 30 Antoine MAHUL
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.
11 1 Antoine MAHUL
12 21 Antoine MAHUL
h3. Qui peut se connecter à Forge Clermont Université ?
13 21 Antoine MAHUL
14 21 Antoine MAHUL
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é.
15 21 Antoine MAHUL
16 50 Antoine MAHUL
L'URL de Forge Clermont Université est : http://forge.clermont-universite.fr/.
17 50 Antoine MAHUL
18 1 Antoine MAHUL
h3. Les données sont elles sauvegardées ?
19 1 Antoine MAHUL
20 58 Antoine MAHUL
Oui. L'ensemble des données (codes sources, wiki, fichiers, documents...) est sauvegardé sur bande régulièrement.
21 39 Antoine MAHUL
22 58 Antoine MAHUL
h3. Comment contacter les administrateurs ?
23 39 Antoine MAHUL
24 65 Antoine MAHUL
Soit en ouvrant une demande 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/users/1). Vous pouvez les contacter pour toute question technique.
25 29 Antoine MAHUL
26 33 Antoine MAHUL
h3. Où se trouve la documentation officielle de Redmine ?
27 28 Antoine MAHUL
28 20 Antoine MAHUL
Documentation de Redmine : http://www.redmine.org/guide
29 28 Antoine MAHUL
30 28 Antoine MAHUL
31 25 Antoine MAHUL
h2. Gestion de version
32 25 Antoine MAHUL
33 25 Antoine MAHUL
h3. Comment utilise-t-on Subversion ?
34 25 Antoine MAHUL
35 44 Antoine MAHUL
Le site officiel de Subversion est : "Apache Subversion":http://subversion.apache.org/.
36 43 Antoine MAHUL
37 1 Antoine MAHUL
Vous pouvez utiliser soit :
38 57 Antoine MAHUL
* le client Subversion en ligne de commande (cf. "QuickStart":http://svnbook.red-bean.com/nightly/fr/svn.intro.quickstart.html, ou le "svnbook":http://svnbook.red-bean.com/nightly/fr/svn-book.pdf), 
39 41 Antoine MAHUL
* soit des outils graphiques (comme "TortoiseSVN":http://tortoisesvn.tigris.org/ sous Windows), 
40 42 Antoine MAHUL
* 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/.
41 40 Antoine MAHUL
42 52 Antoine MAHUL
h3. Puis-je importer un dump subversion dans la forge ?
43 52 Antoine MAHUL
44 65 Antoine MAHUL
Oui. Toutefois, l'import n'est pas automatisé. Il faut donc contacter un "administrateur":http://forge.clermont-universite.fr/users/1 pour effectuer l'import sur le serveur.
45 52 Antoine MAHUL
46 66 Antoine MAHUL
h3. Comment utiliser Git avec la forge ?
47 66 Antoine MAHUL
48 66 Antoine MAHUL
Dans les paramètres de votre projet (Settings), il faut
49 66 Antoine MAHUL
* choisir le module repository dans l'onglet 'modules'
50 66 Antoine MAHUL
* choisir Git comme SCM dans l'onglet 'repository'
51 66 Antoine MAHUL
52 66 Antoine MAHUL
Le dépôt git sera ensuite créé dans l'heure automatiquement (via la commande git init --bare).
53 66 Antoine MAHUL
54 66 Antoine MAHUL
h3. Comment outrepasser la vérification du certificat avec Git ?
55 66 Antoine MAHUL
56 66 Antoine MAHUL
L'erreur correspondante est la suivante : "error: server certificate verification failed."
57 66 Antoine MAHUL
58 66 Antoine MAHUL
Il y a 2 moyens de :
59 66 Antoine MAHUL
- git config --global http.sslverify "false"
60 66 Antoine MAHUL
- en définissant la variable d'environnement GIT_SSL_NO_VERIFY=true
61 66 Antoine MAHUL
62 46 Antoine MAHUL
h3. Comment lier une révision à une demande
63 54 Antoine MAHUL
64 1 Antoine MAHUL
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.
65 53 Antoine MAHUL
66 26 Antoine MAHUL
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. 
67 58 Antoine MAHUL
68 25 Antoine MAHUL
h3. Peut-on utiliser un autre outil de gestion de version ?
69 58 Antoine MAHUL
70 25 Antoine MAHUL
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":http://fr.wikipedia.org/wiki/Gestion_de_configuration_logicielle (_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/).
71 63 Antoine MAHUL
72 20 Antoine MAHUL
h2. Administration d'un projet
73 20 Antoine MAHUL
74 20 Antoine MAHUL
h3. Comment créer un nouveau projet
75 20 Antoine MAHUL
76 9 Antoine MAHUL
Il y a deux conditions pour pouvoir créer un nouveau projet : 
77 58 Antoine MAHUL
# être authentifié sur la Forge par le "_Single Sign On_":http://fr.wikipedia.org/wiki/Sso de son établissement
78 20 Antoine MAHUL
# être identifié comme personnel dans l'annuaire du personnel
79 20 Antoine MAHUL
80 58 Antoine MAHUL
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éé automatiquement au bout d'une heure.
81 20 Antoine MAHUL
82 20 Antoine MAHUL
83 20 Antoine MAHUL
h3. Quelle est la différence entre un projet public et un projet privé ?
84 20 Antoine MAHUL
85 20 Antoine MAHUL
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. 
86 20 Antoine MAHUL
87 20 Antoine MAHUL
h3. Un manager peut-il supprimer un projet ?
88 20 Antoine MAHUL
89 60 Antoine MAHUL
Seul un administrateur peut supprimer un projet : [[Documentation#Comment-contacter-les-administrateurs-|contacter les administrateurs]].
90 61 Antoine MAHUL
91 64 Antoine MAHUL
h3. Quelles sont les permissions associées aux différents rôles (Manager, Developer, Reporter) ?
92 64 Antoine MAHUL
93 64 Antoine MAHUL
Voici la synthèse des permissions : attachment:roles-20110124.png
94 63 Antoine MAHUL
95 63 Antoine MAHUL
h2. Wiki
96 63 Antoine MAHUL
97 61 Antoine MAHUL
h3. Comment créer une nouvelle page wiki ?
98 61 Antoine MAHUL
99 62 Antoine MAHUL
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.
100 63 Antoine MAHUL
101 63 Antoine MAHUL
h3. Quel est la syntaxe du wiki ?
102 63 Antoine MAHUL
103 63 Antoine MAHUL
Redmine utilise la syntaxe Textile pour ses pages de wiki. Référence de la syntaxe Textile : http://redcloth.org/hobix.com/textile/