MyPads point de la semaine 17

Temps de lecture 7 min

image_pdfimage_print

Comme annoncé la semaine dernière, c’est désormais un point hebdomadaire qui émaillera le travail autour de MyPads. Cette semaine n’aura pas été de tout repos et les avancées visibles sont malheureusement peu nombreuses. Explications.


img-mypads-ulule2

Les travaux

La mise en place des tests fonctionnels client, simulant une navigation réelle, a occupé les premiers jours de développement. Ensuite MyPads a subi quelques modifications pour fonctionner avec la version 4 d’Express, le cadre de développement sur lequel repose Etherpad et donc MyPads. Cette migration a été initiée par le tout premier contributeur externe au plugin, et a été rendue nécessaire par la migration d’Etherpad une semaine plus tôt.

Cette migration a été l’occasion de tester à nouveau la compatibilité de MyPads avec Eherpad. Cela peut sembler étonnant, mais MyPads est développé de manière autonome vis à vis d’Etherpad et est régulièrement testé en tant que plugin Etherpad, pour les raisons suivantes :

  • accélérer le développement et éviter de devoir relancer Etherpad voire réinstaller le plugin à chaque modification ;
  • permettre les tests unitaires et fonctionnels serveur, très difficile sinon à partir d’un plugin Etherpad, isoler une base de tests du reste de l’instance ;
  • conserver une forme d’indépendance vis à vis du cœur d’Etherpad : afin de ne pas nécessiter des modifications d’Etherpad lui-même et de limiter les régressions en cas de changements internes de ce dernier.

Malheureusement le fonctionnement de MyPads s’est révélé erratique : parfois correct, parfois non. Pour les techniciens, seules les méthodes GET et HEAD sont autorisées et toute autre méthode HTTP est refusée. Le problème, nouveau, est intimement lié au logiciel intermédiaire (middleware) yajsml, lequel est employé par Etherpad afin d’optimiser les requêtes des fichiers dits statiques (scripts, images, styles etc). En théorie, les requêtes prises en charge par MyPads ne devraient pas être impactées par ce logiciel intermédiaire, mais pour une raison mal comprise, elles le sont parfois.

Le problème, c’est que MyPads fonctionne autour d’une interface de programmation standard, une API HTTP REST, sur laquelle se connecte le client Web, et qui permettra à d’autres clients ou à des outils tiers de voir le jour. La résolution du soucis n’est pas aisée : l’anomalie intervient de manière aléatoire. Peu de plugins sont touchés car la plupart ne définissent pas leurs propres routes HTTP. Même si yajsml est modifié pour résoudre le soucis, il faudra que la fondation Etherpad accepte le patch et l’intègre avant de pouvoir retrouver une fonctionnement correct de MyPads. Or, il semble que yajsml sera bientôt remplacé par une technologie plus standard.

D’autres résolutions ont été envisagées, du fait de la situation de yajsml, et entre autres :

  1. Substituer, comme certains plugins le font,  l’API HTTP REST par une API basée sur socket.io, la technologie employée par Etherpad pour la collaboration en temps réel et qui repose en premier lieu sur le standard WebSocket. Cette voie a été expérimentée cette semaine mais représente une charge considérable de travail et la réécriture de nombreux modules. De plus, il ne s’agit pas d’un remplacement propre : MyPads y perd une méthode de communication plus standard ainsi que son système d’authentification, lequel avait été choisi pour permettre à terme une connexion depuis des comptes externes ou encore un annuaire LDAP, OpenID etc
  2. Faire de MyPads une application indépendante, de fait non plus un plugin, qui gèrerait les accès des utilisateurs aux pads en fonction des groupes définis. Le problème de cette solution est de complexifier l’installation de MyPads et de risquer des incompatibilités avec certains autres plugins. Aussi, nous sortirions de fait du cadre du cahier des charges initial.

Il a été décidé que la dernière piste ne serait à employer qu’en cas de dernier recours et c’est la migration vers socket.io qui a été d’abord privilégiée. Néanmoins, à la vue du travail nécessaire et surtout des pertes fonctionnelles que cela risque d’amener, cette solution ne sera pas poursuivie.

La semaine prochaine

Le travail va reprendre sur la version HTTP REST standard qui a été développée jusqu’ici. Il est prévu :

  • qu’étant donné que la suppression du yajsml n’arrivera qu’à un terme inconnu, il faudra dépister l’anomalie et la résoudre, ou au moins proposer un contournement simple ;
  • de poursuivre le développement, moins actif que prévu cette semaine, avec notamment
    • le passage d’une authentification en propre classique vers JSON Web Token, dont le travail a commencé cette semaine avec le test de socket.io, de manière à renforcer la sécurité des échanges de données chiffrées entre serveur et client ;
    • les groupes et pads, évidemment.

Rendez-vous jeudi prochain pour le point de la semaine 18.

MyPads week 17

As announced last week, we now give some news about MyPads development weekly. Last couple of days haven’t been picnic and few enhancements are visible. Explanations below.

img-mypads-ulule2

Work

Frontend functional testing setup, aiming to simulate real navigation, has filled the first days. Then MyPads has been updated to work with Express version 4. Express is the framework which powers Etherpad and so MyPads. This migration has been introduced by the very first MyPads external contributor, and was necessary because of the Etherpad migration a week earlier.

These modifications were a good moment to test MyPads’compatibility towards Eherpad. That can be surprising but MyPads has been programmed independently from Etherpad and is regularly tested as an Etherpad plugin, here’s why :

  • speeding up the development and avoiding Etherpad reboot or plugin re-installation at each update ;
  • allowing unit and functional server testing, quite hard from an Etherpad plugin, and isolate a test database from the whole node ;
  • retaining a distance regarding Etherpad core in order to avoid need of Etherpad updates and limit regressions in case of internal modifications of it.

