Zum Inhalt

GitLab

Mit dem Ressourcentyp GitLab ist es möglich, Metadaten zu GitLab Repositorien in Coscine zu verwalten.

Hintergrund

  • Erlaubt GitLab Projekte mit Metadaten zu versehen
  • Vorteil: Verknüpfung der Dateien mit Metadaten in Coscine
  • Als Ressourcenersteller*in stellen Sie sicher, dass alle Mitglieder des Projekts die Nutzungsbedingungen und Datenschutzerklärung des zugrundeliegenden Systems befolgen.

GitLab Ressource einrichten

  • Bei der Erstellung einer Ressource in Schritt 1 GitLab auswählen
  • Eingabe der GitLab Domain (z.B. "https://git.rwth-aachen.de/")
  • Eingabe des Projekt- oder Gruppenzugangstoken (s. GitLab - Projektzugangstoken und GitLab - Gruppenzugangstoken)
    • Neue Token können über die Einstellungen-Seite von GitLab erstellt werden.
    • Der Zugriff auf die Ressourcen in Coscine wird später gemäß den gewählten Berechtigungen des GitLab Tokens möglich sein.
  • Überprüfen der GitLab Verbindung über die blaue Schaltfläche
  • Auswahl des GitLab Projekts und des GitLab Branchs.
  • Akzeptieren der Nutzungsbedingungen und Datenschutzerklärung des GitLab Serviceproviders. Da der Anbieter der GitLab-Instanz variabel ist (Institutionen können jeweils ihre eigene GitLab-Instanz aufsetzen und verwalten), müssen Sie die jeweils für Sie gültigen Bedingungen von dem Anbieter einholen, dessen Instanz Sie im Feld GitLab Domain angegeben haben.

Setup der GitLab-Ressource

Abbildung 1 - Setup der GitLab-Ressource

GitLab Ressource nutzen

  • In einer GitLab Ressource werden alle Dateien angezeigt, die auch im GitLab Projekt enthalten sind.
  • Je nach Einstellungen des erstellten Tokens können Dateien über Coscine in das entsprechende GitLab Projekt hochgeladen oder auch gelöscht werden. Andersrum gilt dies genauso, dh. alle hochgeladenen Dateien in GitLab werden auch in Coscine dargestellt usw.
  • Zusätzlich können in einer GitLab Ressource, wie in anderen Coscine-Ressourcen auch, die Metadaten zu den einzelnen Dateien eingetragen werden.

Warnung

Die definierten Rollen und Scopes des GitLab-Tokens beeinflussen, in welchem Umfang der Dateizugriff möglich ist (z.B. Read only oder Bearbeiten möglich etc.). Durch die Coscine Nutzendenverwaltung (Owner, Member und Guest) wird beeinflusst, wer den Dateizugriff erhält. Sollten die Personen in Ihrem GitLab Projekt nicht mit den Mitgliedern des Coscine Projektes übereinstimmen, behalten Sie dies bitte im Hinterkopf.

GitLab Ressource archivieren

Eine GitLab Ressource kann auf archiviert gesetzt werden. Dadurch werden alle in Coscine zu den Dateien eingetragenen Metadaten archiviert. Es findet daurch keine Archivierung Ihres GitLab Projektes statt.

Speicherplatz

Da keine Daten gespeichert werden, benötigt diese Ressource keinen Speicherplatz.