Skip to content

Git & GitHub Tutorial

Jump to bottom
Lukas Kalbertodt edited this page Aug 25, 2015 · 11 revisions

1. GitHub Account erstellen

Erstellt euch einen GitHub Account (oben rechts auf "Sign up"). Nutzt am besten eure Uni-Email Adresse, da ihr so später einfacher ein Angebot nur für Studenten in Anspruch nehmen könnt.

Euer "Username" ist halbwegs wichtig, da er später in vielen Links von euren Repositories steht. Der Link zu eurem Benutzeraccount ist z.B. github.com/torvalds und der Link zu einem Repository ist dann github.com/torvalds/linux. Nutzt am besten entweder nur euren Nachnamen (torvalds) oder euren vollen Namen in CamelCase (MiriamBeutel, LukasKalbertodt, JulianKniephoff).

2. SSH Key hinzufügen

Der SSH Key wird von git genutzt, um Rechte zu prüfen. Statt eines Passwortes, das ihr immer eingeben müsst, legt ihr euch auf eurem PC eine Datei an, die als Passwortersatz dient: Den Schlüssel. Damit dieser Schlüssel aber nicht einfach geklaut wird, wenn jemand sich Zugang zu eurem System verschafft, ist der Schlüssel selber nochmal mit einem Passwort verschlüsselt. Klingt eventuell kompliziert, ist aber nachher deutlich einfacher und sicherer.

Schritt 1: Key erzeugen

Führt folgenden Befehl im Terminal aus (fügt eure richtige E-Mail Adresse ein, die ihr für GitHub verwendet habt):

$ ssh-keygen -t rsa -b 4096 -C "wwacker@uos.de"

Wenn ihr gefragt werdet, in welcher Datei der Key gespeichert werden soll, drückt einfach Enter, ohne etwas einzugeben. Danach wird nach einem Passwort gefragt. Dies wird genutzt, um euren Key zu verschlüsseln. Dieses Passwort braucht ihr, wenn ihr euren Schlüssel verwenden wollt. Selbstverständlich sollte das Passwort nicht zu kurz oder einfach sein.

Nachdem ihr das Passwort zweimal eingegeben habt, wird euch der sog. Fingerprint eures Keys angezeigt als auch, wohin die Datei gespeichert wurde:

Your identification has been saved in /home//wwacker/.ssh/id_rsa.
Your public key has been saved in /home/wwacker/.ssh/id_rsa.pub.
The key fingerprint is:
01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db wwacker@uos.de

Schritt 2: Key zum GitHub Account hinzufügen

Öffnet die Datei mit der .pub-Endung aus Schritt 1 in einem Editor eurer Wahl (z.B. $ subl /home/wwacker/.ssh/id_rsa.pub) und kopiert den kompletten Inhalt (Wichtig: Fügt keine leeren Zeilen hinzu, sondern kopiert exakt den Inhalt der Datei).

  • Geht im Browser auf github.com und meldet euch an
  • Klickt dann oben rechts auf euer kleines Profilfoto
  • Im aufklappenden Menü klickt ihr dann auf "Settings"
  • Auf der neuen Seite klickt ihr dann in der linken Sidebar auf "SSH Keys"
  • Danach klickt ihr auf den Button "Add SSH Key"
  • Im Titelfeld gebt ihr "Uni Key" oder ähnliches ein
  • Fügt jetzt den kopierten Inhalt der Datei in das Feld "Key" ein
  • Klickt auf "Add" und gebt euer GitHub Kennwort ein (nicht das vom Key!), um die Aktion zu bestätigen

Schritt 3: Key testen

Ob auch alles geklappt hat, testet ihr, indem ihr folgenden Befehl im Terminal ausführt:

$ ssh -T git@github.com

Jetzt bekommt ihr eventuell diese Meldung:

The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

Dann gebt "yes" ein und bestätigt mit Enter.

Wenn jetzt alles geklappt hat, solltet ihr folgendes sehen:

Hi username! You've successfully authenticated, but GitHub does not
provide shell access.

Falls ihr etwas anderes seht, fragt einen Tutor oder Sitznachbarn.

Clone this wiki locally