Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.


Vorhergehende Überarbeitung
—zugang:gitlab [2024/05/01 10:05] (aktuell) – Tröger, Peter, Prof. Dr.
Zeile 1: Zeile 1:
 +====== 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}}
 +
 +===== 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 [[https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html|Gitlab-Dokumentation]] beschrieben ist.