RoadMap GForge : la roadmap (en anglais) qui donne quelques infos sur la 4.7, qui est censée être prête pour lenny (septembre).

Néanmoins, toujours pas de commandes pour lister les shared rosters et récupérer les infos relatives à un groupe malgré la fermeture de mon bug (la nouvelle version est censée apporter ces commandes). Bref, les commandes n’y sont pas, on va devoir continuer à les rajouter à la main. J’essaye cependant de faire rouvrir le bug en espérant qu’il soit pris en compte pour la prochaine version.

Edit : Oups ! La dernière version est la 2.0.1-3, et j’ai testé la 2.0.1-2 à la place. La 2.0.1-3 est disponible en unstable.

Parallèlement au développement du plugin WordPressMU qui apportera un blog pour chaque développeur, j’ai entamé l’écriture d’un plugin pour intégrer PlanetPlanet à GForge afin de pouvoir, entre autres, réunir les articles des blogs concernant chaque projet. C’est un plugin orienté projet, activable et configurable par l’administrateur du projet qui ajoute un onglet Planet au projet et qui affiche une page regroupant l’ensemble des flux choisis par l’administrateur. On peut également de cette manière ajouter des flux extérieurs au site, comme par exemple le blog d’un développeur qui préfère rester sur son site perso plutôt que d’héberger son blog sur la forge.

Exemples de planet :

• http://planet.debian.net
• http://www.planetforge.org/planet/

Ce logiciel est très simple à utiliser : un fichier de configuration très simple et commenté pour chaque planet, ensuite, il suffit de générer la page du planet régulièrement via un script python fourni.

Cette simplicité facilite le travail d’intégration. Par ailleurs, la page étant générée à partir de templates, il est facile de faire un template minimal pour l’intégrer facilement à GForge avec un include php plutot qu’avec un <object> html.

Comme d’habitude, les détails, au fur et à mesure de mon avancement, sur le wiki.

Allez hop, au boulot !

WordPressMU

Qui ne connait pas WordPress, le moteur de blog ?

Et bien WordPressMU, c’est WordPress en version multi-utilisateurs, c’est-à-dire la possibilité de créer très facilement des centaines, des milliers de blogs avec un seul moteur ! Partageant 95% du code avec WordPress, WordPressMU est donc compatible avec beaucoup de plugins et thèmes écrits à la base pour WordPress.

Intégration à GForge

J’ai donc choisi d’intégrer WordPressMU à GForge, ce qui passe par une modification dans l’authentification WordPressMU (pour exploiter la base d’utilisateurs de GForge) ce qui peut se faire par l’écriture d’un plugin, et également le développement d’un plugin pour GForge, afin que les utilisateurs puissent choisir de créer un blog, de le suspendre ou encore de l’effacer pour de bon. On s’interdit évidemment de toucher au noyau des deux logiciels, pour faciliter la maintenance et les mises à jour.

Il serait bon aussi pour l’utilisateur de ne pas avoir à se connecter deux fois, une fois dans GForge puis une fois dans Wordpress.

Pour ceux que l’avancement de ce projet intéresse, voici une liste des points déjà réalisés :

• Authentification WordPress sur la base GForge
• Activation/Désactivation du blog via un plugin dans l’administration du compte GForge

Les points qui devraient être réalisés sous peu :

• Création du blog par le plugin dans l’administration du compte GForge
• Effaçage complet du blog via le même plugin

Enfin, le point qui risque d’être plus délicat :

• Authentification unique pour les deux logiciels

J’invite donc tous les intéressés à me faire part de leurs commentaires et suggestions !

Cet hébergement me servira pour publier fichiers, sources et documentation en anglais. Je continuerai à travailler avec Trac pour la version française en développement. Régulièrement, je publierai de la documentation sous un format plus figé que le wiki lorsqu’elle sera un peu mieux organisée. J’en profiterai pour la traduire en anglais.

Voici quelques bugs corrigés (en anglais) :

Mauvais liens

• Summary: Bad link to editsshkeys.php
  Category: Account Maintenance
  Initial Comment:
  In file /trunk/gforge/www/account/index.php the link pointing at editsshkeys.php is bad : it points at editsshkeys/php instead of account/editsshkeys.php

• Summary: Bad links in grouplist.php
  Category: Site Admin
  Initial Comment:
  In www/admin/grouplist.php :
  $headerLinks = array(
  ‘?sortorder=group_name’,
  ‘?sortorder=register_time’,
  ‘?sortorder=unix_group_name’,
  ‘?sortorder=status’,
  ‘?sortorder=is_public’,
  ‘?sortorder=license_name’,
  ‘?sortorder=members’
  );
  echo $HTML->listTableTop($headers, $headerLinks);

  Something is wrong since generated links are bad :
  http://forge.company.com/?sortorder=group_name
  instead of
  http://forge.company.com/admin/grouplist.php?sortorder=group_name

Bug dangereux