Sadly MyPads behavior becomes erratic : sometimes correct, sometimes buggy. For technicians : only GET and HEAD HTTP verbs were allowed and all other method has been forbidden. This problem seems to be linked to the yajsml middleware, used by Etherpad in order to optimize static files requests (scripts, images, styles etc). In theory, MyPads handled routes should not be impacted by this middleware, but for an misunderstood reason, they sometimes are.

Problem is that MyPads is based on a standard home-defined HTTP REST API, which the Web client connects to. This interface may allow other clients and third party tools to be created more easily. Debugging the problem is not an easy task, due to the randomness of the behavior. Few plugins should be concerned because most of them don’t define their own routes. Even if yajsml is updated to fix the issue, the Etherpad developers will have to accept the patch and merge it before we have MyPads working correctly. Now it seems that yajsml will be soon replaced by a more standard technology.

Others resolutions have been considered, regarding to yajsml situation :

  1. Replace, as others plugins do, the HTTP REST API by a socket.io one. socket.io is the technology used by Etherpad for realtime collaboration, that use as a first class citizen the WebSocket protocol. This approach has been tried this week but requires a considerable amount of work and many modules rewriting. Moreover, it’s not a proper replacement : MyPads loses its more standard communication method but in addition its authentication system, which have been chosen to allow, later, connection through external accounts,  LDAP directory, OpenID etc
  2. Move MyPads from a plugin to a standalone application, which handle user access according to created groups and pads. Problem with this solution : harden the MyPads installation, risks of incompatibilities with some other plugins. Also, making a standalone app won’t conform to the initial specifications.

We have decided to follow the last proposition only as a last resort. The migration to socket.io has been preferred but, with the light of required work and moreover functional looses, it won’t continue.

Next week

Work will be resumed on the HTTP REST version, the one developed until now. We expect :

  • because yajsml removal won’t happen before an unknown time, it will be important to find and fix the bug, or at least to provide a simple workaround ;
  • move forward, with
    • migration from a classical authentication to JSON Web Token, which has been partially done this week as part of socket.io test, in order to harden encrypted data exchanges between client and server ;
    • groups and pads, obviously.

See you next Thursday for week 18 point.

6 Responses

  1. fred

    Après avoir récolté plus de 12000€, commençait déjà mal avec des retards avant même le début du travail. Maintenant ça ressemble de plus en plus à un gros fail. Le genre de produit qui vous sera livré sans garantie car il n’a jamais vraiment fonctionné.
    C’est un coup dur pour l’image de frama et pour le logiciel libre.

  2. idoric

    @Fred
    C’est parce que Trolldi tombait un jour férié que vous avez posté du samedi ?

    @Framasoft
    Je sais bien qu’au moment où j’écris vous en êtes au point 18, mais au point où j’en suis c’est ici que je vais l’écrire : merci pour les points hebdomadaires, ça change des nombreux projets ayant fait appel au crowdfunding, qui annoncent sans honte un retard d’un an ou plus quelques semaines (ou jours !) avant la deadline. Ici nous sommes loin d’une telle extrémité pourtant monnaie courante, et malgré tout vous faites preuve de la plus grande transparence. Les commentaires ne pleuvent pas en dessous de ces points d’avancé, mais ça ne veut pas dire qu’ils ne sont pas appréciés.

  3. Fred

    @idoric
    Trolldi c’est tous les jours, même trollmanche!
    Pour mieux faire comprendre mon commentaire, c’est surtout dû à la déception de voir ce projet s’enliser dans des problèmes à n’en plus finir. J’étais déjà sceptique au départ concernant le prestataire qui devait livrer: faire un devis pour fin 2014 et repousser à fin 2015, je trouve ça un peu beaucoup. Surtout lorsqu’on considère l’importance du contrat: 12000€ pour développer un plugin, c’est peut-être peu pour de grandes sociétés, mais pour Framasoft (et pour le prestataire aussi j’imagine) c’est un fameux contrat!
    Tout ça pour conclure qu’il faut parfois gueuler un bon coup et pousser les prestataires au cul histoire qu’ils comprennent que s’engager à livrer, ce n’est pas rien et qu’un plugin à 12000€ ne se réalise pas d’un coup de cuillère à pot.

    • Yakulu

      Sur le sujet financier : le plugin coûte 6500€ et non pas 12000€. Le reste de l’usage de la somme est décrit sur la page Ulule : http://fr.ulule.com/etherpad-framapad/ (maintenance, gestion de projet de Framasoft, part pour la plate-forme de financement etc). Donc non, je ne trouve pas que cela soit un contrat si fameux : la somme empochée in fine par le prestataire est à calculer sans la TVA, autres impôts, cotisations salariales/patronales réglées et frais liés à son activité.

      • fred

        Cher Yakulu,
        Qu’importe la somme récoltée. Lorsqu’on s’engage à livrer un produit ou un service, quel qu’il soit, aussi libre ou fermé qu’il soit, le client est en droit d’attendre un résultat dans un délai correct.
        J’en ai en fait, vraiment assez de voir des projets lancés se casser lamentablement la gueule parce que, comme c’est libre, tout est plus cool. Non! Le libre ne doit pas être aussi efficace que le privatif, il doit le dépasser. Sinon, ça ne sert à rien.

        • Yakulu

          Je réagissais simplement sur la somme. Concernant le délai, je suis d’accord avec vous : le retard est important et dommageable. Les nouvelles des dernières semaines montrent des avancées, ce qui me parait plus rassurant.