Branches & Tags
Es gibt im GitHub-Repository diverse Branches. In diesem Artikel werden die verschiedenen Branches und deren Nutzung beschrieben.
Deprecated Branches
Vor 2025 gab es Branches „stable“, „next“ und „legacy“ um verschiedene Versionen von Gluon parallel pflegen zu können und gleichzeitig Upgrade Pfade zwischen den Versionen zu gewährleisten. Da dies jedoch zu vereinfacht ist für die immer komplexer werdenden Upgrade Pfade von Gluon, wurden diese Branches deprecated.
Davor gab es auch noch einen „experimental“ Branch, dieser wird aber seit 2021 nicht mehr genutzt.
Stable Gluon
Die Branches gluon-v20…
enthalten Firmware Versionen für die stabilen Versionen (bzw. Branches) von Gluon mit zusätzlichen Patches für FFMuc.
Beispielsweise gluon-v2021.1.x
enthält eine Version die auch noch 4/32 Geräte (<=4MB Flash oder <=32MB RAM) unterstützt.
⚠️ Alle Branches außer der neuesten Version bekommen generell keine Sicherheitsupdates und werden nicht mehr aktiv gepflegt! ⚠️
Ausnahmefälle für Updates in älteren Branches sind bspw. Migrationsskripte, um die diversen Upgrade Pfade auf die neueste Firmware Version gewährleisten zu können.
Stable Releases
Änderungen in diesem Branch werden nacheinander auf dem Autoupdater-Branch „experimental“, „testing“ und anschließend „stable“ veröffentlich.
Die Versionen folgen dem Schema
v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>
Das Jahr und der Monat des Release werden bei jedem Release inkrementiert, unabhängig von Größe der Änderung. Das Inkrement wird bei Änderungen erhöht die im gleichen Monat stattfinden.
Next Gluon
Ein spezieller Branch ist gluon-next
, welcher den bleeding-edge next
Branch von Gluon referenziert. Dieser Branch wird meist force-pushed (analog dem Next Branch von Gluon) und sollte nur in Ausnahmefällen benutzt werden.
Er wird genutzt um neue Entwicklungen in Gluon vor einem neuen (major) Gluon Release bei FFMuc testen zu können und erlaubt Entwicklern, bereits früh Änderungen bei der FFMuc Firmware anzustoßen, um kompatibel mit dem nächsten Gluon Release zu bleiben.
Oft werden auch infrastrukturelle Änderungen hier zuerst getestet bevor sie in die entsprechenden „stable“ Branches portiert werden.
Next Releases
Die Versionen folgen der aktuellen Versionsnummer von „stable“, haben jedoch den Postfix „next“, ggf. mit einem zusätzlichen Next-Inkrement:
v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>-next<ggf. Next-Inkrement>
Ein „next“-Release bekommt die Versionsnummer des „stable“-Release auf dem „next“ basiert mit einem -next
Postfix. Sollte es mehrere „next“ Releases geben, die auf dem gleichen „stable“-Stand basieren, dann wird nach dem Postfix ein Next-Inkrement (beginnend bei „2“) angehängt. Bei allen weiteren Next-Releases wird das Next-Inkrement um eins hochgezählt. Die Kopplung der Versionsnummer an das aktuelle „stable“-Release ist bewusst gewählt, unabhängig von der OpenWrt-Version oder den Umfang der Änderungen im Vergleich zum Stand des „stable“ Branches, da diese für unsere Benutzer meist eine untergeordnete Bedeutung haben.