Zeile 4: |
Zeile 4: |
| | | |
| == Release taggen == | | == Release taggen == |
− | Jedes Release wird mit einem PGP-signierten Tag (-s) versehen. Dabei enthält die Tag-Message jeweils eine kurze Zusammenfassung der Änderungen. Beachte bei der Erstellung des Tags bitte unsere [[Versionierung | Dokumentation zur Versionierung]]. '''Wichtig''' Hier erst weiter machen wenn ein release tag gemäß der Versionierung Seite vorhanden ist. | + | Jedes Release wird mit einem PGP-signierten Tag (-s) versehen. Dabei enthält die Tag-Message jeweils eine kurze Zusammenfassung der Änderungen. Beachte bei der Erstellung des Tags bitte unsere [[Firmware/Versionierung | Dokumentation zur Versionierung]]. '''Wichtig''' Hier erst weiter machen wenn ein release tag gemäß der Versionierung Seite vorhanden ist. |
| | | |
| Vorlage für die Tag-Message: | | Vorlage für die Tag-Message: |
− |
| |
| <pre> | | <pre> |
− | Release firmware version VERSION. | + | Release firmware version <VERSION>. |
| | | |
| Changes: | | Changes: |
Zeile 16: |
Zeile 15: |
| | | |
| Befehle zum taggen: | | Befehle zum taggen: |
− |
| |
| <pre> | | <pre> |
| git tag -s VERSION #tag anlegen | | git tag -s VERSION #tag anlegen |
Zeile 22: |
Zeile 20: |
| git push origin --tags #tag hochladen | | git push origin --tags #tag hochladen |
| </pre> | | </pre> |
| + | |
| Git message editor ändern: | | Git message editor ändern: |
− |
| |
| <pre> | | <pre> |
| git config --global core.editor "vim" | | git config --global core.editor "vim" |
Zeile 34: |
Zeile 32: |
| | | |
| == Firmware signieren == | | == Firmware signieren == |
− | Wir haben uns dafür entschieden das >50% der erlaubten Signaturen signen müssen, bevor der autoupdater das upgrade annehmen darf.
| + | Es gab am 29.01.2017 den Vorschlag von Eike, den Wert good_signatures nicht wie bisher auf >50% aller Signaturen zu setzen, sondern hier einen konstanten Wert (5) zu setzen. Dieser Vorschlag wurde in der Diskussion um den sign-request für das Release 20171126 von Tarek wieder aufgegriffen, allerdings mit good_signatures=4 (siehe Dev-ML vom 09.12.2017). Es wurde mit der Mehrheit für diese Änderung gestimmt. Somit Ist nun ein konstanter Signatur wert von 4 gesetzt. |
− | | |
− | Siehe dazu auch die Diskussion auf der Dev-Liste "good_signature level" vom 15.05.2015 23:12.
| |
| | | |
| === Hinweis zur Erstsignatur === | | === Hinweis zur Erstsignatur === |
Zeile 57: |
Zeile 53: |
| Dann laden wir das Manifest herunter, welches wir signieren möchten: | | Dann laden wir das Manifest herunter, welches wir signieren möchten: |
| <pre> | | <pre> |
− | scp firmware.ffnw.de:/var/www/dev/firmware/VERSION/stable.manifest stable.manifest | + | scp firmware.ffnw.de:/var/www/dev/firmware/<l2tp/fastd>/<VERSION>/sysupgrade/stable.manifest stable.manifest |
| </pre> | | </pre> |
| | | |
Zeile 69: |
Zeile 65: |
| <pre> | | <pre> |
| scp stable.manifest firmware.ffnw.de:~ | | scp stable.manifest firmware.ffnw.de:~ |
− | ssh NICKNAME@firmware.ffnw.de | + | ssh firmware.ffnw.de |
| sudo -s | | sudo -s |
− | mv stable.manifest /var/www/dev/firmware/VERSION/stable.manifest | + | mv stable.manifest /var/www/dev/firmware/<l2tp/fastd>/<VERSION>/sysupgrade/stable.manifest |
| </pre> | | </pre> |
| + | |
| + | Einen Versuch, das oben stehende so weit wie möglich zu automatisieren und somit den Signaturprozess und unkompliziert wie möglich zu machen stellt dieses [https://git.ffnw.de/lrnzo/firmware-signing-made-easy/raw/master/firmware-signieren.sh shell-script] dar |
| | | |
| == Sign-Request auf Dev-Mailingliste veröffentlichen == | | == Sign-Request auf Dev-Mailingliste veröffentlichen == |
Zeile 78: |
Zeile 76: |
| * Version der Firmware | | * Version der Firmware |
| * Versionsnummer der Gluon-Basis | | * Versionsnummer der Gluon-Basis |
| + | * Commit ID der Gluon-Basis |
| * Einen Link auf den Download der Firmware | | * Einen Link auf den Download der Firmware |
| * Kurzbeschreibung der Änderungen | | * Kurzbeschreibung der Änderungen |
Zeile 89: |
Zeile 88: |
| Ich habe heute eine neue Firmware gebaut. Basisdaten: | | Ich habe heute eine neue Firmware gebaut. Basisdaten: |
| * Firmware-Version: | | * Firmware-Version: |
− | * Gluon-Version: | + | * Gluon-Version: |
| + | * Commit ID: |
| * Download: | | * Download: |
| | | |
− | Folgende Änderungen gab es: | + | Folgende Gluon spezifischen Änderungen gab es unter anderen: |
| + | |
| + | * HIER PUNKTE [0] |
| + | * HIER PUNKTE |
| + | |
| + | Die upstream Änderungen findet ihr hier: |
| + | |
| + | https://github.com/freifunk-gluon/gluon/compare/<alte commit ID>...<neu commit ID> |
| + | |
| + | Folgende Comunnity spezifischen Änderungen gab es im package repo: |
| + | |
| + | * HIER PUNKTE |
| + | * HIER PUNKTE [1] |
| + | |
| + | Die Änderungen an unseren eigenen Paketen können im Packages-Repository hier eingesehen werden: |
| + | |
| + | https://git.nordwest.freifunk.net/ffnw-firmware/packages/compare/<alte Version>...<neue Version> |
| + | |
| + | Folgende Comunnity spezifischen Änderungen gab es im siteconf repo: |
| + | |
| * HIER PUNKTE | | * HIER PUNKTE |
| * HIER PUNKTE | | * HIER PUNKTE |
| | | |
− | Die Änderungen an der Siteconf können im Siteconf-Repo mittels folgendem Befehl eingesehen werden: | + | Die Änderungen an der Siteconf können im Siteconf-Repo hier eingesehen werden: |
− | git diff vVERSIONALT vVERSIONNEU | + | |
| + | https://git.nordwest.freifunk.net/ffnw-firmware/siteconf/compare/<alte Version>...<neue Version> |
| | | |
− | Die Änderungen an unseren eigenen Paketen können im Packages-Repository mittels folgendem Befehl eingesehen werden: | + | Ich bitte euch die Änderungen zu prüfen und die Firmware im Anschluss zu |
− | git diff vVERSIONALT vVERSIONNEU
| + | signieren. Die Dokumentation zum Signaturprozess findet ihr im Wiki unter: |
| + | https://wiki.nordwest.freifunk.net/Firmware/Releaseprozess#Firmware_signieren |
| | | |
− | Ich bitte euch die Änderungen zu prüfen und die Firmware im Anschluss zu signieren. Die Dokumentation zum Signaturprozess findet ihr im Wiki unter:
| + | Ein Script zum vereinfachten signieren findet ihr hier: |
− | https://wiki.nordwest.freifunk.net/Entwicklung/Firmware_releaseprozess#Firmware_signieren | + | https://git.ffnw.de/lrnzo/firmware-signing-made-easy |
| | | |
| Viele Grüße | | Viele Grüße |
| + | |
| + | [0] |
| + | [1] |
| </pre> | | </pre> |
| | | |
Zeile 118: |
Zeile 142: |
| ** https://wiki.nordwest.freifunk.net/Router/Firmware | | ** https://wiki.nordwest.freifunk.net/Router/Firmware |
| * Einen Link auf die Dokumentation zur Gluon-Firmware | | * Einen Link auf die Dokumentation zur Gluon-Firmware |
− | ** https://gluon.readthedocs.org/en/v2015.1.2/ | + | ** https://gluon.readthedocs.org/en/stable/ |
| * Einen Link auf die Seite der Unterstützten Geräte in der Gluon Dokumentation | | * Einen Link auf die Seite der Unterstützten Geräte in der Gluon Dokumentation |
− | ** https://gluon.readthedocs.org/en/v2015.1.2/ | + | ** http://gluon.readthedocs.io/en/stable/#supported-devices-architectures |
| | | |
| == Symlink umbiegen == | | == Symlink umbiegen == |
Zeile 128: |
Zeile 152: |
| unlink stable | | unlink stable |
| ln -s VERSION stable | | ln -s VERSION stable |
− | cd stable
| |
− | ln -s stable.manifest manifest
| |
| </pre> | | </pre> |
| + | Das symlinken des manifest ist nicht mehr nötig, da der Firmware-bot dies tut. |
| | | |
| == Allgemeines zu Signaturen == | | == Allgemeines zu Signaturen == |