Zum Inhalt

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 Beispiel v1.2.0. Vorabversionen sehen aus wie v1.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.txt mit 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.