Erste Schritte

1. Download

Git können Sie von git-scm.com/downloads herunterladen bzw. im Paketverwaltungsprogramm Ihres Betriebssystems finden.

2. Zugang

In GitLab können Sie sich unter der URL https://gitlab.rrz.uni-hamburg.de (Gitlab Ultimate nur für Forschung und Lehre) oder https://gitlab-ce.rrz.uni-hamburg.de (GitLab-CE für Inhalte außerhalb von Forschung und Lehre) anmelden. Verwenden Sie dort bitte das Login „Benutzerkennung“ und geben Sie Ihre Benutzerkennung (B-Kennung) und Ihr Passwort ein. Externe Personen ohne Benutzerkennung mit einem lokalen Gitlab-Account verwenden bitte den Login „Standard“ und melden sich mit den betreffenden Zugangsdaten an. 

Bei GitLab-Ultimate:

Bei Gitlab-CE:

Bei GitLab für Lehre und Forschung lesen Sie und akzeptieren Sie bitte die GitLab-Utlimate Nutzungsbedingungen:

3. SSH-Keys

Um Gitlab mittels SSH nutzen zu können, müssen Sie zuerst ihren SSH-Schlüssel in Gitlab ablegen.

Wenn Sie auf „generate it“ klicken, bekommen Sie eine Anleitung zum Erzeugen von SSH-Schlüsseln, die man im persönlichen Profil unter „Benutzereinstellungen“→„SSH-Schlüssel“ hinzufügen kann.

Beachten Sie bitte: der Zugang zu Gitlab per SSH ist aus Sicherheitsgründen aus dem Uni-Netz möglich. Von Außerhalb nutzen Sie bitte https oder SSH über VPN. Externe Personen mit lokaler Gitlab-Kennung können aussschließlich https nutzen.

4. Projekt in Gitlab erstellen

Ein neues Git-Projekt legen Sie unter „projects“→ „new“ an.

Auf der darufhin folgenden Seite finden Sie eine Anleitung, wie Sie globale Git-Einstellungen vornehmen, ein neues repository anlegen oder einen existierenden Ordner in ein Repository umwandeln. Hier sind einige Beispiel den Server gitlab.rrz.uni-hamburg.de:

• Globale Git-Einstellungen:

git config --global user.name "IHRE-BENUTZERKENNUNG"
git config --global user.email "IHRE-EMAIL-ADRESSE"

• Neues Repository anlegen:

git clone https://gitlab.rrz.uni-hamburg.de/IHRE-BKENNUNG/REPOSITORY-NAME.git (bei GitLab Ultimate)
oder
git clone https://gitlab-ce.rrz.uni-hamburg.de/IHRE-BKENNUNG/REPOSITORY-NAME.git (bei Gitlab-CE)
cd REPOSITORY-NAME
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master

• Existierenden Ordner in ein Git Repository umwandeln:

cd EXISTIERENDER-ORDNER
git init
git remote add origin https://gitlab.rrz.uni-hamburg.de/IHRE-BKENNUNG/REPOSITORY-NAME.git (bei GitLab Ultimate)
oder
git remote add origin https://gitlab-ce.rrz.uni-hamburg.de/IHRE-BKENNUNG/REPOSITORY-NAME.git (bei GitLab-CE)
git add .
git commit
git push -u origin master

5. Git-Nutzung

Ab jetzt gehen Sie mit Ihren Projektdateien ähnlich vor wie mit der eingangs benutzten „README“:

1. Branch wechseln (git checkout)
2. ggf. Stand des Projekts herunterladen (git pull)
3. Dateien erstellen oder ändern
4. vormerken (git add)
5. speichern (git commit)
6. hochladen (git push)

Dabei benötigen Sie erst im letzten Schritt eine Netzwerkverbindung zum Gitlab-Server. GitLab ermöglicht Ihnen dabei einen grafischen Überblick über die Entwicklung Ihres Projekts und bietet viele weitere Hilfmittel.

Eine ausführliche Dokumentation zu Git finden Sie auf git-scm.com/book/de.
Einen Überblick über die Kommandozeilenbefehle erhalten Sie auf git-scm.com/docs.