Mises à jour¶
Installer une nouvelle version¶
Une nouvelle version est livrée sous forme d'images. Remplacer les images, puis relancer :
docker compose -f docker-compose.prod.yml --env-file .env.prod up -d
Les tables et index nécessaires à la nouvelle version sont créés au démarrage. Le redémarrage interrompt une indexation en cours : choisir un moment sans import.
GET /health donne la version et le commit du moteur qui tourne.
Réindexer seulement ce qui en profite¶
Une mise à jour ne réindexe rien : chaque document garde ce qui a été calculé lors de son indexation. Le moteur renvoie à l'indexation la version qui l'a traité (engine_version), que l'application conserve. Après une mise à jour, réindexer seulement les documents concernés :
| Indexé avant | Documents | Gain |
|---|---|---|
| 3.12 | Numéros de page des extraits | |
| 3.15 | CSV au séparateur ; ou tabulation, CSV non UTF-8, tableurs dont une cellule contient une barre verticale |
Colonnes et accents corrects |
| 3.20 | Word (.docx) |
Tableaux, en-têtes et pieds de page |
| 3.23 | Tous | Date du document ; sans date, un document est exclu des questions limitées à une période |
Réindexer un document remplace ses extraits sans doublon. La date d'un document peut aussi être corrigée sans réindexation.
Compatibilité de l'API¶
Les versions du moteur suivent une règle stricte vis-à-vis des appelants : une version mineure n'ajoute que des champs ou des routes facultatifs, jamais un retrait ni un changement de sens. Un changement incompatible passe par une version majeure, annoncée à l'avance ; le premier sera le passage à l'API v1.