Updates & Releases¶
Alle vier Projekte folgen derselben Release-Konvention. So kann NestrisLTM Updates für den ganzen Aufbau von einer Stelle aus finden, prüfen und installieren.
Release-Konvention¶
- Tags haben die Form
v<semver>, zum Beispielv1.2.0. Vorabversionen sehen aus wiev1.3.0-rc1. Der Tag muss zur Version in der Projektdatei passen, sonst lehnt der Release-Workflow ihn ab. - GitHub Actions baut jedes Release aus dem Quellcode. Kein Release wird auf einem Entwicklerrechner gebaut.
- Jedes Release enthält eine
SHA256SUMS.txtmit allen Dateien, signiert mit Ed25519 (SHA256SUMS.txt.sig). Die Apps akzeptieren ein Update nur, wenn die Signatur zu einem eingebauten öffentlichen Schlüssel passt.
flowchart LR
TAG["<span style='color:#ffffff'>git tag v1.2.0</span>"]:::ext --> CI["<span style='color:#ffffff'>GitHub Actions<br/>bauen + testen</span>"]:::ext
CI --> ART["<span style='color:#ffffff'>Dateien<br/>.exe · .zip · .deb · .bin</span>"]:::ext
ART --> SUM["<span style='color:#ffffff'>SHA256SUMS.txt</span>"]:::ext
SUM --> SIG["<span style='color:#ffffff'>Ed25519-Signatur<br/>SHA256SUMS.txt.sig</span>"]:::ext
SIG --> REL["<span style='color:#111111'>GitHub Release</span>"]:::ltm
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
Update-Manager von NestrisLTM¶
NestrisLTM prüft die GitHub-Releases eine Minute nach dem Start und danach alle 24 Stunden, oder wenn man auf Jetzt prüfen klickt. Kein Internet am Veranstaltungsort ist normal: Die Prüfung schlägt still fehl, und die Oberfläche zeigt, wann sie zuletzt geklappt hat.
Installieren braucht immer einen Klick. Nichts aktualisiert sich von selbst, und nie still mitten im Event.
sequenceDiagram
autonumber
participant L as NestrisLTM
participant G as GitHub Releases
actor A as Admin
participant DB as PostgreSQL
L->>G: Releases prüfen (Kanal stable / beta)
G-->>L: v1.2.0 verfügbar
L-->>A: Tray-Hinweis "Update verfügbar" + Admin-Seite
A->>L: Installieren
alt Spiele laufen oder eine Runde ist offen
L-->>A: "Turnier läuft – trotzdem aktualisieren?"
end
L->>G: Installer + SHA256SUMS.txt(.sig) laden
L->>L: Ed25519-Signatur prüfen, dann SHA-256
L->>DB: pg_dump-Backup → backups\ (die letzten 10 bleiben)
L->>L: Installer still ausführen (/update=1) und beenden
Note over L: Installer startet NestrisLTM in der neuen Version
| Einstellung | Bedeutung |
|---|---|
[updates] enabled |
Automatische Prüfung ein/aus |
[updates] channel |
stable (nur Releases) oder beta (auch Vorabversionen) |
[updates] owner / repo |
GitHub-Quelle, nützlich für Forks |
[updates] check_interval_h |
Prüfintervall, Standard 24 |
Zurückrollen. Andere Version … listet die letzten Releases. Ein Downgrade über eine Datenbank-Migration hinweg erfordert, das Backup von vor diesem Update wiederherzustellen. Die Admin-Seite erklärt das.
Fahrplan für die anderen Komponenten¶
| Komponente | Wie sie heute aktualisiert wird | Geplant |
|---|---|---|
| NestrisLTM | Ein-Klick-Update-Manager (oben) | — |
| nestris-terminal | Neuen Installer ausführen (ohne Administratorrechte) | Geplant Update-Reiter im versteckten Admin-Menü |
| nestris-station | sudo apt install ./nestris-station_<v>-1_<arch>.deb |
Geplant „Station aktualisieren“ auf der Stationsseite von NestrisLTM |
| RFID-Leser | Mit esptool oder PlatformIO flashen |
Geplant Flashen über das Terminal oder die Station, an der er hängt |
Download von Hand prüfen¶
Siehe Downloads → Downloads prüfen.