Teams/Keys-Team/Eintragen eines neuen Knotens via Web-Interface: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
(Die Seite wurde neu angelegt: „Hier erfährst du, wie du einen Freifunk-Knoten-Key via Web-Interface ins Repository einträgst. = Vorgehen zum Eintragen eines neuen Knotens = Datei:Github…“) |
|||
| (6 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | + | 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 [[Teams/Keys-Team/Eintragen eines neuen Knotens mit Git Client | hier]]. | |
| − | = Vorgehen zum Eintragen eines neuen Knotens = | + | =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= | ||
[[Datei:Github addnode.png|right|445px|]] | [[Datei:Github addnode.png|right|445px|]] | ||
# Prüfen, ob die Mail für Mainz oder Wiesbaden ist | # Prüfen, ob die Mail für Mainz oder Wiesbaden ist | ||
| Zeile 14: | Zeile 29: | ||
# Antwort mit Willkommensnachricht an alle (keys@ in CC nicht vergessen) | # 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. | ## 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 [https://github.com github.com] | ||
| + | * Dein Github-Account ist der [https://github.com/orgs/freifunk-mwu/dashboard Organisation "Freifunk MWU"] zugeordnet (dazu bitte ans Admin-Team wenden) | ||
| + | * Dein Github-Account ist dem [https://github.com/orgs/freifunk-mwu/teams/fastd-keys/members Keys-Team] zugeordnet, so dass du auch die Berechtigung hast, das Repository zu verändern (ebenfalls ans Admin-Team oder an Florian wenden) | ||
Aktuelle Version vom 7. November 2017, 11:06 Uhr
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
- 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)