Teams/Keys-Team/Eintragen eines neuen Knotens mit Git Client

Aus Freifunk MWU Wiki
Zur Navigation springen Zur Suche springen

Hier erfährst du, wie du einen fastd-Key mittels Git-Client in das Key-Repository einträgst.

Grundlagen

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 ist so aufgebaut:

key [DerKeySelbst];

Voraussetzungen zum Eintragen mittels Git-Client

  • Du hast einen Account auf github.com
  • Dein Github-Account ist dem Keys-Team zugeordnet (so dass du auch die Berechtigung hast, das Repository zu verändern)
  • Du hast lokal einen Git-Client installiert

Vorgehen zum Eintragen

Repository lokal spiegeln mit "clone"

git clone https://github.com/freifunk-mwu/peers-ffmz

oder wenn Repo schon vorhanden die lokale Version erstmal aktualisieren mit dem letzten Stand aus dem Repo ("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!).

Nachdem du die neue Datei auf deinem Rechner hinzugefügt hast, musst du sie auch dem Repository hinzufügen ("add):

git add KnotenName4711

Danach musst du das Hinzufügen der neuen Datei persistieren ("commit"):

git commit KnotenName4711 -m "Add key KnotenName4711"

Zu guter Letzt musst du die neue Datei noch in den Master hoch spielen ("pushen"). Beim Pushen wirst du nach User+PW gefragt:

git push

Erst durch das Pushen wird die Datei tatsächlich wieder in den Master gespielt. Ab dann kann sie von den Gateways gezogen und verwendet werden. Sobald eine Datei hinzugefügt wird, läuft außerdem ein Prüfskript, das die hinzugefügte Datei auf Konsistenz prüft und ggf. eine Mecker-Mail versendet.

Weitere Infos