Teams/Keys-Team/Eintragen eines neuen Knotens via Web-Interface

Auf dieser Seite erfährst du, wie du einen Freifunk-Knoten-Key via Web-Interface ins Repository einträgst. Das Gleiche kannst auch du mittels Git-Client machen - wie 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

1. Prüfen, ob die Mail für Mainz oder Wiesbaden ist
   1. 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).
   2. Prüfen, ob der Knoten evtl. näher an einer Nicht-MWU Community dran ist (sofern die Infos das hergeben).
2. Key ins richtige Repo eintragen über Web-GUI (siehe Bild am Beispiel Mainz)
   1. Richtiges Repo wählen (Mainz oder Wiesbaden, siehe Links oben)
   2. Dateiname: Knotenname
   3. Body: key "<der eingesendete Key>";
   4. Commit-Message: Add key <Knotenname>
   5. In die Datei und Commit-Message nur den Key bzw. Knotennahmen aufnehmen, keine weiteren Zusatzinfos (Datensparsamkeit!)
3. Antwort mit Willkommensnachricht an alle (keys@ in CC nicht vergessen)
   1. 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)