iA·AES passe à Odoo 18 : une migration en trois mouvements
Les 67 communes qui gèrent leur accueil extrascolaire avec iA·AES travaillent désormais sur Odoo 18, hébergé sur une infrastructure entièrement renouvelée. Derrière ce changement de version, trois chantiers menés de front : le code, les données et l’hébergement. Et un objectif tenu : ne rien perdre en route.
Pourquoi migrer ?
iA·AES repose sur Odoo, un progiciel de gestion (ERP) open source. Odoo ne maintient que ses trois dernières versions : depuis la sortie d’Odoo 18, la version 15 n’est plus suivie. Rester dessus, c’était accepter de ne plus recevoir de correctifs de sécurité et de voir l’écart se creuser avec l’écosystème de modules libres dont nous dépendons.
Migrer était donc nécessaire. Nous en avons fait une occasion : tant qu’à toucher chaque instance, autant moderniser aussi la manière dont elles sont hébergées, déployées et sauvegardées.
Premier mouvement : le code
Lors du passage de la version 9 à la version 15, l’application avait été largement réécrite. Cette fois, nous avons fait le choix inverse : adapter les 21 modules éprouvés qui composent iA·AES plutôt que les réécrire. Les fonctionnalités que les équipes communales connaissent restent les mêmes ; c’est leur fondation qui change.
Adapter plutôt que réécrire, ce n’est pas pour autant une promenade de santé. L’équipe de développement d’iA·AES a fait passer le code directement d’Odoo 15 à Odoo 18, sans s’arrêter aux versions intermédiaires. Or, en trois versions majeures, Odoo a profondément changé ses règles. Son interface web a été réécrite, la façon de décrire les écrans et leurs conditions d’affichage a changé deux fois, et des fonctions entières sur lesquelles reposait le code ont disparu. Il a fallu remettre les 21 modules en conformité avec ces nouvelles règles, sans rien changer à ce qui fonctionnait déjà !
Cette adaptation s’appuie aussi sur le travail de l’Odoo Community Association (OCA), qui rassemble développeurs et intégrateurs Odoo autour de modules libres partagés. Plutôt que de tout développer nous-mêmes, nous réutilisons ses briques, qui ont fait leurs preuves : le stockage des fichiers, les sessions de connexion, la configuration ou encore la gestion des prénoms et noms des contacts.
Pour les curieux — Mutualiser ne s’arrête pas aux communes. En s’appuyant sur des modules maintenus par toute une communauté, iMio partage aussi l’effort de maintenance avec d’autres utilisateurs d’Odoo, partout dans le monde. C’est l’esprit du logiciel libre.
Deuxième mouvement : les données
Adapter le code ne suffit pas : chaque commune possède sa propre base de données, avec des années d’inscriptions, de présences, de factures et de documents. C’est elle qu’il fallait faire passer d’Odoo 15 à Odoo 18, sans en perdre une ligne.
Premier obstacle : contrairement au code, une base de données ne peut pas sauter directement de la version 15 à la version 18. Elle se migre une version majeure à la fois — 15 vers 16, puis 16 vers 17, puis 17 vers 18. Second obstacle : la version communautaire d’Odoo ne fournit pas d’outil officiel pour ces étapes de migration.
C’est là qu’intervient OpenUpgrade, le projet de l’OCA qui maintient, version après version, les scripts de migration des modules standards d’Odoo. Sans lui, il aurait fallu écrire nous-mêmes la transformation de chaque table du socle Odoo, à chaque étape. Avec lui, nous avons pu concentrer nos efforts sur ce qui est propre à iA·AES.
La base franchit les versions une à une ; les fichiers ne partent vers S3 qu’une fois la base arrivée en version 18 et vérifiée.
Pour les curieux — Chaque étape tourne dans un environnement figé, construit une fois pour toutes, pour que deux essais donnent exactement le même résultat. En versions 16 et 17, iA·AES n’existe que sous forme de coquilles vides : des modules réduits à leur squelette, juste de quoi faire franchir le palier aux données, puisque personne n’a écrit iA·AES pour ces versions. La dernière étape se fait en deux passes : d’abord avec OpenUpgrade, puis sans lui, avec exactement le code d’iA·AES qui tourne en production. Si la base se charge dans ces conditions, c’est la preuve qu’elle est réellement utilisable, et pas seulement par un Odoo assisté d’outils de migration.
Notre principe : compter avant, recompter après. Avant de commencer, le processus de migration relève tout ce qui peut l’être — nombre d’enregistrements, règles métier, modules installés, pièces jointes. Il recompte après chaque étape. Au moindre écart qui n’a pas été expliqué à l’avance, il s’arrête plutôt que de continuer « au cas où ».
Mais compter ne dit pas tout. À chaque étape, Odoo écrit aussi un journal de plusieurs milliers de lignes, qui contient de nombreux avertissements. La plupart sont sans conséquence ; encore faut-il en être certain. Personne ne relit ce journal à la main : le processus de migration contrôle chaque avertissement automatiquement. Chacun doit correspondre à une règle que nous avons écrite à l’avance, et qui renvoie au ticket où ce cas a été analysé et jugé sans risque. Un avertissement qui ne correspond à aucune règle bloque la migration : quelqu’un doit alors comprendre d’où il vient, puis écrire la règle qui manquait ou corriger le processus. La migration d’une commune n’est validée qu’avec zéro erreur bloquante et zéro avertissement inexpliqué.
Avant la migration, nous l’avons répétée, en interne, sur les données des 67 communes : d’abord sur des copies anonymisées, puis sur des copies réelles dans un environnement totalement isolé. Aucun e-mail ne pouvait en sortir, et chaque copie était détruite à la fin de l’essai. Résultat : 67 communes migrées sans erreur !
La base de données elle-même migre en deux à quatre minutes par commune. Un constat surprenant : ce n’est pas la quantité de données qui fait la durée, mais le nombre de modules installés. Une base quatre fois plus grosse peut migrer deux fois plus vite qu’une autre.
Troisième mouvement : l’infrastructure
Avant cette migration, les instances iA·AES étaient réparties sur plusieurs machines virtuelles. Toutes fonctionnent désormais sur une plateforme moderne, partagée avec d’autres applications iMio.
Ce changement apporte plusieurs garanties :
- une meilleure résistance aux pannes : si un serveur tombe, l’application redémarre d’elle-même sur un autre, sans intervention ; la base de données est copiée en continu sur une réplique, prête à prendre le relais ;
- des fichiers à l’abri : documents, attestations et factures ne dépendent plus d’un serveur en particulier, et chaque commune dispose de son propre espace, isolé des autres ;
- des mises à jour plus sûres : chaque nouvelle version est testée automatiquement avant d’atteindre les communes, et peut être annulée aussi simplement qu’elle a été installée ;
- une configuration maîtrisée : chaque réglage est écrit, tracé et réversible, et la plateforme corrige d’elle-même tout écart.
Pour les curieux — Les instances tournent sur Kubernetes, une plateforme qui orchestre les applications sous forme de conteneurs. Leur configuration est décrite dans un dépôt Git, que la plateforme applique en continu. Chaque évolution du code produit une image vérifiée automatiquement, puis déployée dans un environnement de test dédié ; déployer une nouvelle version revient à changer un numéro de version dans un fichier. La base de données tourne sur un cluster PostgreSQL répliqué, avec une instance principale et une réplique. Les pièces jointes ont quitté le disque local des serveurs pour un stockage objet S3, avec un espace distinct par commune : l’application ne garde plus rien sur son propre disque et peut être redémarrée, déplacée ou dupliquée sans risque pour les fichiers.
Le transfert des pièces jointes vers leur nouvel espace de stockage a été, de loin, la partie la plus longue de la migration. Là où la base de données se migre en quelques minutes, déplacer et vérifier un par un les fichiers d’une commune, parfois plusieurs gigaoctets, demande bien davantage. C’est ce transfert qui a dicté le calendrier des migrations.
Les nuits de migration
La migration s’est faite de nuit, serveur par serveur et commune par commune. Avant de toucher à quoi que ce soit, le processus a pris pour chaque commune une sauvegarde vérifiée, qui permettait de revenir à l’état antérieur. Une commune qui rencontrait un problème n’empêchait pas les suivantes de migrer.
Le lendemain matin, chaque instance a d’abord été ouverte en interne pour être contrôlée, puis rendue aux communes. Les équipes ont retrouvé iA·AES à l’adresse habituelle. Les e-mails en attente au moment de la coupure sont repartis normalement, et aucun n’a été envoyé par erreur pendant la migration.
Ce que ça change
Pour les communes et leurs agent·es :
- une application sur une version d’Odoo maintenue, avec ses correctifs de sécurité ;
- l’interface et les performances d’Odoo 18 ;
- des évolutions livrées plus rapidement, parce que mieux testées en amont.
Pour iMio :
- un parc homogène, déployé et surveillé de la même manière pour toutes les communes ;
- une infrastructure commune avec d’autres applications iMio déjà hébergées sur Kubernetes ;
- une base saine pour les prochaines versions d’Odoo, avec une méthode de migration désormais rodée.
Merci
Cette migration est le fruit d’un travail d’équipe chez iMio : l’équipe iA·AES, Thomas du pôle Développement et Alexandre du pôle DevOps, auteur de ces lignes. Merci aussi à la communauté OCA, sans qui OpenUpgrade n’existerait pas. Nous avons pris le temps de bien faire : c’est le meilleur service à rendre aux équipes qui utilisent iA·AES chaque jour.