Présentation de l`outil "forge"

Transcription

Présentation de l’outil ”forge”
Franck Pérignon
Laboratoire Jean Kuntzmann - 38000 Grenoble
ENVOL 2010 - 27 septembre, 1er octobre - Autrans
http: // www. projet-plume. org/ envol2010
Objectifs et organisation du cours
Essayer de répondre aux questions suivantes . . .
Qu’est ce qu’une forge et à quoi ça sert ?
Comment utiliser une forge (FusionForge) ?
⇒ aujourd’hui: les idées générales et quelques démos.
⇒ demain: TP FusionForge,
inscription sur la forge, création, utilisation et administration d’un projet, etc.
Questions annexes:
quelle forge choisir ?
comment installer sa propre forge ?
Plan du cours
1
Généralités sur les forges
2
Fonctionnement et utilisation de FusionForge
3
Conclusions
Définition et objectifs d’une forge
1
Accès à une forge
Les logiciels de forge
FusionForge
2
La forge vue du monde extérieur
Les utilisateurs
Inscription et gestion du compte
Accès via ssh
Devenir membre ou créer un projet
Les projets
Les outils
Administration d’un projet
3
Conclusions
4 / 65
Définition
Qu’est ce qu’une forge ?
Outil de travail collaboratif
Mise en relation de personnes d’horizons différents (développeurs,
coordonnateurs, ...) au sein de projets.
Mise à disposition d’un ensemble d’outils spécifiques à chaque projet.
Bref: un gestionnaire de projets.
5 / 65
Définition
Qu’est ce qu’une forge ?
Outil de travail collaboratif
Mise en relation de personnes d’horizons différents (développeurs,
coordonnateurs, ...) au sein de projets.
Mise à disposition d’un ensemble d’outils spécifiques à chaque projet.
Bref: un gestionnaire de projets.
En pratique:
un site web ;
des utilisateurs (login) et des projets ;
des outils configurables via l’interface web ;
différents niveaux de droits sur les outils et les projets (visibilité, écriture ...).
5 / 65
Quelques exemples de forges
Figure: La forge du LJK
Figure: La forge de l’INRIA
Figure: La forge des universités
A quoi sert une forge?
Collaboration ”interne” au projet, facilite le travail collectif.
Espace de travail (svn . . . ) et d’échanges (listes de diffusion . . . ).
Statistiques, activité, état d’avancement du projet.
Atténuation des contraintes géographiques.
Pérennisation du projet (sauvegardes, doc . . . )
9 / 65
Visibilité du projet.
Contacts, échanges avec les membres du projet (support en ligne,
documentation, suivi de bugs . . . ).
Vue sur l’activité, la maturité du projet.
Téléchargement de code, de documents.
9 / 65
Mais également . . .
Vitrine d’un laboratoire : vue synthétique sur ses projets et ses activités.
Projets ”mono-utilisateur” (sauvegarde, accès ”multi-sites”, etc. Exemple:
thèse).
9 / 65
Mais également . . .
Vitrine d’un laboratoire : vue synthétique sur ses projets et ses activités.
Projets ”mono-utilisateur” (sauvegarde, accès ”multi-sites”, etc. Exemple:
thèse).
Tous les outils sont disponibles indépendamment de la forge mais les principaux
avantages de celle-ci sont:
un accès à tous les outils via une seule interface ;
l’absence de travail d’installation préalable ;
une utilisation relativement intuitive ;
9 / 65
Quelques exemples de projets types
Historiquement: dédiée à la gestion de développement collaboratif de logiciel;
projets = groupes de développeurs.
Développement de logiciel.
Mais une forge est également très bien adaptée pour:
La rédaction d’articles, de livres, etc.
Les projets européens, les ANR, la préparation d’un plan quadriennal . . .
Les thèses.
L’enseignement (sauvegarde des cours et diffusion aux élèves).
...
10 / 65
Quelques exemples de projets types
Historiquement: dédiée à la gestion de développement collaboratif de logiciel;
projets = groupes de développeurs.
Développement de logiciel.
Mais une forge est également très bien adaptée pour:
La rédaction d’articles, de livres, etc.
Les projets européens, les ANR, la préparation d’un plan quadriennal . . .
Les thèses.
L’enseignement (sauvegarde des cours et diffusion aux élèves).
...
Attention: tout est sauvegardé dans une base de donnée, donc a priori une forge
n’a pas vocation à stocker de gros volumes de données.
10 / 65
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
11 / 65
Comment avoir accès à une forge?
Se servir d’une des forges existantes sur le web, sous réserve que les critères
d’utilisation ne soient pas trop limitants.
Installer sa propre forge via un des logiciels disponibles ... au prix de quelques
efforts.
12 / 65
Comment avoir accès à une forge?
Se servir d’une des forges existantes sur le web, sous réserve que les critères
d’utilisation ne soient pas trop limitants.
Installer sa propre forge via un des logiciels disponibles ... au prix de quelques
efforts.
Remarques: (débat d’hier soir ...)
il existe un projet en cours pour la mise en place d’une forge ”Enseignement
supérieur et recherche”:
http: // www. projet-plume. org/ fr/ ressource/ projet-forge-esr .
Voir aussi la fiche plume pour les forges susceptibles d’accueillir des projets de la
communauté ”enseignement-recherche”:
http: // www. projet-plume. org/ fr/ ressource/ faq-forge .
12 / 65
Quelques exemples de forges:
http: // sourceforge. net/ (uniquement pour les développements
OpenSource)
http: // savannah. gnu. org/ (”logiciels libres qui fonctionnent sur des
systèmes libres et sans dépendance propriétaire”)
http: // www. novaforge. org/ (Bull)
https: // sourcesup. cru. fr/ (forge destinée aux établissements
d’enseignement supérieur et aux organismes de recherche français, limitée aux
projets publics)
https: // gforge. inria. fr/ (la forge de l’INRIA)
https: // alioth. debian. org/ (pour le projet Debian)
http: // www. adullact. org/ (”logiciels libres utiles aux missions de
service public”)
https: // ljkforge. imag. fr (forge du LJK)
13 / 65
Quelques exemples de forges:
http: // sourceforge. net/ (uniquement pour les développements
OpenSource)
http: // savannah. gnu. org/ (”logiciels libres qui fonctionnent sur des
systèmes libres et sans dépendance propriétaire”)
http: // www. novaforge. org/ (Bull)
https: // sourcesup. cru. fr/ (forge destinée aux établissements
d’enseignement supérieur et aux organismes de recherche français, limitée aux
projets publics)
https: // gforge. inria. fr/ (la forge de l’INRIA)
https: // alioth. debian. org/ (pour le projet Debian)
http: // www. adullact. org/ (”logiciels libres utiles aux missions de
service public”)
https: // ljkforge. imag. fr (forge du LJK)
Avantages: immédiatement disponible, maintenance extérieure.
Limites: confidentialité, accès, restrictions au niveau du type de projet.
Une solution: installer sa propre forge.
13 / 65
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
14 / 65
Voir http: // fr. wikipedia. org/ wiki/ Forge_ ( informatique)
Quelques exemples:
Codendi (http: // www. codendi. com/ ), Xerox
GForge AS (http: // gforge. org/ )
FusionForge (http: // fusionforge. org/ )
Projet coclico http: // www. projet-coclico. org/ index. php/ INNOVATION
15 / 65
Quelques exemples:
Attention: une forge est basée sur de nombreux softs et services:
base de données, postgres et mysql, mail, postfix et mailman, web, apache2, ssh,
subversion, etc.
⇒ installation relativement simple mais configuration potentiellement (très)
fastidieuse.
15 / 65
Quelques exemples:
Attention: une forge est basée sur de nombreux softs et services:
base de données, postgres et mysql, mail, postfix et mailman, web, apache2, ssh,
subversion, etc.
⇒ installation relativement simple mais configuration potentiellement (très)
fastidieuse.
Avant de se lancer dans la mise en place d’une forge . . .
Quels sont mes vrais besoins?
Existe t’il une forge accessible qui réponde à ces besoins?
15 / 65
FusionForge
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
16 / 65
FusionForge
A propos de FusionForge
FusionForge
est un logiciel permettant la mise en place d’une forge sur des plates-formes de
type Linux (http: // fusionforge. org/ ).
Origines: branche issue de SourceForge puis GForge lorsque le code de ceux-ci est
devenu propriétaire.
SourceForge → GForge4.x → FusionForge (actuellement 5.0)
Installation:
Sources (tar.gz) ou paquets pour Debian/Ubuntu et RedHat/Fedora.
Les TP et la suite de ce cours traiteront uniquement de FusionForge.
17 / 65
1
2
3
Conclusions
18 / 65
A partir de maintenant, ”tutoriel” et démos FusionForge.
Les illustrations seront faites directement sur le site web, sur
https: // ljkforge. imag. fr , https: // gforge. inria. fr/
(forges ”en production”) ou sur
https: // forge. imag. fr (forge utilisée pour les TP).
Sur les transparents: uniquement le mode d’accès aux pages concernées et les
remarques ou points clés.
19 / 65
Introduction
Résumons . . .
La forge ce sont:
des utilisateurs authentifiés ...
20 / 65
Introduction
Résumons . . .
La forge ce sont:
...appartenant à différents projets ;
20 / 65
Introduction
Résumons . . .
La forge ce sont:
des visiteurs potentiels via le site web ;
20 / 65
Introduction
Résumons . . .
La forge ce sont:
des outils réglables pour chaque projet.
20 / 65
Introduction
Résumons . . .
La forge ce sont:
des outils réglables pour chaque projet.
et différents statuts:
visiteur
utilisateur
membre d’un projet
administrateur d’un projet
administrateur de la forge
20 / 65
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
21 / 65
Visiteur
Visiteur: n’importe quelle personne non authentifiée visitant le site web de la
forge.
Quelles possibilités?
Accès en lecture à toutes les catégories et projets publics du site.
Eventuellement en ”écriture” à certaines listes de diffusion, aux wikis ... selon
les règles fixées par les administrateurs de projets.
Quels intérêts?
Vue d’ensemble sur les projets et (une partie de) l’activité du laboratoire.
Source d’information sur un projet, un logiciel, interface pour les utilisateurs
(aide, wiki, téléchargement de document ou de code).
22 / 65
La page d’accueil
Un aperçu de la ”vie” de la forge.
https: // ljkforge. imag. fr/
Présentation de la forge.
Annonces, globales ou spécifiques à certains projets.
Statistiques générales : activités des projets, liste de mots clés, etc.
Identification/connexion ( Onglet ”Ma Page” ou en haut à droite).
Un moteur de recherche (personnes, projets).
23 / 65
Onglet Projets
Accès à la liste des projets publics par différents modes de classement.
https: // forge. imag. fr/ softwaremap/ tag_ cloud. php
Nuage d’étiquettes : une liste de mots clés permettant de cibler certains
projets;
Arbre des projets : classement des projets par catégories;
Liste des projets : par ordre alphabétique, uniquement les projets publics.
Pour chaque projet : un résumé, des mots clés et la date de création.
Attention: le classement par mot-clé dépend du référencement effectué par les
administrateurs du projet.
24 / 65
Boite à outils
Echantillons de code classés par catégorie.
https: // forge. imag. fr/ snippet/
25 / 65
Les utilisateurs
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
26 / 65
Les utilisateurs
Les utilisateurs
Utilisateur: personne enregistrée et authentifiée sur la forge.
Être inscrit permet de:
demander à rejoindre un ou des projets ;
créer ses propres projets ;
soumettre des bouts de code ;
évaluer des utilisateurs.
Comment s’inscrire?
Onglet ”Ma page” ou ”Nouveau compte”, remplir le formulaire et confirmer après
réception d’un mail.
https: // forge. imag. fr/ account/ register. php
27 / 65
Les utilisateurs
Onglet Ma Page
Gestion du compte personnel, i.e. tous les réglages concernant l’utilisateur,
indépendamment des projets.
https: // forge. imag. fr/ my/
Ma page personnelle: listes des éléments, tâches, projets ... qui touchent
l’utilisateur.
Tableau de bord: listes de tous les suivis de bugs de vos projets
Journal
Gestion du compte: email, password, clé, etc.
Enregistrement d’un projet
28 / 65
Les utilisateurs
Gestion du compte
Réglage des préférences et informations personnelles.
https: // forge. imag. fr/ account/
Nom du compte.
Choix du mot de passe.
Choix du mail.
Clé ssh
29 / 65
Les utilisateurs
Authentification et clé ssh
L’authentification via ssh est nécessaire pour:
l’utilisation des gestionnaires de version (svn, git ...) ;
la connexion distante sur la forge.
Il faut donc déposer une clé ssh sur la forge.
Comment?
Ma Page → Gestion du compte → éditer les clés
https: // forge. imag. fr/ account/ editsshkeys. php
Copier le contenu du fichier id rsa.pub (ou id dsa.pub) obtenu en lançant dans un
terminal la commande ssh-keygen.
Remarques:
le dépôt de clé n’est possible que lorsqu’on est membre d’au moins un projet
(inscription⇒ création d’un compte unix sur la machine forge) ;
une seule clé est nécessaire quelque soit le nombre de projets où vous êtes
impliqué ;
pas de limite au nombre de clés que vous pouvez déposer.
30 / 65
Les utilisateurs
Accès à la machine en ssh
Il est possible de se connecter en ssh sur la forge.
Dans quel but?
Accès au dépot central du gestionnaire de version (”hooks” de svn . . . ).
Dépôt de pages web.
En principe il s’agit d’un environnement ”chrooté” et donc avec une liberté
d’action très limitée.
Accès au répertoire du projet :
ssh [email protected]
cd /scmrepos/svn/nom_du_projet
31 / 65
Les utilisateurs
Comment devenir membre d’un projet?
Si le projet est public: sur la page d’accueil du projet (recherche via le moteur
ou par l’arbre des projets), cliquer sur ”demander à rejoindre le projet”.
Exemple: https: // forge. imag. fr/ projects/ projettest/
Si le projet est privé: contacter un de ses administrateurs.
Le rôle (i.e. les droits) de l’utilisateur dans le projet est fixé par le ou les
administrateurs du projet.
32 / 65
Les utilisateurs
Enregistrement d’un projet
Comment: MaPage → Enregistrer un projet, remplir la fiche et attendre la
validation. https: // forge. imag. fr/ register/ projectinfo. php
Conditions: être utilisateur plus éventuellement d’autres critères dépendant de la
forge visée.
Points importants
Choix du nom unix: ne pourra plus être modifié après l’enregistrement du
projet.
Choix du gestionnaire de version: modifiable mais mieux vaut faire tout de
suite le bon choix . . .
Choix du type de projet: public (visible par n’importe qui), privé (visible
uniquement par les membres du projet).
Remarques: la visibilité du projet est modifiable ; de plus des réglages plus fins
sont possibles pour chaque outil du projets.
33 / 65
Les utilisateurs
Accès aux projets
Comment accéder à ses projets?
via le moteur de recherche ou l’onglet Projets;
pour ses propres projets: Ma Page → Projets
https: // forge. imag. fr/ my/ .
34 / 65
Les projets
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
35 / 65
Les projets
Projet
Des utilisateurs.
Une thématique, un centre d’intérêt commun.
Des outils.
Page d’accueil d’un projet :
https: // forge. imag. fr/ projects/ projettest/
Nom du projet à droite de la barre d’onglets.
Une nouvelle série d’onglets est disponible: un par outil.
36 / 65
Les projets
Onglet Résumé
Présentation du projet, des ses membres et résumé de son activité récente.
https: // gforge. inria. fr/ projects/ siconos
Liste des participants.
Résumé du projet et étiquettes.
Statistiques sur l’activité du projet.
Annonces.
Liste des zones publiques.
Dernières publications.
37 / 65
Les outils
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
38 / 65
Les outils
Activité
Accès aux statistiques du projet, historique des dernières actions.
https: // forge. imag. fr/ activity/ ?group_ id= 6
39 / 65
Les outils
Forum
forum de discussion
https: // forge. imag. fr/ forum/ ?group_ id= 6
Possibilité de les suivre (tag dans ”Ma Page”)
40 / 65
Les outils
Outil de suivi de problèmes
interface permettant aux utilisateurs de déposer des requêtes, de soumettre des
bugs etc.
Exemple:
https: // gforge. inria. fr/ tracker/ index. php? group_ id= 9&atid= 680
41 / 65
Les outils
Listes de diffusion
Interface standard: gestion des abonnements, accès aux archives ...
https: // forge. imag. fr/ mail/ ?group_ id= 6
Une liste présente par défaut pour tous les projets: commits.
Aucune inscription automatique.
42 / 65
Les outils
Gestionnaire de tâches
Définition et attribution de tâches aux membres du projet.
https: // gforge. inria. fr/ pm/ task. php? group_ project_ id=
11&group_ id= 9&func= browse
43 / 65
Les outils
Documents
Mise en ligne et classement de documents
https: // ljkforge. imag. fr/ docman/ ?group_ id= 95
44 / 65
Les outils
Sondages
création, édition et consultation de sondages.
https: // forge. imag. fr/ survey/ ?group_ id= 6
Annonces
Publication d’annonces locales au projet ou globales (i.e. sur la page d’accueil de
la forge)
https: // forge. imag. fr/ news/ ?group_ id= 6
45 / 65
Les outils
Sources
Gestionnaire de version, svn git. . .
https: // forge. imag. fr/ scm/ ?group_ id= 6
Résumé des commandes disponibles pour l’accès aux sources (anonyme ou
identifié).
Parcours du dépôt via l’interface web (exclusivement pour les projets publics
autorisant l’accès anonyme).
Statistiques des commits.
Pour les détails d’utilisation de svn ou git, voir les autres cours de cette école ...
46 / 65
Les outils
Fichiers
Publication de paquets (release logiciel ...) et de fichiers.
Exemple: https: // gforge. inria. fr/ frs/ ?group_ id= 9
Très utile pour la diffusion de logiciel: archivage des releases, diffusion de
binaire pour différentes plates-formes etc.
Accès aux stats de téléchargement.
Log de publication.
47 / 65
Les outils
Wiki
Un mediawiki classique.
https: // forge. imag. fr/ plugins/ mediawiki/ wiki/ projettest/ index.
php/ Main_ Page
Inscription par défaut des membres du projets.
Visibilité et droits réglables.
48 / 65
1
FusionForge
2
Les utilisateurs
Accès via ssh
Les projets
Les outils
3
Conclusions
49 / 65
Les administrateurs et les autres ...
Pour chaque projet, un rôle privilégié: l’administrateur
Contrôle l’affichage des informations liées au projet.
Gère l’ajout d’utilisateurs et les attributions des rôles des autres membres du
projets.
Active (ou non) les différents outils.
Configure les outils.
Remarques:
Pas de limites au nombre d’administrateurs.
Pour les administrateurs: apparition d’un nouvel onglet dans la barre du
projet.
50 / 65
Administration: informations sur le projet
https: // forge. imag. fr/ project/ admin/ ?group_ id= 6
Nom et description du projet.
Mode d’accès.
Choix d’étiquettes et classement dans l’arbre des projets.
Choix de l’adresse du site web.
Visibilité.
Alerte email.
51 / 65
Administration: les rôles dans un projet
Ajout/suppression de membres du projet et édition de leurs droits sur chaque outil
du projet.
https: // forge. imag. fr/ project/ admin/ users. php? group_ id= 6
un ensemble de rôles standards prédéfinis, modifiables.
la possibilité d’éditer de nouveaux rôles.
Attention: penser à valider toute modification avec le bouton ”mise à jour”.
52 / 65
Administration: choix des outils
Liste des outils disponibles et liens vers leur page d’administration.
https: // forge. imag. fr/ project/ admin/ tools. php? group_ id= 6
53 / 65
Administration: autres catégories
Historique du projet : historique des modifications avec leur auteur.
Hôtes virtuels : alias sur le nom de la page.
Statistiques : téléchargements, forum etc.
54 / 65
Administration de chaque outil
Pour le réglages spécifiques, chaque outil possède son interface d’administration
Comment y accéder?
onglet Administration→outils
onglet de l’outil →administration
Ensuite les réglages sont assez intuitifs ...
Remarque : l’accès à l’interface administrative de chaque outil n’est pas
nécessairement réservée aux administrateurs du projet. Tout dépend des
caractéristiques du rôle de chacun.
55 / 65
Administration des forums
Création de nouveaux forums.
Modifications des forums existants
https: // forge. imag. fr/ forum/ admin/ ?group_ id= 6
56 / 65
Outil de suivi de problèmes
Création de nouveaux outils de suivi.
Personnalisation (ajout de champs, de réponses types . . . )
https: // forge. imag. fr/ tracker/ admin/ ?group_ id= 6
57 / 65
Listes de diffusion
Chaque liste a sa propre interface d’administration.
Un mot de passe spécifique à chaque liste (différent de votre mot de passe de
connexion).
Nombreux réglages possibles (filtrage . . . ).
http: // lists. forge. imag. fr/ mailman/ admin/ projettest-commits
58 / 65
Gestionnaire de tâches
Ajout/édition/suppression de catégories
59 / 65
Documents
Choix du statut des documents (visible, à supprimer ...).
Création de groupes de documents.
https: // forge. imag. fr/ docman/ admin/ index. php? group_ id= 6
60 / 65
Sondages et annonces
Ajout de questions.
Création de sondages.
Dépouillement.
Acceptation des annonces.
61 / 65
Sources
Choix du gestionnaire.
Activation de l’accès anonyme.
62 / 65
Fichiers
Création et édition de paquets.
Gestion de la visibilité des fichiers.
63 / 65
Conclusions
1
2
3
Conclusions
64 / 65
Conclusions
Quelques remarques ...
Expérience personnelle ...
En tant qu’utilisateur
Forge: très pratique et facile à utiliser.
Principaux outils utilisés:
Listes de diffusion
SVN
Fichiers
Bug tracker
Le reste : plus ”gadget” ...
65 / 65
Conclusions
Quelques remarques ...
Expérience personnelle ...
En tant qu’utilisateur
Forge: très pratique et facile à utiliser.
Principaux outils utilisés:
Listes de diffusion
SVN
Fichiers
Bug tracker
Le reste : plus ”gadget” ...
En tant qu’administrateur
La procédure d’installation s’est beaucoup améliorée.
La configuration et la mise en place ”propre” restent très fastidieuses.
Au quotidien : demande peu de maintenance, sauf en cas de migration ou de
mise à jour importante.
Derniers points à discuter si vous êtes intéressés ...
65 / 65

Présentation de l`outil "forge"

Transcription

Documents pareils

Modèle WORD AREVA

Tourmaline Noire - perlesunpeintpeint.fr

Supply-Chain.fr : Emploi Achat - Emploi Logistique

Dépliant du forgeron Léo Saint-Laurent - Saint-Anaclet-de

atelier_collectif

Un lieu polyvalent de création

Saucissons à la mourine Par MM. Benoît Leblanc et Claude

POSTE PROFESSEUR HISTOIRE-GEOGRAPHIE (10h

Télécharger le communiqué de presse

Un artisan - Chambre de métiers et de l`artisanat de région