Gitlab

Die FIM betreibt eine Gitlab-Education-Instanz mit den üblichen Funktionen zur gemeinsamen Nutzung von Git-Repositories, Verwaltung von Issues, etc.

Der Zugriff erfolgt über die Webseite https://git.fim.uni-passau.de.

In erster Linie steht der FIM Gitlab-Server Angehörigen der FIM sowie deren Kooperationspartnern zur Verfügung, darf aber auch von anderen Angehörigen der Universität genutzt werden.

Mit der Nutzung dieses Dienstes verpflichtet sich jeder Nutzer, die Nutzungsbedingungen von GitLab Ultimate for Education einzuhalten:

https://about.gitlab.com/terms/#edu-oss

Damit ist die Nutzung durch folgende Nutzergruppen unter den jeweils genannten Prämissen zulässig:

• Studierende der Universität Passau: sofern GitLab für das Studium genutzt wird
• Mitarbeitende der Universität Passau: sofern GitLab für die Lehre oder ein Open Source Projekt genutzt wird
• Externe Kooperationspartner: Können in Projekten mitarbeiten (Lehre/OpenSorce Projekt), wenn sie vom Projekt-Owner eingeladen werden

Fakultätsangehörige der FIM verwenden bei der Anmeldung ihre FIM-Kennung. Auch Universitätsangehörige außerhalb der FIM können den FIM Gtilab-Server nutzen, indem sie sich mit Hilfe der allgemeinen Universitätskennung eine FIM-Kennung erzeugen. Bei der Anmeldung über die FIM-Kennung ist die Anmeldeoption "LDAP" zu wählen.

Arbeitsgruppen mit externen Kollaborationen können bei der FIM-Systembetreuung für Ihre Kooperationspartner die Einrichtung einer lokalen Kennung auf dem FIM-Gitlab-Server beantragen. Die Anmeldung erfolgt mit den mitgeteilten Zugangsdaten über die Anmeldeoption "Standard".

Im Rahmen der Gitlab Education Lizenz stehen Ihnen alle Funktionen einer Gitlab Enterprise-Umgebung zur Verfügung. Dies umfasst z. B.  Funktionen zur Planung von Projekten, zur Verwaltung von Aufgaben und zur Automatisierung von Abläufen. Eine Übersicht über diese Funktionen finden Sie auf der Website des Gitlab-Entwicklungsteams.

Für Projekte im FIMGit können Sie Continuous Integration/Delivery (CI/CD) per GitLab CI nutzen. Dafür stehen Ihnen gemeinsam genutzte GitLab CI Runner zur verfügung, die für alle Projekte standardmäßig aktiviert sind. In den CI/CD-Einstellungen ihrer Projekte können Sie die Verwendung der gemeinsam genutzten Runner ein- und ausschalten, und in Spezialfällen auch eigene Runner registrieren.

Für den Lehr- und Forschungsbetrieb können Gruppen für Sie werden, um die Verwaltung gemeinsamer Repositories zu erleichtern.

Wenden Sie sich dazu gerne über diese E-Mail-Vorlage an die FIM-Systembetreuung.

Die Daten des Gitlab-Dienstes sind in einem hochverfügbaren System gespeichert. Um die Performanz des Dienstes für alle zu gewährleisten, sollten Git-Repositories nur zur Versionierung von textartigen Dateiformaten (z.B. Quellcode, LaTeX-Dokumente, etc.) genutzt werden. Zu große Dateiuploads werden daher vom Gitlab-Server mit der Meldung "fatal: pack exceeds maximum allowed size" abgelehnt — auf dem Server wird dabei keine Änderung gespeichert.

Für größere Dateien (z.B. Bilder, Videos, Office- und PDF-Dokumente) wird die Funktion "Git Large File Storage" (LFS) unterstützt. Dabei werden die großen Dateien in einem separaten Speicherbereich auf unseren Servern abgelegt und im Git-Repository als Referenz hinterlegt.

Nach einer einmaligen Einrichtung auf Ihrem Rechner gestaltet sich die Benutzung von Git-LFS für Sie vollständig transparent: In Ihrer lokalen Kopie des Repositories bleiben alle Dateien an der gewohnten Stelle; bei der Übertragung auf den Gitlab-Server werden die von Ihnen als "groß" deklarierten Dateitypen automatisch in den korrekten Speicherbereich hochgeladen.