Releases und Versionen

Mirox wird kontinuierlich ausgeliefert. Ein Release ist ein getesteter, versionierter Stand der gesamten Plattform; er wird in beide Regionen ausgerollt, ohne Ihre Sitzungen zu unterbrechen, und jedes Release ist mit seinen Änderungen im Changelog aufgeführt.

Die drei Release-Linien

Linie	Was sie enthält
Plattform	Die Web-App, die API, die Dienste dahinter und die Datenbank
Agenten	Die Dienste, die die Daten Ihrer Anlagen erfassen und analysieren. Sie laufen dezentral auf Agenten-Clustern in anderen Regionen als die Plattform selbst, für Redundanz und Verfügbarkeit.
Mobile-App	Die iOS- und Android-App

Die drei Linien werden unabhängig voneinander veröffentlicht. Ein Plattform-Release erfordert nie einen neuen Agenten oder eine neue App, und umgekehrt; wenn eine Änderung zwei Linien betrifft, steht das im Changelog-Eintrag.

Was die Versionsnummer bedeutet

Die Plattformversion ist die eine Nummer, die angibt, womit Ihre Organisation arbeitet. Es ist die Version des vollständigen Plattform-Releases — nicht eines einzelnen Dienstes — und sie ist die Nummer, die das Changelog verwendet.

Alle drei Linien folgen demselben Schema der semantischen Versionierung, MAJOR.MINOR.PATCH:

MAJOR kennzeichnet eine Generation des Produkts.
MINOR steigt, wenn ein Release eine Änderung am Datenmodell trägt, zum Beispiel eine neue Art von Komponente oder Einstellung, die neuen Speicher benötigt.
PATCH zählt jedes andere Release: neue Funktionen, Korrekturen und Verbesserungen, die das Datenmodell unberührt lassen.

Jede Erhöhung, an jeder Stelle, ist ein vollständiges Release, das dieselben Tests bestanden hat und auf dieselbe Weise ausgerollt wurde.

Die Version finden, mit der Sie arbeiten

In der Web-App zeigt das untere Ende der linken Seitenleiste neben dem Build-Symbol Datum und Uhrzeit, zu der die Web-App gebaut wurde, die Sie gerade sehen. Sie kennzeichnet den Build der Web-App selbst.
Über die API kann jeder angemeldete Benutzer und jeder API-Token das Release lesen:

GET /api/v1/system/version

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

version ist die Plattformversion, build_timestamp die Build-Zeit des antwortenden Dienstes als Unix-Zeit und region die Region, die geantwortet hat. Schlagen Sie die Version im Changelog nach, um zu sehen, welche Änderungen sie enthält.

Wie ein Update Sie erreicht

Plattform. Ein Release wird Region für Region ohne Ausfallzeit ausgerollt: Die neue Version startet neben der alten, übernimmt den Datenverkehr, und die alte wird außer Betrieb genommen. Ihre Sitzung bleibt angemeldet. Während der Rollout läuft, bemerkt die Web-App, dass ein neuerer Build existiert, und zeigt einen kleinen Hinweis mit einer Schaltfläche Aktualisieren; wenn Sie nicht mit der Seite interagieren, lädt sie sich nach einem kurzen Countdown von selbst neu, und sie lädt nie neu, während Sie tippen. Ein Release braucht normalerweise kein Wartungsfenster; eines wird nur angekündigt, wenn Arbeiten es erfordern.

Agenten. Die Agenten Ihrer Anlagen werden von Mirox aktualisiert, unabhängig von der Plattform und Region für Region auf den Agenten-Clustern. Ein Agenten-Update braucht nichts von Ihrer Seite und unterbricht die Plattform nicht; während des kurzen Neustarts erfasste Daten werden gepuffert und anschließend nachgeliefert.

Mobile-App. Neue App-Versionen kommen über den App Store und Google Play. Kleinere Updates, die kein Store-Release benötigen, werden beim nächsten Start der App over the air eingespielt.

Changelog und Roadmap

changelog.mirox.io listet jedes Release auf, nach Tag gruppiert, mit der Version der jeweiligen Linie, zu der es gehört. Die Einträge sind für die Menschen geschrieben, die mit Mirox Anlagen betreiben, nicht für Entwickler.
roadmap.mirox.io zeigt, was geplant ist, was in Arbeit ist und was ausgeliefert wurde, und lässt Sie über Einträge abstimmen.

Häufige Fragen

Muss ich für ein Update etwas tun? Nein. Plattform- und Agenten-Updates werden von Mirox eingespielt. Für die Mobile-App lassen Sie automatische Updates in Ihrem Store aktiviert.

Warum zeigt die Seitenleiste ein Datum statt einer Version? Das Datum kennzeichnet den Build der Web-App in Ihrem Browser, und genau der zählt, wenn sich eine Seite unerwartet verhält. Die Plattformversion ist wie oben beschrieben über die API verfügbar.

Sind beide Regionen immer auf derselben Version? Ein Release wird in demselben Deployment in beide Regionen ausgerollt. Für die wenigen Minuten, die ein Rollout dauert, können sich die Regionen kurz unterscheiden; das Feld region des Versions-Endpunkts sagt Ihnen, welche Region geantwortet hat.