Releases y versiones

Mirox se entrega de forma continua. Una release es un estado probado y versionado de toda la plataforma; se despliega en ambas regiones sin interrumpir tus sesiones, y cada release aparece con sus cambios en el changelog.

Las tres líneas de release

LíneaQué contiene
PlataformaLa aplicación web, la API, los servicios que hay detrás y la base de datos
AgentesLos servicios que recopilan y analizan los datos de tus plantas. Funcionan de forma descentralizada, en clústeres de agentes en regiones distintas de las de la propia plataforma, por redundancia y disponibilidad.
Aplicación móvilLa aplicación para iOS y Android

Las tres líneas se publican de forma independiente. Una release de la plataforma nunca requiere un nuevo agente ni una nueva aplicación, y viceversa; cuando un cambio abarca dos líneas, el changelog lo indica en la entrada.

Qué significa el número de versión

La versión de la plataforma es el único número que identifica lo que ejecuta tu organización. Es la versión de la release completa de la plataforma — no de un servicio individual — y es el número que utiliza el changelog.

Las tres líneas siguen el mismo esquema de versionado semántico, MAJOR.MINOR.PATCH:

  • MAJOR marca una generación del producto.
  • MINOR aumenta cuando una release lleva un cambio en el modelo de datos, por ejemplo un nuevo tipo de componente o de ajuste que necesita almacenamiento nuevo.
  • PATCH cuenta todas las demás releases: nuevas funciones, correcciones y mejoras que dejan intacto el modelo de datos.

Cualquier incremento, en cualquier posición, es una release completa que superó las mismas pruebas y se desplegó de la misma manera.

Averiguar la versión que ejecutas

  • En la aplicación web, la parte inferior de la barra lateral izquierda muestra, junto al icono de compilación, la fecha y la hora en que se compiló la aplicación web que estás viendo. Identifica la compilación de la propia aplicación web.
  • A través de la API, cualquier usuario con sesión iniciada y cualquier token de API puede leer la release:
GET /api/v1/system/version

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

version es la versión de la plataforma, build_timestamp la hora de compilación del servicio que responde en tiempo Unix, y region la región que respondió. Busca la versión en el changelog para ver qué cambios contiene.

Cómo te llega una actualización

Plataforma. Una release se despliega región por región sin tiempo de inactividad: la nueva versión arranca junto a la antigua, asume el tráfico y la antigua se retira. Tu sesión sigue iniciada. Mientras se ejecuta el despliegue, la aplicación web detecta que existe una compilación más reciente y muestra un pequeño aviso con un botón Actualizar; si no estás interactuando con la página, se recarga sola tras una breve cuenta atrás, y nunca se recarga mientras escribes. Una release normalmente no necesita ventana de mantenimiento; solo se anuncia una cuando los trabajos lo requieren.

Agentes. Los agentes de tus plantas los actualiza Mirox, con independencia de la plataforma y región por región en los clústeres de agentes. Una actualización de agente no necesita nada por tu parte y no interrumpe la plataforma; los datos recopilados durante el breve reinicio se guardan en un búfer y se entregan después.

Aplicación móvil. Las nuevas versiones de la aplicación llegan a través de la App Store y de Google Play. Las actualizaciones menores que no necesitan una publicación en la tienda se aplican por el aire la próxima vez que se inicia la aplicación.

Changelog y roadmap

  • changelog.mirox.io enumera cada release, agrupada por día, con la versión de cada línea a la que pertenece. Las entradas están escritas para las personas que operan plantas con Mirox, no para desarrolladores.
  • roadmap.mirox.io muestra lo que está planificado, lo que está en curso y lo que ya se ha publicado, y te permite votar los elementos.

Preguntas frecuentes

¿Tengo que hacer algo para una actualización? No. Las actualizaciones de la plataforma y de los agentes las aplica Mirox. Para la aplicación móvil, mantén activadas las actualizaciones automáticas en tu tienda.

¿Por qué la barra lateral muestra una fecha en lugar de una versión? La fecha identifica la compilación de la aplicación web en tu navegador, que es lo que importa cuando una página se comporta de forma inesperada. La versión de la plataforma está disponible a través de la API como se describe arriba.

¿Están ambas regiones siempre en la misma versión? Una release se despliega en ambas regiones en el mismo despliegue. Durante los pocos minutos que dura un despliegue, las regiones pueden diferir brevemente; el campo region del endpoint de versión te indica qué región respondió.

Páginas relacionadas