Rainer Schuster

Nachdem ich anfänglich Probleme mit der Einrichtung von GIT in Verbindung mit der Nutzung von Github hatte will ich kurz darüber berichten, was ich so alles im Netz gefunden habe. Ich erzähle also nichts neues, sonder trage lediglich Erfahrungen von mir und anderen hier zusammen.

Da ich schon seit längerem ein Auge auf GIT habe, aber immer irgendwelche kleinen Probleme damit hatte, wollte ich es wieder wissen. GIT findet immer mehr Anhänger in der Open Source Community. Und ich kann auch gut verstehen warum. Meiner Meinung nach verstehen es nicht viel Source Code Management Systeme (SCM)  sich auf verteile Verwaltung so gut einzuschiessen wie GIT das tut. TortoiseGIT gibt es mittlerweile als Version 1.0.2.0. “Pretty Stable” wie es mir erschien, hat sich doch der Client auf Basis von TortoiseSVN seit Anfang des Jahres mit Version 0.1 ganz schön gemausert. Also dachte ich es wäre an der Zeit das nochmal zu versuchen. Einfach? Naja, das kommt drauf an von welchem Standpunkt man es sieht. Es gibt den ein oder anderen Fallstrick, auf den zu achten ist, aber mit ein wenig genauerem lesen bin ich dann doch ans Ziel gekommen.

First things first

TortoiseGIT bringt zwar die benötigten Dateien mit, ich will aber zuerst msysGIT konfigurieren. Da msysGIT putty nicht mit an board hat und es unter Windows Probleme mit OpenSSH gibt müssen wir diesen Weg gehen. GIT kann auch gut über die eigene BASH benutzt werden. Viele bevorzugen wahrscheinlich diesen Weg auch. Der Vorteil liegt für mich klar auf der Hand. Wer sich einmal mit den Kommandozeilenbefehlen der GIT-Bash beschäftigt hat, kann diese leicht automatisieren und in seine Continous Integration Umgebung, oder einfach nur das Build Skript einbinden. Zudem gehe ich auch immer mehr dazu über die Konsole zu benutzen. Damit also für mich auf jeden Fall ein lohnenswerter Einsatz.

Einen Schlüssel erstellen

1. Putty herunterladen …
2. … und in ein Verzeichniss seiner Wahl entpacken. Ich gehe von C:\Program Files\Putty aus
3. puttygen.exe starten
4. Im Putty-Dialog die Aktion Generate ausführen (Defaults können beibehalten werden, siehe Abbildung 1). Zum Generieren muss die Maus im Eingabefeld bewegt werden. Und nein, an alle die jetzt entsetzt oder freudig aufschreien. Das ist nicht mein Schlüssel. Den habe ich extra für den Blogeintrag generiert.
   
     Abbildung 1
5. Einen passenden Kommentar wählen (Key comment). Dieser Kommentar wird bei Authetifizierungen als Erinnerung welche Schlüsseldatei vorliegt angezeigt.
6. Passwort entsprechend wählen (key passphrase und cofirm passphrase)
7. Die generierten Schlüssel (public und private) speichern. Dazu die Aktionen bei Save generated key ausführen. Die msysGIT Umgebung erwartet im home Verzeichnis (bei Vista oder Win 7 C:\Users\rainer\, bei XP C:\Dokumente und Einstellungen\Rainer\) ein Verzeichniss .ssh. Für den privaten Key benötigen wir daher als Dateiname id_rsa.ppk und für public den Namen id_rsa
8. Den angezeigten Key aus der Textbox aus der oberen hälfte des Bildschirms in die Zwischenablage kopieren

Schlüssel auf Github hinterlegen

Variante a: Neuer Account

1. Github Account anlegen, falls noch nicht geschehen.
2. Beim Anlegen des Accounts kann der generierte Public Key aus der Zwischenablage eingefügt werden (siehe Abbildung 2)
   
   Abbildung 2

Variante b: Schlüssel hinzufügen

