Documentation » History » Version 71

Antoine MAHUL, 06/11/2013 10:30 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 67 Antoine MAHUL
Pour cloner un projet (_myproject_ par exemple), il faut utiliser la commande :
54 67 Antoine MAHUL
<pre>
55 67 Antoine MAHUL
git clone https://login@forge.clermont-universite.fr/git/toto
56 67 Antoine MAHUL
</pre>
57 1 Antoine MAHUL
58 68 Antoine MAHUL
Pour ajouter le dépôt distant de la forge à un dépôt Git local existant :
59 67 Antoine MAHUL
<pre>
60 69 Antoine MAHUL
git remote add forge https://login@forge.clermont-universite.fr/git/myproject
61 67 Antoine MAHUL
</pre>
62 1 Antoine MAHUL
63 67 Antoine MAHUL
h3. Comment court-circuiter la vérification du certificat avec Git ?
64 67 Antoine MAHUL
65 66 Antoine MAHUL
L'erreur correspondante est la suivante : "error: server certificate verification failed."
66 1 Antoine MAHUL
67 68 Antoine MAHUL
Il y a 2 moyens :
68 68 Antoine MAHUL
* soit en définissant la variable d'environnement GIT_SSL_NO_VERIFY=true
69 69 Antoine MAHUL
* soit globalement avec la commande git suivante :
70 68 Antoine MAHUL
<pre>git config --global http.sslverify "false"</pre>
71 67 Antoine MAHUL
72 68 Antoine MAHUL
h3. Comment configurer un dépôt Git sous Eclipse?
73 67 Antoine MAHUL
74 67 Antoine MAHUL
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 :
75 67 Antoine MAHUL
<pre>
76 67 Antoine MAHUL
https://login:password@forge.clermont-universite.fr/git/myproject
77 67 Antoine MAHUL
</pre>
78 66 Antoine MAHUL
79 46 Antoine MAHUL
h3. Comment lier une révision à une demande
80 54 Antoine MAHUL
81 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.
82 53 Antoine MAHUL
83 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. 
84 58 Antoine MAHUL
85 25 Antoine MAHUL
h3. Peut-on utiliser un autre outil de gestion de version ?
86 58 Antoine MAHUL
87 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/).
88 63 Antoine MAHUL
89 20 Antoine MAHUL
h2. Administration d'un projet
90 20 Antoine MAHUL
91 20 Antoine MAHUL
h3. Comment créer un nouveau projet
92 20 Antoine MAHUL
93 9 Antoine MAHUL
Il y a deux conditions pour pouvoir créer un nouveau projet : 
94 58 Antoine MAHUL
# être authentifié sur la Forge par le "_Single Sign On_":http://fr.wikipedia.org/wiki/Sso de son établissement
95 20 Antoine MAHUL
# être identifié comme personnel dans l'annuaire du personnel
96 20 Antoine MAHUL
97 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.
98 20 Antoine MAHUL
99 20 Antoine MAHUL
100 20 Antoine MAHUL
h3. Quelle est la différence entre un projet public et un projet privé ?
101 20 Antoine MAHUL
102 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. 
103 20 Antoine MAHUL
104 20 Antoine MAHUL
h3. Un manager peut-il supprimer un projet ?
105 20 Antoine MAHUL
106 60 Antoine MAHUL
Seul un administrateur peut supprimer un projet : [[Documentation#Comment-contacter-les-administrateurs-|contacter les administrateurs]].
107 61 Antoine MAHUL
108 64 Antoine MAHUL
h3. Quelles sont les permissions associées aux différents rôles (Manager, Developer, Reporter) ?
109 64 Antoine MAHUL
110 71 Antoine MAHUL
Voici la synthèse des permissions : attachment:roles-20130611.png
111 63 Antoine MAHUL
112 63 Antoine MAHUL
h2. Wiki
113 63 Antoine MAHUL
114 61 Antoine MAHUL
h3. Comment créer une nouvelle page wiki ?
115 61 Antoine MAHUL
116 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.
117 63 Antoine MAHUL
118 63 Antoine MAHUL
h3. Quel est la syntaxe du wiki ?
119 63 Antoine MAHUL
120 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/
121 70 Antoine MAHUL
122 70 Antoine MAHUL
h3. Comment ajouter un fil d'Ariane aux pages du wiki ?
123 70 Antoine MAHUL
124 70 Antoine MAHUL
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 :
125 70 Antoine MAHUL
126 70 Antoine MAHUL
* d'afficher sur les pages "enfants" un fil d'Ariane avec les pages "parentes" dans l'arborescence ainsi définie,
127 70 Antoine MAHUL
* de présenter l'index par titre des pages du wiki sous cette forme arborescente.