En résumé
Chaque version publiée est étiquetée dans le dépôt, et c’est là que se trouve la liste exacte des changements. Cette page explique comment lire un numéro de version et ce qu’implique une mise à jour — le détail d’une version donnée vivant à sa source, où il ne peut pas devenir obsolète.
Où trouver les changements
Les versions sont publiées sur le dépôt de développement, FramaGit, où chaque version porte une étiquette. L’historique associé donne les modifications réellement apportées, à la date où elles l’ont été.
Les images à déployer sont publiées en parallèle, avec le même numéro : la liste des versions disponibles se consulte depuis le registre d’images.
Pourquoi cette page ne recopie pas la liste
Une liste de changements recopiée à la main dans une documentation diverge de la réalité dès la version suivante. Mieux vaut un renvoi fiable qu’un résumé périmé.
Lire un numéro de version
Linkr suit la convention habituelle en trois nombres — par exemple 2.4.1.
| Position | Ce que son changement annonce |
|---|---|
| Majeure | Une évolution de fond. La version 2 est une réécriture complète de Linkr, qui était auparavant une application R/Shiny. |
| Mineure | De nouvelles fonctionnalités, sans rupture. |
| Corrective | Des corrections. |
La version des images, et celle que répond le serveur
Le numéro qui fait foi est celui des images que vous déployez : c’est lui qui est inscrit dans vos archives et vos dépôts git, et c’est lui qui doit être identique sur les deux images d’une même installation.
Les deux images se mettent à jour ensemble
Une installation dont les deux images portent des versions différentes écrit des exports en désaccord avec eux-mêmes. Voir Installation en production.
Linkr expose par ailleurs une adresse de diagnostic, /api/v1/health, qui sert à vérifier que le serveur répond. Elle renvoie aussi un numéro de version — mais ce n’est pas celui des images, et il n’est pas tenu à jour à chaque publication.
Ne vous servez pas de cette adresse pour vérifier une mise à jour
Le numéro qu’elle renvoie est aujourd’hui 2.0.0-dev, quelle que soit la version déployée. Après une mise à jour, c’est donc l’étiquette des images de votre fichier de déploiement qu’il faut regarder, pas cette réponse.
Ce qu’implique une mise à jour
Les migrations s’appliquent seules
Aucune commande n’est à lancer : le schéma est mis à jour au démarrage, et ne fait rien s’il est déjà à jour.
Le retour arrière n’est pas symétrique
Ces migrations ne se rejouent pas à l’envers : revenir à l’image précédente ne suffit pas. La sauvegarde prise avant la mise à jour est le vrai retour arrière.
Vos exports restent lisibles
Une archive produite par une version antérieure se réimporte : les anciennes formes de fichiers sont tolérées à la lecture.
Signaler un problème, proposer une amélioration
Les anomalies et les demandes se déposent sur le dépôt. Un rapport utile contient la version déployée, le mode — navigateur ou serveur —, et ce que vous attendiez par rapport à ce qui s’est produit.
Pour aller plus loin
- Installation en production — la marche à suivre pour mettre à jour.
- Sauvegarde et restauration — à faire avant toute mise à jour.
- Glossaire — les termes employés dans la documentation.