Git ist eine Software zur verteilten Versionsverwaltung von Dateien (engl. Distributed version control). Die Nutzung einer Versionsverwaltungssoftware macht es u.a. möglich, dass Änderungen an Dateien nachverfolgt werden können. Dies erleichtert die Zusammenarbeit mehrerer Personen an einem Projekt, da gleichzeitige Änderungen nicht zu Dateiüberschreibungen und damit zu Informationsverlusten führen, sondern mithilfe der Software zusammengeführt werden können. Versionsverwaltungssoftware wird häufig in der Softwareentwicklung eingesetzt, doch eignet sie sich beispielsweise auch zur Arbeit an wissenschaftlichen Texten wie Abschluss- und Doktorarbeiten, die mit der Textsatzsoftware LaTeX verfasst werden.

Mit GitLab bietet das LRZ einen web-basierten Dienst zur Verwaltung von Git-Repositories an. GitLab stellt neben den eigentlichen Repositories Werkzeuge wie Wikis und einen Issue-Tracker bereit. Mit "Merge Requests" gibt es ein Mittel, mit dem Code-Reviews kollaborativ und transparent durchgeführt werden können.

Im Folgenden finden Sie eine Übersicht über die wichtigsten Eckdaten. Weiterführende Informationen entnehmen Sie bitte den GitLab-FAQ.

Nutzungsberechtigung

Zur Nutzung des LRZ-Dienstes GitLab berechtigt sind alle Mitglieder von TUM, LMU und sonstigen Münchner Hochschulen. Dazu ist eine LRZ-, TUM- oder LMU-Kennung nötig.

Sofern noch keine automatische Freischaltung erfolgt ist, können einzelne Benutzerkennungen vom verantwortlichen Master User über unser ID-Portal freigeschaltet werden. Falls dies nicht möglich ist, wenden Sie sich bitte an das Servicedesk.

Speicherplatz

Da Git auf die Versionsverwaltung von Textdateien (Nur-Text-Format, Quellcode-Dateien etc.) ausgelegt ist, gilt generell, dass Git-Repositories relativ klein bleiben sollten (im zweistelligen MB-Bereich).

Für binäre Formate wie Bildarchive, Microsoft-Office-Dateien (.doc, .docx, .xls, .xlsx etc.), LibreOffice-/OpenOffice-Dateien (.odt, .ods etc.) oder sehr dynamische Daten wie Logs ist Git nicht gut geeignet. Für diesen Zweck unterstützt GitLab die Erweiterung Large File Storage (LFS). Die maximale Dateigröße beim Upload liegt bei 2GB und das Gesamtlimit für Daten im LFS beträgt derzeit 25 GB.

Da es sich allerdings manchmal nicht vermeiden lässt, dass einzelne Projekte größer werden, existiert derzeit keine feste Speicherplatzbeschränkung. Sollte eines Ihrer Projekte unverhältnismäßig groß werden, werden Sie vom LRZ-Team kontaktiert, um eine Lösung zu erarbeiten. Zur Wahrung eines sicheren und stabilen Betriebs behalten wir uns vor, sehr große Projekte zeitweise für den Schreibzugriff zu sperren oder ganz zu deaktivieren.

Projektlimit

Es dürfen höchstens 10 persönliche Projekte angelegt werden. Dieses Limit kann in begründeten Fällen angehoben werden. Bitte wenden Sie sich dazu an das Servicedesk.

Gruppen

Bei logisch zusammengehörigen Projekten bietet sich die Nutzung von GitLab-Gruppen an. Innerhalb einer GitLab-Gruppe ist die Projektanzahl nicht beschränkt. Eine Gruppe hat auch den Vorteil, dass die Rechteverwaltung für gewöhnlich erleichtert und übersichtlicher wird. Außerdem vererbt sich die Rolle eines Nutzers einer Gruppe zu allen Projekten in der Gruppe.

Öffentliche Projekte

Es besteht die Möglichkeit, Projekte zu veröffentlichen, so dass sie ohne Login geklont werden können. Die benötigte Einstellung für das Projekt kann nur von den GitLab-Administratoren vorgenommen werden. Bitte geben Sie dazu den Projektnamen oder -pfad mit einer entsprechenden Nachricht an den Servicedesk weiter.

Wir empfehlen, alle öffentlichen Projekte in Gruppen einzuordnen, damit sie nicht von persönlichen GitLab-Kennungen abhängig sind. Wenn ein Projekt öffentlich sichtbar sein soll, dann muss auch die Gruppe, zu der das Projekt gehört, öffentlich sichtbar gemacht werden.

Bitte beachten Sie:

• Bei öffentlichen Projekten sind der Name und die E-Mail-Adresse, die in der Konfiguration von Git hinterlegt wurden, bei jedem Commit öffentlich sichtbar.
• Die GitLab-Usernamen aller Mitglieder des öffentlichen Projekts sowie der öffentlichen Gruppe (auch wenn sie keine Commits machen) sind ebenfalls öffentlich sichtbar.
• Der GitLab-Username ist standardmäßig die LRZ-Kennung (u.a. die von HM/LMU/TUM verwendeten Zeichenfolgen) des Nutzers und soll von allen Mitgliedern der öffentlichen Projekte geändert werden (Settings → Account → Change Username).

Bei Änderungen des GitLab-Usernamens werden die Web-Adressen und Repository-URLs von persönlichen Projekten des Nutzers automatisch entsprechend von GitLab geändert. Die Web-Adressen und Repository-URLs der in Gruppen eingeordneten Projekte sind hingegen nicht davon betroffen, weil diese URLs den Usernamen eines Nutzers nicht enthalten.