Leitlinie neue Firmware

Aus Freifunk Flensburg
Wechseln zu: Navigation, Suche

Leitlinie zur Erstellung einer neuen Firmwareversion[Bearbeiten]

Hintergrund[Bearbeiten]

Da jedes Autoupdate das Risiko birgt das man im worst case alle seine Knoten per Hand seriell retten muss ist ein Ablauf hilfreich der diese Gefahr minimiert.

Ablauf[Bearbeiten]

  1. neue Gluon Version kommt heraus
  2. Firmwareteam-Treffen wird einberufen:
    1. Abwägung der Bugfixes/neue Funktionen gegen das brick Risiko
  3. Wenn Update beschlossen wurde
    1. gitbranch erstellen nach muster 20xx.xx.xx-x
    2. notwendige Änderungen an den FFFL Dateien(site.conf/site.mk etc) durchführen
    3. changelog in git anpassen
    4. beta bauen
    5. beta Kurztest vom Firmwareteam
      1. funktioniert das flashen
      2. connectet/mesht der router?
    6. wenn ok beta manifest erstellen und signieren
    7. shasum der dateien erstellen "shasum -a 512 * > shasum512"
    8. beta / manifest / shasum512 in Updateordner kopieren
    9. autoupdate testen
    10. Twitter "beta für neue Version XXX steht bereit bitte testen --wiki link ANLEITUNG wie firmware branch wechseln im config mode--"
    11. 2-4 Wochen auf feedback warten
    12. wenn bugs gefunden wurden für Gluon
      1. bug report nach neoraider git gluon
      2. wenn gefixed dann zurück nach punkt gitbranch erstellen +1 version...
    13. wenn bugs gefunden für FFFL spezifische dateien
      1. bugs fixen und zurueck nach punkt gitbranch erstellen +1 version...
    14. wenn keine bugs in 2-4 wochen testphase gefunden wurde:
      1. site dateien auf stable ändern
      2. Firmware bauen
      3. stable kurztest
        1. funktioniert das flashen
        2. connectet/mesht der router?
      4. wenn ok stable manifest erstellen und signieren
      5. shasum der dateien erstellen "shasum -a 512 * > shasum512"
      6. stable / manifest / shasum512 in update Ordner kopieren
      7. autoaupdate testen
      8. twitter neue Version announcen "ab heute wird neue Firmwareversion x über Autoupdate ausgerollt-->link ins git changelog
      9. supportet Router im Wiki aktualisieren

changelog Aufbau[Bearbeiten]

  1. basiert auf $gluonversion mit $gluon_gitcommit und $fffl_gitcommit
  2. Gluon spezifische Änderungen
    1. beinhaltet welche gluon versionen
    2. Link nach gluon readthedocs $versionen
  3. FFFL spezifische Änderungen
    1. hinzugeführte/gelöschte Signaturen
    2. Protokoländerungen wie zb batman15 statt batman14