Inhaltsverzeichnis

GitLab

GitLab ist eine webbasierte Oberfläche für Softwareprojekte und bietet diverse Management- und Kollaborations-Funktionalitäten. GitLab kann von jedem/r Hochschulangehörigen von überall aus verwendet werden.

https://gitlab.bht-berlin.de

Lernmaterialien und frei zugängliche Dokumentationen zum Thema GIT im PDF-Format, als eBook und Online finden Sie unter anderem hier:

Statische Webseiten

GitLab ermöglicht die automatische Erzeugung einer persönlichen Webseite, welche für Projektarbeiten o.ä. genutzt werden kann.

Starten Sie zunächst ein neues Projekt:

In der darauffolgenden Auswahl wählen sie „leeres Projekt“ als Option aus:

Geben sie einen passenden Namen für ihr Projekt an, alle anderen Einstellungen können so belassen werden:

Im leeren Projekt werden nun die Daten ihrer Homepage hinterlegt. Erzeugen sie zunächst einen Ordner mit dem Namen „public“:

Erzeugen Sie im Ordner „public“ eine Datei mit dem Namen „index.html“:

Schreiben Sie in diese Datei den Inhalt ihrer Webseite:

Im nächsten Schritt muss nun im Wurzelverzeichnis eine spezielle Konfigurationsdatei angelegt werden. Hier sind sowohl der Name als auch der Inhalt wichtig:

Die Datei muss den Namen .gitlab.ci.yml haben. Der Inhalt sollte wie folgt aussehen, die Einrückungen werden mit Leerzeichen vorgenommen: 

image: alpine:latest

pages:
  stage: deploy
  script:
  - echo 'Nothing to do...'
  artifacts:
    paths:
    - public

Ihr Projekt hat nun einen Ordner „public“ mit den Daten der Homepage, sowie eine passende Konfigurationsdatei.

Falls alles funktioniert hat, dann finden Sie im Abschnitt „CI/CD“ eine Information über die erfolgreiche Erzeugung der Homepage:

Im Bereich „Settings“ → „Pages kann man nun die URL der Seite ermitteln:

Zwei-Faktor-Authentifizierung

Die Gitlab-Installation der Hochschule verlangt eine Zwei-Faktor-Authentifizierung. Dies führt bei manchen Anwendungen zu Problemen, da diese ohne Nutzerinteraktion auf Repositories o.ä. zugreifen müssen.

Bitte nutzen Sie in solchen Fällen der Konzept der Personal Access Token, welches in der Gitlab-Dokumentation beschrieben ist.