1. Auf Github anmelden und auf account klicken (oben rechts in der Navigation)
2. Im Bereich SSH Public Keys eine E-Mail Adresse hinterlegen. Diese braucht ihr später zur Konfiguration von Git noch
3. Bei Title gebt ihr eure E-Mail Adresse ein
4. Bei Key kopiert ihr den Public Key aus der Zwischenablage ein
5. Die Änderungen speichern.

msysGIT installieren

1. Git-1.6.4-preview20090730.exe oder aktueller von hier herunterladen.
2. Installation starten und dem Assistenten folgen.
3. Bei Adjust your PATH environment die zweite Option auswählen (siehe Abbildung 3)
   
     Abbildung 3
4. Bei Choosing the SSH executable den Pfad zur Plink.exe hinterlegen. Das ist das Verzeichnis, indem wir Putty abgespeichert haben - C:\Program Files\Putty\ (siehe Abbildung 4)
   
     Abbildung 4

TortoiseGIT installieren

1. TortoiseGIT oder aktueller von hier herunterladen
2. Installation starten und dem Assistenten folgen.
3. Bei Choose SSH Client den ersten Eintrag auswählen. (siehe Abbildung 5)
   
     Abbildung 5

GIT Umgebung konfigurieren

Was ihr noch machen solltet: Die Globale Konfiguration. Das könnt ihr entweder über die Umgebungsvariablen machen, oder über die GIT-Bash Konsole. Diese Einstellungen lassen sich später auch einfach pro Projekt individuell anpassen. Ich erkläre euch hier den Weg, wie ihr das über die Konfigurationsdatei von GIT macht.

1. Im Explorer auf einem Ordner oder einer Datei das Kontextmenü aufrufen
2. Den Menübefehl TortoiseGIT->Settings ausführen
3. Bei der Einstellung GIT->Config eure Daten eintragen (siehe Abbildung 6). Ich habe dazu meinen Username von Github und die dort hinterlegte E-Mail Adresse eingetragen und übernommen
    
      Abbildung 6
4. Um Probleme zu vermeiden sollten die Optionen AutoCrLf und SaveCrLf deaktiviert bleiben. Ich persönlich bin immer sehr skeptisch, wenn etwas automatisch von Zauberhand entschieden wird. Gerade was Zeilenumbrüche angeht. Ob das aktuell noch ein Problem ist weiß ich nicht, aber Problemfälle in der Vergangenheit gab es genug. z.B. http://www.mail-archive.com/msysgit@googlegroups.com/msg00088.html.
   Meine Empfehlung: beides auf false stellen

Das Gleiche nun für msysGIT, indem wir die GIT-Bash aufrufen (Originaleintrag siehe Hilfe auf github)

1. GIT-Bash über Kontextmenü von einem Ordner (rechte Maustaste auf Ordner) mit GIT-BASH Here oder direkt über das Startmenü aufrufen.
2. Folgende Befehle ausführen (um eine ausführliche Hilfe für den config Befehl zu kommen git config --help ausführen).
   • $ git config --global user.name "dein_github_user_name"
   • $ git config --global user.email “deine_github_account_email”
   • $ git config --global core.autocrlf false
   • $ git config --global core.savecrlf false
     Bildet euch selbst eine Meinung über die Hilfe zum Thema core.autocrlf und core.savecrlf über: git config –help. Die Befehle könnt ihr für jedes Projekt nochmal einzeln setzen, indem ihr den Parameter –global weg lasst.
3. Last but not least solltet ihr das github token konfigurieren. Mache Tools (so auch TortoiseGIT) fragen die Authentizität des Servers ab. Diese könnt ihr dann konfigurieren wenn es soweit ist. TortoiseGIT bemägelt z.B. das der Server nicht bekannt ist und fordert euch auf die Quelle zu erlauben, oder das ganze abzubrechen, dem könnt ihr aber vorbeugen:
   • $ git config --global github.user dein_github_user_name
   • $ git config --global github.token dein_github_api_token
     Das API Token findet ihr auf github unter account im Bereich Your User Information

Zum Schluss bleibt mir nur noch zu sagen: Lest euch die Hilfe und das hier integrierte GIT Community Book durch. Die Hilfe findet ihr einfach im Explorer über das Kontextmenü->TortoiseGIT->Help