• Summary: Plugin scmcvs : fixes for cronjobs script usergroup.php Written For: None
  Category: CVS
  Initial Comment:
  (working on the trunk)
  I noticed that the /etc/*.new (passwd,group,shadow) files where not correctly created (missing all non gforge users in passwd !)In /opt/gforge/plugins/scmcvs/cronjobs/usergroup.php, files are opened
  with file() which has the filename as a parameter but in this file,
  /etc/passwd & /etc/shadow are opened with a second parameter : “r”.
  The “/etc/group” file is correctly opened.Function file() doesn’t handle this parameter (it’s already read-only) so the script doesn’t work correctly.

  The patch also adds require_once ‘/opt/gforge/plugins/env.inc.php’; so
  that the script knows $gfwww & $gfcommon. (Otherwise it fails
  including the other files).

  It also initialises the $err variable with $err=”;

Warning php

• Summary: Access to an undefined offset in an array
  Category: News
  Initial Comment:
  In the install cd version (4.7b1 according to the wiki http://wiki.planetforge.org/index.php/En:GForge:Debian_Install_CD ) :

  file : www/news/news_utils.php
  version : news_utils.php 6433 2008-03-11 22:54:02Z cbayle
  line : 120if ( (strlen($arr[0]) < 200) && (strlen($arr[1].$arr[2]) < 300) && (strlen($arr[2]) > 5))  {

  $arr is the result of an explode of the news  with <br /> or \n
  as separator depending on whether the news was written in html
  (fckeditor) or in text.

  If there is only one paragraph in the news, $arr[1] and $arr[2] doesn’t exist and you get :

  Notice: Undefined offset: 1 in /usr/share/gforge/www/news/news_utils.php on line 120

  Not very important but easy to fix I think :

  REPLACE :
  if ( (strlen($arr[0]) < 200) && (strlen($arr[1].$arr[2]) < 300) && (strlen($arr[2]) > 5) ) {
  BY :
  if (isset($arr[1]) && isset($arr[2])
  && (strlen($arr[0]) < 200)
  && (strlen($arr[1].$arr[2]) < 300)
  && (strlen($arr[2]) > 5)) {

  This problem repeats on line 240.

Ce script écrit en Perl compare la liste des groupes jabber et celle des projets GForge et s’efforce de les égaliser puis fait la même chose pour les développeurs de chaque projet.

On peut imaginer pour plus tard peut-être un plugin GForge qui permet à chacun de choisir d’apparaitre ou non dans les projets, qui permet à l’administrateur du projet de changer le nom du groupe…

Le script Perl est disponible sur le wiki.

En effet, ejabberdctl ne permet pas de lister les shared rosters et les utilisateurs inscrits dans ces rosters ce qui nous oblige à :

• soit recréer les rosters et les remplir à chaque fois que l’on veut synchroniser les groupes GForge et les groupes Jabber, ce qui est très long car il faut les créer un par un (quelques secondes pour une poignée d’utilisateurs, imaginons pour 10 000 ou 100 000 utilisateurs…).
• soit utiliser une base de données auxiliaire pour stocker cette information et ainsi de modifier que les rosters qui en ont besoin.
• rajouter ces fonctionnalités à ejabberd. Ce n’est pas très compliqué car le code est déjà écrit et est disponible dans le repository de mod_ctlextra.

C’est la première option que j’ai utilisée dans un premier temps, ça fonctionne mais, comme prévu, c’est très long ne serait-ce que pour 5 utilisateurs dans 4 groupes…

Je dois donc me tourner vers la troisième option. J’aurais consideré un peu plus la deuxième si le code n’était pas déjà écrit car ejabberd est codé en Erlang, langage avec lequel je n’ai pas encore beaucoup d’expérience.

Pour avoir un déploiement le plus simple possible et également pour apporter ma pierre à l’édifice, j’ai choisi de modifier le paquet Debian. Si la procédure vous intéresse, elle est disponible sur le wiki.

Cette modification a été proposée en wishlist au mainteneur du paquet.

En projet : modifier le script qui créer les groupes pour tenir compte de ces nouvelles commandes.

Il est codé en Erlang, ce qui offre d’intéressantes possibilités : montée en charge, clustering, tolérance aux pannes…

Pour notre projet de forge, nous souhaitons que chaque développeur inscrit dans un ou plusieurs projets se voit automatiquement attribuer un compte jabber (user@forge.evolix.net par exemple) et retrouve dans ses contacts, tout aussi automatiquement, l’ensemble des développeurs avec qui il travaille, groupés par projet.

Authentification

Pour ce qui est de l’authentification, ejabberd a le bon goût de permettre l’utilisation d’un script externe pour identifier les utilisateurs. J’ai aussitôt écrit un petit script Perl qui exploite la base d’utilisateur GForge. Ainsi, l’authentification est centralisée et les comptes utilisateurs ne sont pas inutilement dupliqués. Ce même script permet également de changer son mot de passe GForge via un client Jabber (puisque c’est le même mot de passe).

Contacts partagés

En ce qui concerne les groupes de contacts, ejabberd intègre la notion de ’shared roster’ qui permet de créer des groupes partagés. Via l’interface web d’aministration du serveur, on peut aisément créer de tels groupes. Ce qui nous intéresse, c’est de pouvoir créer ces groupes automatiquement, via un cronjob par exemple. Ejabberd est livré avec ejabberdctl qui permet d’effectuer certaines opérations d’administration en ligne de commande. mod_ctlextra, un module pour ejabberd y ajoute encore des commandes, dont la gestion des shared rosters. Malheureusement, dans le paquet pour Debian, la version n’est pas la dernière révision du dépôt de mod_ctlextra, aussi manque t-il quelques commandes utiles.

Ici aussi, j’ai écrit un script Perl qui liste les projets existants sur GForge et créer les groupes Jabber correspondants puis liste les développeurs de chaque projet afin de remplir les groupes. Ainsi, lorsqu’un développeur se connecte à son compte Jabber, il a directement accès à autant de groupes de contacts pré-remplis que de projets auquels il contribue.

Ce script recrée à chaque fois l’ensemble des groupes et les re-remplit à chaque fois car la version de mod_ctlextra incluse dans le paquet Debian ne permet pas de lister les groupes existants ni les utilisateurs dans ces groupes.

En projet : modifier le paquet Debian pour inclure les commandes pour lister les shared rosters.

Vous retrouverez tous les détails techniques et procédures sur le trac/wiki.