Teams/Keys-Team/Eintragen eines neuen Knotens mit Git Client: Unterschied zwischen den Versionen
| Zeile 9: | Zeile 9: | ||
* Jeder Key entspricht einer Datei, die dem Repository hinzugefügt werden muss. | * Jeder Key entspricht einer Datei, die dem Repository hinzugefügt werden muss. | ||
| − | =Voraussetzungen | + | =Voraussetzungen zum Eintragen mittels Git-Client = |
| − | |||
* Du hast einen Account auf www.github.com | * Du hast einen Account auf www.github.com | ||
| − | * Dein 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) | + | * 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 lokal einen Git-Client installiert | ||
=Vorgehen zum Eintragen= | =Vorgehen zum Eintragen= | ||
Version vom 5. November 2017, 19:55 Uhr
Hier erfährst du, wie du einen fastd-Key mittels Git-Client in das Key-Repository einträgst.
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 in regelmäßigen Abständen.
- 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.
Voraussetzungen zum Eintragen mittels Git-Client
- Du hast einen Account auf www.github.com
- Dein Hithub-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!).
Die neue Datei dem Repo hinzufügen ("add)
git add KnotenName4711
Die neue Datei persistieren ("commit")
git commit KnotenName4711 -m "Add key"
Die neue Datei in den Master hoch spielen ("pushen")
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.