Rilasci e versioni

Mirox viene distribuito in modo continuo. Un rilascio è uno stato testato e versionato dell'intera piattaforma; viene distribuito in entrambe le regioni senza interrompere le tue sessioni, e ogni rilascio è elencato con le sue modifiche nel changelog.

Le tre linee di rilascio

LineaCosa contiene
PiattaformaL'app web, l'API, i servizi che le sostengono e il database
AgentiI servizi che raccolgono e analizzano i dati dei tuoi impianti. Funzionano in modo decentralizzato, su cluster di agenti in regioni diverse da quelle della piattaforma stessa, per ridondanza e disponibilità.
App mobileL'app per iOS e Android

Le tre linee vengono rilasciate in modo indipendente. Un rilascio della piattaforma non richiede mai un nuovo agente o una nuova app, e viceversa; quando una modifica riguarda due linee, il changelog lo indica nella voce.

Cosa significa il numero di versione

La versione della piattaforma è l'unico numero che identifica ciò che la tua organizzazione sta utilizzando. È la versione del rilascio completo della piattaforma — non di un singolo servizio — ed è il numero usato dal changelog.

Tutte e tre le linee seguono lo stesso schema di versionamento semantico, MAJOR.MINOR.PATCH:

  • MAJOR segna una generazione del prodotto.
  • MINOR aumenta quando un rilascio comporta una modifica al modello dei dati, per esempio un nuovo tipo di componente o di impostazione che richiede un nuovo spazio di memorizzazione.
  • PATCH conta ogni altro rilascio: nuove funzionalità, correzioni e miglioramenti che lasciano invariato il modello dei dati.

Qualsiasi incremento, in qualsiasi posizione, è un rilascio completo che ha superato gli stessi test ed è stato distribuito nello stesso modo.

Trovare la versione in uso

  • Nell'app web la parte inferiore della barra laterale sinistra mostra, accanto all'icona della build, la data e l'ora in cui è stata compilata l'app web che stai guardando. Identifica la build dell'app web stessa.
  • Tramite l'API, qualsiasi utente connesso e qualsiasi token API può leggere il rilascio:
GET /api/v1/system/version

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

version è la versione della piattaforma, build_timestamp l'ora di compilazione del servizio che ha risposto come tempo Unix, e region la regione che ha risposto. Cerca la versione nel changelog per vedere quali modifiche contiene.

Come ti raggiunge un aggiornamento

Piattaforma. Un rilascio viene distribuito regione per regione senza tempi di inattività: la nuova versione si avvia accanto alla vecchia, ne prende in carico il traffico e la vecchia viene ritirata. La tua sessione resta connessa. Mentre la distribuzione è in corso, l'app web rileva che esiste una build più recente e mostra un piccolo avviso con un pulsante Aggiorna; se non stai interagendo con la pagina, questa si ricarica da sola dopo un breve conto alla rovescia, e non si ricarica mai mentre stai scrivendo. Un rilascio di norma non richiede alcuna finestra di manutenzione; ne viene annunciata una solo quando i lavori lo richiedono.

Agenti. Gli agenti dei tuoi impianti vengono aggiornati da Mirox, indipendentemente dalla piattaforma e regione per regione sui cluster di agenti. Un aggiornamento dell'agente non richiede nulla da parte tua e non interrompe la piattaforma; i dati raccolti durante il breve riavvio vengono conservati in un buffer e consegnati in seguito.

App mobile. Le nuove versioni dell'app arrivano tramite l'App Store e Google Play. Gli aggiornamenti minori che non richiedono un rilascio nello store vengono applicati over the air al successivo avvio dell'app.

Changelog e roadmap

  • changelog.mirox.io elenca ogni rilascio, raggruppato per giorno, con la versione della linea a cui appartiene. Le voci sono scritte per le persone che gestiscono impianti con Mirox, non per gli sviluppatori.
  • roadmap.mirox.io mostra cosa è pianificato, cosa è in corso e cosa è stato rilasciato, e ti permette di votare le voci.

Domande frequenti

Devo fare qualcosa per un aggiornamento? No. Gli aggiornamenti della piattaforma e degli agenti vengono applicati da Mirox. Per l'app mobile, mantieni attivi gli aggiornamenti automatici nel tuo store.

Perché la barra laterale mostra una data anziché una versione? La data identifica la build dell'app web nel tuo browser, che è ciò che conta quando una pagina si comporta in modo inatteso. La versione della piattaforma è disponibile tramite l'API come descritto sopra.

Entrambe le regioni sono sempre sulla stessa versione? Un rilascio viene distribuito in entrambe le regioni nello stesso deployment. Per i pochi minuti che una distribuzione richiede, le regioni possono differire brevemente; il campo region dell'endpoint della versione ti dice quale regione ha risposto.

Pagine correlate