====== 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|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:

  * [[https://git-scm.com/book/de/v1|https://git-scm.com/book/de/v1]]
  * [[https://progit.org/|https://progit.org/]]

===== 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:

{{:gitlab:1.png?600}}

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

{{:gitlab:2.png?600}}

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

{{:gitlab:3.png?600}}

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

{{:gitlab:4.png?600}}

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

{{:gitlab:5.png?600}}

Schreiben Sie in diese Datei den Inhalt ihrer Webseite:

{{:gitlab:6.png?600}}

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

{{:gitlab:7.png?600}}

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

<code>
image: alpine:latest

pages:
  stage: deploy
  script:
  - echo 'Nothing to do...'
  artifacts:
    paths:
    - public
</code>

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:

{{:gitlab:8_2.png?600}}

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

{{:gitlab:9.png?600}}