Plan Vigipirate rehaussé au niveau urgence attentat. Restez vigilants et informés. En savoir plus

doc

SOURCEFORGE
Gestion de projets opensource ISAE

DOCUMENTATION

Outil de gestion des projets opensource de l’ISAE-SUPAERO

Les FORGES de l’ISAE proposent des services numériques instrumentant la gestion des projets ISAE.

Il existe quatre forges différentes, adaptées à différents cas d’utilisation :

  • https://forge.isae.fr : pour gérer les projets internes de l’ISAE ;
  • https://openforge.isae.fr : pour gérer les projets ISAE qui peuvent intégrer des utilisateurs externes (en particulier, les projets de recherche)
  • https://eduforge.isae.fr : pour gérer les projets menés dans le cadre des formations de l’ISAE par les étudiants
  • https://sourceforge.isae.fr (bientôt) : pour gérer les projets ISAE « open source » avec possibilité aux internautes de s’ouvrir un compte sur la plateforme pour contribuer aux projets.

La spécificité principale des forges est liée aux types d’utilisateurs pouvant s’y connecter et parcourir ou contribuer aux projets. Plus spécifiquement, les caractéristiques des différentes forges sont présentées dans le tableau suivant :

Caractéristiques comparées des différentes forges ISAE
FonctionnalitésForgeOpenforgeEduforgeSourceforge
Usages Projets internes Projets Externes Projets d’enseignement Projets opensources
Utilisateurs ISAE
Utilisateurs Externes déclarés ISAE
Internautes auto-déclarés
Authentification unique (CAS)
Authentificaton ISAE (LDAP)
Authentification locale à l’instance
Accès Internet
Version Redmine 3.4.6 3.4.6 3.4.6 3.4.6

Chaque espace projet peut être public ou privé. Un espace projet public est visible par tous les utilisateurs de la forge, un espace projet privé n’est visible qu’aux membres du projet.

FORGES ISAE, propulsées par Redmine

Les forges ISAE sont principalement basées sur le logiciel Redmine, application web pour la gestion flexible de projets. Redmine est un logiciel opensource sous licence GPL et écrit dans le langage Ruby.

Les principales fonctionnalités de Redmine sont :

  • Gestion multi-projets ;
  • Projet Public ou Privé par espace projet ;
  • Contrôle basé sur les rôles ;
  • Système de trackers (types de tickets) flexible ;
  • Gantt et Calendrier associés aux dates des tickets ;
  • News, Documents et fichiers ;
  • Flux RSS, Notification par email ;
  • Wiki par espace projet ;
  • Gestion du temps ;
  • Champs spécifiques pour les tickets, suivi du temps ;
  • Gestion de code source (SCM, Source Code Management) associé aux logiciels SVN et GIT ;
  • Forum par espace projet ;
  • Création de ticket par emails ;
  • Authentification multiple, dont LDAP ISAE ;
  • Auto-enregistrement d’utilsiateurs (uniquement sur sourceforge) ;
  • Multilingue ;
  • etc.

Pour plus d’information sur Redmine, consultez le site original : https://www.redmine.org.

Documentation commune aux forges

Les logiciels utilisés dans les forges sont documentés sur leur site web associé.

Les instances de forge sont étendues avec quelques plugins, notamment :

  • Le Wiki est étendu avec deux plugins permettant de nombreuses fonctions supplémentaires :
  • La liste des Macros utilisable dans les champs WIKI (dans le WIKI, mais également dans les tickets, forum, etc.) est disponible ici en tapant la macro @macro_list@ dans un champ Wiki ;
  • AGILE : facilite la manipulation des tickets en particulier dans le cadre d’une méthode AGILE (SCRUM, Kanban) - voir la documentation du plugin ici.

Faites une demande sur le Centre de services SI de l’ISAE pour créer un nouvel espace projet dans l’une des forges proposées.

Spécificités des FORGES

OPENFORGE

Accès

Ce système est accessible depuis le réseau Internet mais un compte ISAE ou « openforge » est nécessaire pour accéder à la plateforme. Une fois connecté, les espaces projets peuvent être publics ou privés c’est à dire visibles par les membres de la plateforme (public) ou uniquement du projet (privé).

Source Code Management

Le SCM par défaut d’openforge est SVN.

Chaque espace projet peut être paramétré par l’administrateur local de l’espace, avec différentes activités : Gestion des tickets, Wiki, Dépot de fichiers, forum de discussion, publication d’annonces, et dépot de sources (SVN).

Concernant le dépot de sources, il s’agit de Apache Subversion - SVN. Pour associer un dépôt à un espace projet, aucune configuration n’est nécessaire hormis la validation par l’administrateur local du projet, du service de dépot dans le sous-onglet Modules de la Configuration du projet. Ensuite, l’accès aux dépôt est possible en utilisant l’URL https://openforge.isae.fr/svn/. Par exemple le checkout du projet « Bac à sable » dont l’identiant est sp sera possible avec la commande :

svn co https://openforge.isae.fr/svn/sp

SOURCEFORGE

Accès

Ce système est accessible depuis le réseau Internet et les espaces projets « public » (un paramètre de vos projet) sont visibles sans avoir de compte sur la plateforme. Il est possible de se connecter avec un compte ISAE ou les internautes peuvent se créer un compte et ainsi accéder aux demandes dans les projets (pouvoir poster une demande, un bug, un message dans un forum, etc.).

Source Code Management

Le SCM de sourceforge est basé sur l’outil GIT. De nombreux tutoriaux existent sur l’utilisation de cet outil, voir par exemple la documentation de l’outil sur du site GIT ou une simulation guidée vous permettant de faire vos premier pas avec GIT .

Par défaut un repository GIT est créé lors de la création d’un espace projet. Le repository est visible dans l’onglet REPOSITORY de la forge.

En supposant que votre projet ait l’identifiant (utilisé aussi dans l’URL du projet), l’accès au repository GIT associé devra utiliser l’adresse :

git https://sourceforge.isae.fr/git/<IdentifiantProjet>

Par exemple, une fois que vous avez initialisé votre repository GIT local, la commande suivante permet d’initialiser le repository sourceforge à ce repo local :

git remote add origin https://sourceforge.isae.fr/git/sandbox

Ensuite, il est possible de synchroniser les dernières modifications :

git push -u origin master

Plus d’information

Voir en ligne : https://sourceforge.isae.fr