Git-Versionierung
Das S(kim) betreibt für die TH OWL einen Dienst zur Versions- und Projektverwaltung. Das Open-Source-Produkt GitLab ist eine leistungsstarke und vielseitig nutzbare Versionierungssoftware, die Entwicklern und Teams als umfassende Plattform für die Zusammenarbeit an Softwareprojekten zur Verfügung gestellt wird. Mit GitLab können Sie nicht nur Code verwalten und versionieren, sondern auch den gesamten Entwicklungsprozess digitaler Projekte effizient steuern. So sind alle Prozesse und Änderungen, von der Planung, über die Implementierung, bis hin zur Bereitstellung, jederzeit für alle Projektmitglieder transparent nachvollziehbar. Auf diesem Weg lassen sich schneller Problemlösungen entwickeln und die Zusammenarbeit gelingt leichter.
Vergleich zum “Sync & Share”-Service der Hochschule: Es können nicht nur Daten und Dokumente zum gemeinschaftlichen Bearbeiten geteilt werden. Vielmehr bietet GitLab Möglichkeiten, den Versionsverlauf der Daten nachzuvollziehen, mehrere Versionen gleichzeitig zu sehen und gegebenenfalls zu vorherigen zurückzukehren. GitLab verwaltet somit die Bearbeitungshistorie in Echtzeit.
So ist die Dokumentation aufgebaut:
Anwendungsbeispiele
Forschung und Lehre
Für Forschung und Lehre ist die Nutzung von GitLab hochschulweit hilfreich. Versionsverwaltung eignet sich beispielsweise, wenn gemeinsam an Forschungsdaten gearbeitet wird und Zwischenstände der einzelnen Forschenden überblickt werden sollen. Forschungsdaten und -skripte können versioniert und zentral gespeichert werden, um eine bessere Nachverfolgbarkeit zu gewährleisten. Ebenso unterstützt eine Versionsverwaltung Forschungsgruppen, um Forschungsdaten zu teilen und in Echtzeit an gemeinsamen Projekten zu arbeiten und Änderungen nachzuvollziehen.
Anwendung in der Hochschule: Im S(kim) arbeitet beispielsweise das Projekt UFO.owl in Kooperation mit der Hochschule Bielefeld (HSBi) im Bereich der Forschungsdaten in GitLab zusammen.
Beantragung und Einrichtung
Allgemein
Angehörige der TH OWL können sich mit ihrem Hochschulbenutzernamen und Passwort am GitLab anmelden und so einen Benutzerzugang erstellen. Um GitLab im Anschluss aktiv nutzen zu können, senden Sie eine E-Mail an support@th-owl.de mit Informationen zu Ihrem Projekt und den Benutzern, die dazu eingeladen werden sollen. Verwenden Sie für Ihre Anfrage bitte den Fragebogen, den wir Ihnen im Reiter “Vorlage für die Beantragung” bereitgestellt haben.
Das S(kim) legt Ihren Arbeitsbereich als neue Gruppe im GitLab an und stellt gegebenenfalls eine Verknüpfung mit einer vorhandenen Obergruppe her. Nach positiver Rückmeldung bitten wir darum, dass sich die angegebenen Ansprechpersonen zeitnah am Service anmelden und einen Benutzerzugang erstellen. So können diese von uns direkt als Verantwortliche in der Gruppe hinterlegt werden. Die Verantwortlichen haben dann volle Zugriffsrechte innerhalb der Gruppe und können selbstständig weitere Personen hinzufügen oder Projekte anlegen.
Hier gelangen Sie zum GitLab:
Link zum GitLab (Link öffnet in neuem Fenster)
Zugriff auf GitLab
Für den Zugang zum GitLab gibt es zwei Möglichkeiten zur Authentifizierung:
- Access Token: Access Tokens werden hauptsächlich für die API-Authentifizierung und bei der Arbeit mit GitLab über HTTPS verwendet. Jedes Token kann nur auf die Ressourcen zugreifen für die das Token die Rechte hat. Das funktioniert auf der persönlichen Ebene aber auch für Grupppen und Projekte.
- SSH (Secure Shell Protocol) Schlüsssel: SSH-Schlüssel verwenden die Kryptografie von privaten und öffentlichen Schlüsseln zur Authentifizierung, während Access Tokens wie Passwörter fungieren, aber sicherer sind, weil sie nicht als Klartext gespeichert werden. SSH-Schlüssel werden häufig für den Git-Zugriff (z.B. git push/git pull) und als Methode zur Anmeldung in GitLab verwendet.
In den folgenden beiden Abschnitten erhalten Sie weitere Informationen zur Nutzung der beiden Möglichkeiten.
Zugriff über Access Token
1. Anmeldung und Einstellungen
Anmeldung bei GitLab
- Gehen Sie auf die Webseite vom GitLab und melden Sie sich mit Ihrem Benutzerzugang an. (Button “Anmeldung/Login”)
Zugriff auf die Einstellungen
- Klicke Sie auf Ihr Profilbild, um das Dropdown-Menü zu öffnen.
- Wählen Sie dann “Einstellungen” aus.
Personal Access Tokens öffnen
- Im Menü auf der linken Seite klicken Sie auf "Access Tokens".
Zugriff über SSH
1. Erstellen und öffnen
Erstellen eines SSH-Schlüssels
Falls Sie noch keinen SSH-Schlüssel haben, müssen Sie zuerst einen erstellen.
- Öffnen Sie ein Terminal (oder Git Bash unter Windows)
- Geben Sie den folgenden Befehl ein, um einen neuen SSH-Schlüssel zu erstellen:
ssh-keygen -t rsa -b 4096 -C “vorname.nachname@th-owl.de” - Wenn Sie dazu aufgefordert werden, den Speicherort für den Schlüssel auszuwählen, bestätigen Sie mit "Enter", um den Standardpfad zu verwenden (z. B. `~/.ssh/id_rsa`).
- Sie werden nach einer "Passphrase" gefragt. Dies ist optional, aber empfehlenswert für zusätzliche Sicherheit. Wenn Sie keine Passphrase verwenden möchten, drücken Sie einfach "Enter", um den Schritt zu überspringen.
Öffnen des öffentlichen Schlüssels
- Der öffentliche Schlüssel befindet sich im Standardverzeichnis unter `~/.ssh/id_rsa.pub`.
- Öffnen Sie diesen Schlüssel mit einem Texteditor, um ihn zu kopieren: cat ~/.ssh/id_rsa.pub
- Kopieren Sie den gesamten Inhalt des Schlüssels (alles, was nach `ssh-rsa` kommt, bis zum Ende des Schlüssels).
Weiterführende Links
Hier finden Sie weitere Links, um Ihnen die Arbeit mit GitLab zu erleichtern:
- Die geläufigsten Git-Kommandos (Link öffnet in neuem Fenster)
- Tutorial - Erste Versionsänderung (Erster Commit) (Link öffnet in neuem Fenster)
- Der Unterschied zwischen GitLab und GitHub (Link öffnet in neuem Fenster)
Kontakt
E-Mail: support@th-owl.de
Telefon: +49 5261 702 2222