Teams/Keys-Team/Eintragen eines neuen Knotens via Web-Interface: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Zeile 1: | Zeile 1: | ||
Hier erfährst du, wie du einen Freifunk-Knoten-Key via Web-Interface ins Repository einträgst. Wie du einen Key mittels Git-Client in das Key-Repository einträgst, erfährst du [[Teams/Keys-Team/Eintragen eines neuen Knotens mit Git Client | hier]]. | Hier erfährst du, wie du einen Freifunk-Knoten-Key via Web-Interface ins Repository einträgst. Wie du einen Key mittels Git-Client in das Key-Repository einträgst, erfährst du [[Teams/Keys-Team/Eintragen eines neuen Knotens mit Git Client | hier]]. | ||
+ | |||
+ | =Grundlagen= | ||
+ | * [https://de.wikipedia.org/wiki/GitHub Github] ist eine Plattform, auf der kostenlose Repositories für die [https://de.wikipedia.org/wiki/Git Versionsverwaltungssoftware Git] angeboten werden. | ||
+ | * Wir verwalten unsere Keys in Repositories auf Github (https://github.com/freifunk-mwu/peers-ffmz bzw. https://github.com/freifunk-mwu/peers-ffwi). | ||
+ | * Die Gateways ziehen sich die Keys aus den Repositories alle 15 Minuten. | ||
+ | * Wir tragen die Keys in die Repositories entweder über die Web-Oberfläche oder über einen Git-Client ein. | ||
+ | * Wir arbeiten auf dem Master direkt. Es sind keine [https://help.github.com/articles/about-pull-requests/ Pull-Requests] nötig. | ||
+ | * Jeder Key entspricht einer Datei, die dem Repository hinzugefügt werden muss. | ||
+ | |||
+ | |||
+ | =Aufbau einer Key-Datei= | ||
+ | * Als Dateinamen für einen Key im Repository nehmen wir den Namen des Knotens wie er uns übermittelt wird. Dieser muss eindeutig innerhalb des Repositorys sein. | ||
+ | * Der Inhalt der Datei muss so aufgebaut sein: | ||
+ | <code>key "[DerKeySelbst]";</code> | ||
+ | |||
+ | Schaue dir vor ersten Commit am besten eine andere Key-Datei mal als Beispiel an. | ||
= Vorgehen zum Eintragen eines neuen Knotens via Web-Interface= | = Vorgehen zum Eintragen eines neuen Knotens via Web-Interface= |
Version vom 7. November 2017, 17:03 Uhr
Hier erfährst du, wie du einen Freifunk-Knoten-Key via Web-Interface ins Repository einträgst. Wie du einen Key mittels Git-Client in das Key-Repository einträgst, erfährst du hier.
Grundlagen
- Github ist eine Plattform, auf der kostenlose Repositories für die Versionsverwaltungssoftware Git angeboten werden.
- Wir verwalten unsere Keys in Repositories auf Github (https://github.com/freifunk-mwu/peers-ffmz bzw. https://github.com/freifunk-mwu/peers-ffwi).
- Die Gateways ziehen sich die Keys aus den Repositories alle 15 Minuten.
- Wir tragen die Keys in die Repositories entweder über die Web-Oberfläche oder über einen Git-Client ein.
- Wir arbeiten auf dem Master direkt. Es sind keine Pull-Requests nötig.
- Jeder Key entspricht einer Datei, die dem Repository hinzugefügt werden muss.
Aufbau einer Key-Datei
- Als Dateinamen für einen Key im Repository nehmen wir den Namen des Knotens wie er uns übermittelt wird. Dieser muss eindeutig innerhalb des Repositorys sein.
- Der Inhalt der Datei muss so aufgebaut sein:
key "[DerKeySelbst]";
Schaue dir vor ersten Commit am besten eine andere Key-Datei mal als Beispiel an.
Vorgehen zum Eintragen eines neuen Knotens via Web-Interface
- Prüfen, ob die Mail für Mainz oder Wiesbaden ist
- Prüfen, ob sich jemand aus Mainz aus Versehen die Wiesbadener Firmware geflasht hat oder umgekehrt - anhand Angaben in der Mail oder Info in der Karte (spätestens nach dem Eintragen).
- Prüfen, ob der Knoten evtl. näher an einer Nicht-MWU Community dran ist (sofern die Infos das hergeben).
- Key ins richtige Repo eintragen über Web-GUI (siehe Bild am Beispiel Mainz)
- Richtiges Repo wählen (Mainz oder Wiesbaden, siehe Links oben)
- Dateiname: Knotenname
- Body: key "<der eingesendete Key>";
- Commit-Message: Add key <Knotenname>
- In die Datei und Commit-Message nur den Key bzw. Knotennahmen aufnehmen, keine weiteren Zusatzinfos (Datensparsamkeit!)
- Antwort mit Willkommensnachricht an alle (keys@ in CC nicht vergessen)
- Wenn die Anfrage von einem bekannten Freifunker kommt, muss die Willkommensnachricht nicht nochmal geschickt werden.
Voraussetzungen zum Eintragen via Web-Interface
- Du hast einen Account auf github.com
- Dein Github-Account ist der Organisation "Freifunk MWU" zugeordnet (dazu bitte ans Admin-Team wenden)
- Dein Github-Account ist dem Keys-Team zugeordnet, so dass du auch die Berechtigung hast, das Repository zu verändern (ebenfalls ans Admin-Team oder an Florian wenden)