Versions et numéros de version

Mirox est livré en continu. Une version publiée est un état testé et numéroté de l'ensemble de la plateforme ; elle est déployée dans les deux régions sans interrompre vos sessions, et chaque version publiée est listée avec ses changements dans le journal des modifications.

Les trois lignes de versions

LigneCe qu'elle contient
PlateformeL'application web, l'API, les services qui les sous-tendent et la base de données
AgentsLes services qui collectent et analysent les données de vos centrales. Ils fonctionnent de manière décentralisée, sur des clusters d'agents dans des régions distinctes de celles de la plateforme elle-même, pour la redondance et la disponibilité.
Application mobileL'application iOS et Android

Les trois lignes sont publiées indépendamment. Une version de la plateforme n'exige jamais un nouvel agent ni une nouvelle application, et inversement ; lorsqu'un changement concerne deux lignes, le journal des modifications l'indique dans l'entrée.

Ce que signifie le numéro de version

La version de la plateforme est le seul numéro qui identifie ce que votre organisation utilise. C'est la version de la version publiée complète de la plateforme — pas d'un service individuel — et c'est le numéro qu'emploie le journal des modifications.

Les trois lignes suivent le même schéma de versionnement sémantique, MAJOR.MINOR.PATCH :

  • MAJOR marque une génération du produit.
  • MINOR augmente lorsqu'une version publiée apporte un changement au modèle de données, par exemple un nouveau type de composant ou de paramètre qui nécessite un nouveau stockage.
  • PATCH compte toutes les autres versions publiées : nouvelles fonctionnalités, corrections et améliorations qui laissent le modèle de données intact.

Toute augmentation, à n'importe quelle position, est une version publiée complète qui a passé les mêmes tests et a été déployée de la même manière.

Trouver la version que vous utilisez

  • Dans l'application web, le bas de la barre latérale gauche affiche, à côté de l'icône de build, la date et l'heure auxquelles l'application web que vous consultez a été construite. Elles identifient le build de l'application web elle-même.
  • Via l'API, tout utilisateur connecté et tout jeton API peuvent lire la version publiée :
GET /api/v1/system/version

{
  "version": "MAJOR.MINOR.PATCH",
  "build_timestamp": 1761206880,
  "region": "htz-fsn1"
}

version est la version de la plateforme, build_timestamp l'heure de build du service qui a répondu, en temps Unix, et region la région qui a répondu. Recherchez la version dans le journal des modifications pour voir quels changements elle contient.

Comment une mise à jour vous parvient

Plateforme. Une version publiée est déployée région par région sans interruption de service : la nouvelle version démarre à côté de l'ancienne, prend en charge le trafic et l'ancienne est retirée. Votre session reste connectée. Pendant le déploiement, l'application web remarque qu'un build plus récent existe et affiche un petit avis avec un bouton Actualiser ; si vous n'interagissez pas avec la page, elle se recharge d'elle-même après un court compte à rebours, et elle ne se recharge jamais pendant que vous saisissez du texte. Une version publiée ne nécessite normalement aucune fenêtre de maintenance ; une fenêtre n'est annoncée que lorsque des travaux l'exigent.

Agents. Les agents de vos centrales sont mis à jour par Mirox, indépendamment de la plateforme et région par région sur les clusters d'agents. Une mise à jour d'agent ne demande rien de votre part et n'interrompt pas la plateforme ; les données collectées pendant le bref redémarrage sont mises en tampon et livrées ensuite.

Application mobile. Les nouvelles versions de l'application arrivent par l'App Store et Google Play. Les mises à jour plus petites qui ne nécessitent pas de publication sur les stores sont appliquées par voie hertzienne (over the air) au prochain démarrage de l'application.

Journal des modifications et feuille de route

  • changelog.mirox.io liste chaque version publiée, groupée par jour, avec la version de chaque ligne à laquelle elle appartient. Les entrées sont écrites pour les personnes qui exploitent des centrales avec Mirox, pas pour les développeurs.
  • roadmap.mirox.io montre ce qui est planifié, ce qui est en cours et ce qui a été livré, et vous permet de voter pour des éléments.

Questions fréquentes

Dois-je faire quelque chose pour une mise à jour ? Non. Les mises à jour de la plateforme et des agents sont appliquées par Mirox. Pour l'application mobile, laissez les mises à jour automatiques activées dans votre store.

Pourquoi la barre latérale affiche-t-elle une date plutôt qu'une version ? La date identifie le build de l'application web dans votre navigateur, ce qui est ce qui compte lorsqu'une page se comporte de manière inattendue. La version de la plateforme est disponible via l'API comme décrit ci-dessus.

Les deux régions sont-elles toujours sur la même version ? Une version publiée est déployée dans les deux régions au cours du même déploiement. Pendant les quelques minutes que dure un déploiement, les régions peuvent brièvement différer ; le champ region du point d'accès de version vous indique quelle région a répondu.

Pages associées