946
Bearbeitungen
Änderungen
Teams/Keys-Team/Eintragen eines neuen Knotens mit Git Client (Quelltext anzeigen)
Version vom 7. November 2017, 11:05 Uhr
, 11:05, 7. Nov. 2017keine Bearbeitungszusammenfassung
Auf dieser Seite erfährst du, wie du einen Freifunk-Key (fastd) mittels Git-Client in das Key-Repository einträgst. Das Gleiche kannst du auch über die Web-Oberfläche machen - wie erfährst du [[Teams/Keys-Team/Eintragen eines neuen Knotens via Web-Interface | hier]].
=Grundlagen=
=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.
* [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).
* 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 in regelmäßigen Abständen.
* 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 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.
* 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.
* 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.
=Voraussetzungen zum Eintragen mittels Git-Client =
=Voraussetzungen zum Eintragen mittels Git-Client =
* Du hast einen Account auf www.github.com
* Dein Hithub-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)
* Du hast einen Account auf [https://github.com github.com]
* Du hast lokal einen Git-Client installiert
* 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)
* Du hast lokal einen Git-Client installiert (und hast idealerweise auch schonmal ein Git-Tutorial angeschaut)
=Vorgehen zum Eintragen=
=Vorgehen zum Eintragen=
git pull
git pull
Dann in den Repository-Ordner auf der Festplatte bitte die neue Key-Datei einfügen (Datei neu erstellen und den eingesendeten Key als Dateiinhalt nehmen). In die Key-Datei und die Commit-Message bitte nur den Key bzw. Knotennahmen aufnehmen, keine weiteren Zusatzinfos (Datensparsamkeit!).
Dann in den Repository-Ordner auf der Festplatte bitte die neue Key-Datei einfügen (Datei neu erstellen und den eingesendeten Key als Dateiinhalt nehmen). In die Commit-Message bitte nur den Key bzw. Knotennahmen aufnehmen, keine weiteren Zusatzinfos (Datensparsamkeit!).
Nachdem du die neue Datei auf deinem Rechner hinzugefügt hast, musst du sie auch dem Repository hinzufügen ("add):
Nachdem du die neue Datei auf deinem Rechner hinzugefügt hast, musst du sie auch dem Repository hinzufügen ("add):
= Weitere Infos =
= Weitere Infos =
* Weitere Infos zum Arbeiten mit Github (z.B. wie du SSH statt https nutzt) findest du hier: https://help.github.com/articles/which-remote-url-should-i-use/
* Weitere Infos zum Arbeiten mit Github (z.B. wie du SSH statt https nutzt) findest du hier: https://help.github.com/articles/which-remote-url-should-i-use/