GitTutorial

GitTutorial

Schritt für Schritt Anleitung um diesen GitServer nutzen zu können.

Vorbereitung

Als erstes benötigen wir ein neues Projekt. Dazu klicken wir auf das + Zeichen rechts oben neben unserem Bild und wählen "Neues Repository aus".

Auf der nächsten Seite geben wir unsere gewünschten Informationen ein und klicken auf die Checkbox ganz unten.

Was wir nun brauchen ist das Programm git, welches wir hier bekommen. Dies' ist das Hauptwerkzeug was wir benötigen um Dateien hoch- und herunterladen zu können. Die Installation geht relativ schnell und unkompliziert.

Nach der Installation starten wir das Programm git bash (von der GUI würde ich erst einmal abraten). Diese Konsole ist wie das Terminal unter Linux und alle gängigen Befehle aus der Unix-Welt funktionieren ebenfalls, wie zum Beispiel ls, ps, grep, awk, sed, etc...

An dieser Stelle ist es passend RSA-Keys zu erstellen um mit diesem Server später kommunizieren zu können. Das kleine Programm ssh-keygen wird mit git mitgeliefert. Damit erstellen wir uns zwei Schlüssel (Private & Public). Folgender Befehl wird eingegeben:

ssh-keygen -t rsa -b 4096 -C "deine@emailadresse.de"

Anschließend wird man gefragt, wo die RSA-Keys abgelegt werden sollen. Diesen Pfad belassen wir beim Standard und bestätigen einfach mit der Enter-Taste.

Enter a file in which to save the key (/c/Users/Benutzername/.ssh/id_rsa): [Enter]

Danach wird nach dem Kennwort für den Schlüssel gefragt. Diesen geben wir zwei mal ein. Es ist normal, dass das Kennwort während der Eingabe nicht sichtbar ist. Nicht irritieren lassen.

Enter passphrase (empty for no passphrase):

Enter same passphrase again:

Letzendlich werden die beiden generierten Keys erstellt und abgelegt.

Your identification has been saved in /c/Users/Benutzername/.ssh/id_rsa.

Your public key has been saved in /c/Users/Benutzername/.ssh/id_rsa.pub.

Die id_rsa.pub-Datei ist dabei der Public-Key, der andere, ohne eine Dateiendung, der Private-Key.

Wir öffnen die id_rsa.pub-Datei (mit einem Texteditor, wie z.B. notepad++) und kopieren uns den kompletten Inhalt. Der Inhalt der Datei wird jetzt in unser Profil unter Einstellungen -> SSH-Schlüssel eingetragen.

Lokales Repository

Als nächstes wechseln wir mit cd, in der git bash, in ein Verzeichnis, welches wir als lokales Repository deklarieren möchten. Dieses kann entweder leer oder schon befüllt sein, z.B. mit einem Projekt.

cd Desktop/workspace/TestProjekt

Mit dem folgenden Befehl deklarieren wir das Verzeichnis nun als Repository.

git init

Jetzt haben wir ein Server Repository und ein Local Repository, wobei der Server hier die Priorität hat.

Um mit dem Server kommunizieren zu können, wird der Server als remote angelegt. Dabei sieht die Syntax folgendermaßen aus:

git remote add ServerBezeichner URL

den ServerBezeichner kannst du dir aussuchen, sollte jedoch keine Sonder- und/oder Leerzeichen haben. Die URL bekommst du aus dem Repository, welchen du hier auf dem Server angelegt hast. Es ist der SSH-Link der so aussieht: ssh://git@ray-works.de:5050/Benutzername/Projektname.git

git remote origin ssh://git@ray-works.de:5050/Ray/TestProjekt.git

Sollte keine Rückmeldung kommen, war alles richtig.

Jetzt brauchen wir erstmal die Dateien die in dem Server Repository liegen. Diese bekommen wir mit folgendem Befehl:

git pull origin master --allow-unrelated-histories

Der Zusatz --allow-unrelated-histories wird nur beim ersten Pull benötigt. Später kann er weggelassen werden.

Um nun die Daten aus dem lokalen Verzeichnis hochladen zu können, werden wir diese nun "markieren", commiten und anschließend zum Server schicken.

git add .

Der Punkt sagt hier: Alle Dateien in diesem Verzeichnis (rekursiv).

git commit -a -m "Kommentar zu den aktualisierte(n) Datei(en)"

git push origin master

master ist der Hauptstrang des Repositorys. An dieser Stelle kann auch ein Branch (Zweig) angegeben werden.

Danach wird man nach seinem Kennwort gefragt.

Enter passphrase for key '/c/Users/Benutzername/.ssh/id_rsa':

Sollte das Kennwort korrekt sein, gibt es eine Upload-Bestätigung.

Counting objects: 4, done.

Delta compression using up to 8 threads.

Compressing objects: 100% (4/4), done.

Writing objects: 100% (4/4), 1.26 KiB | 0 bytes/s, done.

Total 4 (delta 0), reused 0 (delta 0)

To ssh://ray-works.de:5050/Ray/TestProjekt.git

• [new branch] master -> master

Um später aktualisierte Dateien (falls man im Team arbeitet) herunterladen zu können, gibt man folgenden Befehl ein:

git pull origin master